Información general

Este check monitoriza Boundary a través del Datadog Agent . La versión mínima compatible de Boundary es 0.8.0.

Configuración

Sigue las instrucciones siguientes para instalar y configurar este check para un Agent que se ejecute en un host. Para entornos en contenedores, consulta las Plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de estas instrucciones.

Instalación

El check de Boundary está incluido en el paquete del Datadog Agent. No es necesaria ninguna instalación adicional en tu servidor.

Configuración

Escucha

Debe configurarse un escucha con un objetivo ops en el archivo config.hcl para habilitar la recopilación de métricas. El siguiente es un ejemplo de estrofa de escucha:

controller {
  name = "boundary-controller"
  database {
    url = "postgresql://<username>:<password>@10.0.0.1:5432/<database_name>"
  }
}

listener "tcp" {
  purpose = "api"
  tls_disable = true
}

listener "tcp" {
  purpose = "ops"
  tls_disable = true
}

El bloque boundary.controller.health check de servicio se presenta como WARNING cuando el controlador se está apagando. Para habilitar este periodo de gracia de apagado, actualiza el bloque controller con una duración de espera definida:

controller {
  name = "boundary-controller"
  database {
    url = "env://BOUNDARY_PG_URL"
  }
  graceful_shutdown_wait_duration = "10s"
}

Datadog Agent

1. Edita el archivo boundary.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent para empezar a recopilar tus datos de rendimiento de Boundary. Consulta el ejemplo boundary.d/conf.yaml para conocer todas las opciones de configuración disponibles.

2. Reinicia el Agent.

Validación

[Ejecuta el subcomando de estado del Agent] (https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information) y busca boundary en la sección Checks.

Datos recopilados

Métricas

Eventos

La integración de Boundary no incluye ningún evento.

Checks de servicio

boundary.openmetrics.health

Devuelve CRITICAL si el Agent no puede conectarse al endpoint de OpenMetrics, en caso contrario devuelve OK.

Estados: ok, crítico

boundary.controller.health

Devuelve CRITICAL si el Agent no puede conectarse al endpoint de estado del controlador, WARNING si el controlador ha recibido una señal de apagado, de lo contrario devuelve OK.

Estados: ok, advertencia, crítico

Recopilación de logs

1. La recopilación de logs está desactivada por defecto en el Datadog Agent. Actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

2. Para empezar a recopilar tus logs de Boundary, añade este bloque de configuración a tu archivo boundary.d/conf.yaml:

   logs:
      - type: file
        source: boundary
        path: /var/log/boundary/events.ndjson
   

   Cambia el valor del parámetro path en función de tu entorno. Consulta el ejemplo de archivo boundary.d/conf.yamlpara conocer todas las opciones de configuración disponibles.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.