Versión de la integración5.1.0
El check de CockroachDB monitoriza el estado general y el rendimiento de un clúster de CockroachDB.
Configuración
Instalación
El check de CockroachDB está incluido en el paquete del Datadog Agent, por lo que no
necesitas instalar nada más en tu servidor.
A partir de la versión 1.9.0, esta integración basada en OpenMetrics cuenta con un modo más reciente (que se activa configurando openmetrics_endpoint
para que apunte al endpoint de destino) y un modo heredado (que se activa configurando prometheus_url
). Para obtener todas las funciones más actualizadas, Datadog recomienda activar el modo más reciente. Ten en cuenta que el último modo requiere Python 3. Para obtener más información, consulta Versiones más recientes y heredadas de integraciones basadas en OpenMetrics.
Para los hosts que no pueden usar Python 3, o que no pueden usar el modo heredado, consulta la siguiente configuración.
Configuración
Host
Para configurar este check para un Agent que se ejecuta en un host:
Recopilación de métricas
Edita el archivo cockroachdb.d/conf.yaml
, que se encuentra en la carpeta conf.d/
en la raíz del directorio de configuración de tu Agent, para empezar a recopilar los datos de rendimiento de tu CockroachDB. Para un clúster de varios nodos, configura una instancia de check independiente para cada nodo. Para conocer todas las opciones de configuración disponibles, consulta el cockroachdb.d/conf.yaml de ejemplo.
init_config:
instances:
## @param openmetrics_endpoint - string - required
## The URL exposing metrics in the OpenMetrics format.
#
- openmetrics_endpoint: http://localhost:8080/_status/vars
Reinicia el Agent.
Recopilación de logs
Disponible para la versión 6.0 o posteriores del Agent
La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Habilítala en tu archivo datadog.yaml
:
Añade este bloque de configuración a tu archivo cockroachdb.d/conf.yaml
para empezar a recopilar tus logs de CockroachDB:
logs:
- type: file
path: /var/lib/cockroach/logs/cockroach.log
source: cockroachdb
service: cockroachdb
log_processing_rules:
- type: multi_line
name: new_log_start_with_status_and_date
pattern: [A-Z]\d{6}\s\d+\:\d+\:\d+\.\d+
Cambia los valores de los parámetros path
y service
y configúralos para tu entorno. Consulta el cockroachdb.d/conf.yaml de ejemplo para ver todas las opciones de configuración disponibles.
Reinicia el Agent.
Contenedores
Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.
Parámetro | Valor |
---|
<INTEGRATION_NAME> | cockroachdb |
<INIT_CONFIG> | en blanco o {} |
<INSTANCE_CONFIG> | {"openmetrics_endpoint":"http://%%host%%:8080/_status/vars"} |
Recopilación de logs
La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta Recopilación de logs de Docker.
Luego, configura las integraciones de logs como etiquetas de Docker:
LABEL "com.datadoghq.ad.logs"='[{"source": "cockroachdb", "service": "<SERVICE_NAME>"}]'
Validación
Ejecuta el subcomando status
del Agent y busca cockroachdb
en la sección Checks.
Datos recopilados
Métricas
Checks de servicio
El check de CockroachDB no incluye checks de servicio.
Eventos
El check de CockroachDB no incluye eventos.
Solucionar problemas
¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.
Referencias adicionales
Más enlaces, artículos y documentación útiles: