CockroachDB

Supported OS Linux Windows Mac OS

Versión de la integración5.1.0

Información general

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
  1. 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
    
  2. Reinicia el Agent.

Recopilación de logs

Disponible para la versión 6.0 o posteriores del Agent

  1. La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Habilítala en tu archivo datadog.yaml:

    logs_enabled: true
    
  2. 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.

  3. 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ámetroValor
<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:

PREVIEWING: may/embedded-workflows