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 que figuran a continuación para instalar y configurar este check para un Agent que se ejecuta en un host. Para entornos contenedorizados, 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 comenzar a recopilar tus datos de rendimiento de boundary. Consulta el ejemplo de boundary.d/conf.yaml para conocer todas las opciones disponibles de configuración.

2. Reinicia el Agent.

Validación

Ejecuta el subcomando de estado del Agent 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
Returns CRITICAL if the Agent is unable to connect to the OpenMetrics endpoint, otherwise returns OK.
Statuses: ok, critical

boundary.controller.health
Returns CRITICAL if the Agent is unable to connect to the controller’s health endpoint, WARNING if the controller received a shutdown signal, otherwise returns OK.
Statuses: ok, warning, critical

Recopilación de logs

1. La recopilación de logs está desactivada en forma predeterminada 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 archivo de ejemplo boundary.d/conf.yaml para ver todas las opciones disponibles de configuración.

Solucionar problemas

¿Necesitas ayuda? Consulta el servicio de asistencia de Datadog.