Información general

Este check monitoriza VoltDB a través del Datadog Agent.

Configuración

Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecuta 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.

Nota: Este check sólo debe configurarse en un Agent por clúster. Si estás monitorizando un clúster repartido entre varios hosts, instala un Agent en cada host. Pero no habilites la integración VoltDB en más de un host, ya que se duplicarían las métricas.

Instalación

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

Configuración

1. Añade un usuario a datadog-agent. Puedes hacerlo editando tu archivo deployment.xml VoltDB. Nota: No se requieren roles específicos, así que asigna el rol user integrado.

   <users>
       <!-- ... -->
       <user name="datadog-agent" password="<PASSWORD>" roles="user" />
   </users>
   

2. Edita el archivo voltdb.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 VoltDB. Para conocer todas las opciones de configuración disponibles, consulta el voltdb.d/conf.yaml de ejemplo.

   init_config:
   
   instances:
     - url: http://localhost:8080
       username: datadog-agent
       password: "<PASSWORD>"
   

3. Reinicia el Agent.

Compatibilidad con TLS

Si TLS/SSL está activado en el puerto HTTP del cliente:

1. Exporta el archivo CA de tu certificado en formato PEM:

   keytool -exportcert -file /path/to/voltdb-ca.pem -keystore <KEYSTORE> -storepass <PASSWORD> -alias voltdb -rfc
   

2. Exporta tu certificado en formato PEM:

   openssl pkcs12 -nodes -in <KEYSTORE> -out /path/to/voltdb.pem -password pass:<PASSWORD>
   

   El archivo resultante debe contener la clave privada sin descifrar y el certificado:

   -----BEGIN PRIVATE KEY-----
   <Private key contents...>
   -----END PRIVATE KEY-----
   -----BEGIN CERTIFICATE-----
   <Certificate contents...>
   -----END CERTIFICATE-----
   

3. En tu instancia de configuración, apunta url al endpoint del cliente habilitado por TLS y configura las opciones tls_cert y tls_ca_cert. Por ejemplo:

   instances:
   - # ...
     url: https://localhost:8443
     tls_cert: /path/to/voltdb.pem
     tls_ca_cert: /path/to/voltdb-ca.pem
   

4. Reinicia el Agent.

Recopilación de logs

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 voltdb.d/conf.yaml para empezar a recopilar logs de VoltDB:

   logs:
     - type: file
       path: /var/log/voltdb.log
       source: voltdb
   

Cambia el valor path en función de tu entorno. Consulta el voltdb.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

3. Reinicia el Agent.

Para habilitar logs para entornos Kubernetes, consulta Recopilación de logs de Kubernetes.

Validación

Ejecuta el subcomando de estado del Agent y busca voltdb en la sección Checks.

Datos recopilados

Métricas

Eventos

Este check no incluye eventos.

Checks de servicio

voltdb.can_connect
Returns CRITICAL if the Agent is unable to reach the configured VoltDB client URL, OK otherwise.
Statuses: ok, critical

Solucionar problemas

¿Necesitas ayuda? Contacta con el equipo de asistencia de Datadog.

Referencias adicionales