CouchDB

Supported OS Linux Mac OS Windows

Intégration5.1.0

Dashboard CouchDB

Présentation

Enregistrez des données CouchDB dans Datadog pour :

  • Visualiser les métriques clés de CouchDB
  • Corréler les performances de CouchDB avec le reste de vos applications

Pour des raisons de performances, la version CouchDB que vous utilisez est mise en cache. Vous ne pouvez donc pas surveiller plusieurs versions d’instances CouchDB avec la même instance d’Agent.

Configuration

Installation

Le check CouchDB est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos serveurs CouchDB.

Configuration

Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

Collecte de métriques
  1. Modifiez le fichier couch.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 CouchDB. Consultez le fichier d’exemple couch.d/conf.yaml pour découvrir toutes les options de configuration disponibles :

    init_config:
    
    instances:
      ## @param server - string - required
      ## The Couch server's url.
      #
      - server: http://localhost:5984
    

    Remarque : indiquez des paramètres db_include et db_exclude pour spécifier les bases de données pour lesquelles l’Agent doit recueillir ou non des métriques.

  2. Redémarrez l’Agent.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

  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 couch.d/conf.yaml pour commencer à recueillir vos logs CouchDB :

    logs:
      - type: file
        path: /var/log/couchdb/couch.log
        source: couchdb
        service: couch
    

    Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement. Consultez le fichier d’exemple couch.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

  3. Redémarrez l’Agent.

Environnement conteneurisé

Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.

Collecte de métriques
ParamètreValeur
<NOM_INTÉGRATION>couch
<CONFIG_INIT>vide ou {}
<CONFIG_INSTANCE>{"server": "http://%%host%%:5984"}
Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs Kubernetes.

ParamètreValeur
<CONFIG_LOG>{"source": "couchdb", "service": "<NOM_SERVICE>"}

Validation

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

Données collectées

Métriques

Événements

Le check CouchDB n’inclut aucun événement.

Checks de service

couchdb.can_connect
Renvoie le statut après avoir ping votre instance CouchDB. Des informations supplémentaires sur le statut de la réponse au moment de la collecte sont incluses dans le message du check.
Statuses: ok, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin

PREVIEWING: may/embedded-workflows