Présentation

Ce check permet de surveiller VoltDB avec l’Agent Datadog.

Configuration

Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à des environnements conteneurisés.

Remarque : ce check doit uniquement être configuré sur un Agent par cluster. Si vous surveillez un cluster réparti sur plusieurs hosts, installez un Agent sur chaque host. Toutefois, activez uniquement l’intégration VoltDB sur un seul host, sans quoi vos métriques seront dupliquées.

Installation

Le check VoltDB est inclus avec le package de l’Agent Datadog. Vous n’avez donc rien d’autre à installer sur votre serveur.

Configuration

1. Ajoutez un utilisateur datadog-agent. Pour ce faire, vous pouvez modifier votre fichier deployment.xml VoltDB. Remarque : aucun rôle spécifique n’est requis. Vous pouvez donc attribuer le rôle user intégré.

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

2. Modifiez le fichier voltdb.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance VoltDB. Consultez le fichier d’exemple voltdb.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

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

3. Redémarrez l’Agent.

Prise en charge de TLS

Si la technologie TLS/SSL est activée sur le port HTTP du client :

1. Exportez le fichier de l’autorité de certification de votre certificat au format PEM :

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

2. Exportez votre certificat au format PEM :

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

   Le fichier obtenu contient la clé privée non chiffrée et le certificat :

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

3. Dans la configuration de votre instance, pointez url vers l’endpoint client prenant en charge TLS et définissez les options tls_cert et tls_ca_cert. Exemple :

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

4. Redémarrez l’Agent.

Collecte de logs

1. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :

   logs_enabled: true
   

2. Ajoutez ce bloc de configuration à votre fichier voltdb.d/conf.yaml pour commencer à recueillir vos logs VoltDB :

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

Modifiez la valeur de path en fonction de votre environnement. Consultez le fichier d’exemple voltdb.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

3. Redémarrez l’Agent.

Pour activer les logs pour les environnements Kubernetes, consultez la section Collecte de logs Kubernetes.

Validation

Lancez la sous-commande status de l’Agent et cherchez voltdb dans la section Checks.

Données collectées

Métriques

Événements

Ce check n’inclut aucun événement.

Checks de service

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

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin