Présentation

RethinkDB est une base de données NoSQL orientée documents distribuée, qui exploite tout le potentiel des flux de modifications en temps réel.

Ce check permet de surveiller un cluster RethinkDB avec l’Agent Datadog et de recueillir des métriques sur les performances, la disponibilité des données, la configuration du cluster, et plus encore.

Remarque : cette intégration est compatible avec RethinkDB version 2.3.6 et versions ultérieures.

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 à un environnement conteneurisé.

Installation

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

Configuration

1. Si vous utilisez RethinkDB 2.4+, ajoutez un utilisateur datadog-agent et accordez-lui un accès en lecture seule à la base de données rethinkdb. Vous pouvez utiliser les commandes ReQL suivantes. Consultez la page relative aux autorisations et aux comptes utilisateur de la documentation RethinkDB (en anglais) pour plus de détails :

   r.db('rethinkdb').table('users').insert({'id': 'datadog-agent', 'password': '<PASSWORD>'})
   r.db('rethinkdb').grant('datadog-agent', {'read': True})
   

   Remarque : si vous utilisez RethinkDB 2.3.x, il n’est pas possible d’accorder un accès à la base de données rethinkdb. Ignorez cette étape et utilisez plutôt votre compte administrateur ci-dessous.

2. Modifiez le fichier rethinkdb.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple rethinkdb.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

   init_config:
   
   instances:
     - host: localhost
       port: 28015
       user: "<USER>"
       password: "<PASSWORD>"
   

3. Redémarrez l’Agent.

Remarque : cette intégration recueille des métriques de tous les serveurs au sein du cluster ; vous n’avez donc besoin que d’un seul 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. Modifiez ce bloc de configuration dans votre fichier rethinkdb.d/conf.yaml pour commencer à recueillir vos logs RethinkDB :

   logs:
     - type: file
       path: "<LOG_FILE_PATH>"
       source: rethinkdb
       service: "<SERVICE_NAME>"
   

   Modifiez la valeur du paramètre path en fonction de votre environnement. Consultez le fichier d’exemple 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 avec Kubernetes.

Validation

Lancez la sous-commande status de l’Agent et recherchez rethinkdb dans la section Checks.

Données collectées

Métriques

Événements

RethinkDB n’inclut aucun événement.

Checks de service

rethinkdb.can_connect
Returns CRITICAL if the Agent is unable to reach the configured RethinkDB server, OK otherwise.
Statuses: ok, critical

rethinkdb.table_status.status.ready_for_outdated_reads
Returns OK if all shards of a table are ready to accept outdated read queries, WARNING otherwise.
Statuses: ok, warning

rethinkdb.table_status.status.ready_for_reads
Returns OK if all shards of a table are ready to accept read queries, WARNING otherwise.
Statuses: ok, warning

rethinkdb.table_status.status.ready_for_writes
Returns OK if all shards of a table are ready to accept write queries, WARNING otherwise.
Statuses: ok, warning

rethinkdb.table_status.status.all_replicas_ready
Returns OK if all replicas are ready for reads and writes, WARNING otherwise (e.g. if backfills are in progress).
Statuses: ok, warning

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.