TokuMX

Supported OS Linux Mac OS Windows

Intégration3.2.0

Présentation

Ce check recueille des métriques TokuMX comme :

  • Le nombre d’opérations effectuées
  • Le délai de réplication
  • L’utilisation et la taille d’une table de cache

Configuration

Installation

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

Configuration

Préparer TokuMX

  1. Installez le module Python pour MongoDB sur votre serveur MongoDB avec la commande suivante :

    sudo pip install --upgrade "pymongo<3.0"

  2. Vous pouvez vérifier que le module est installé avec cette commande :

    python -c "import pymongo" 2>&1 | grep ImportError && \
echo -e "\033[0;31mpymongo python module - Missing\033[0m" || \
echo -e "\033[0;32mpymongo python module - OK\033[0m"

  3. Lancez le shell Mongo, puis créez un utilisateur en lecture seule pour l’Agent Datadog dans la base de données admin :

    # Authenticate as the admin user.
use admin
db.auth("admin", "<YOUR_TOKUMX_ADMIN_PASSWORD>")
# Add a user for Datadog Agent
db.addUser("datadog", "<UNIQUEPASSWORD>", true)

  4. Vérifiez que vous avez créé l’utilisateur avec la commande suivante (en dehors du shell Mongo).

    python -c 'from pymongo import Connection; print Connection().admin.authenticate("datadog", "<UNIQUEPASSWORD>")' | \
grep True && \
echo -e "\033[0;32mdatadog user - OK\033[0m" || \
echo -e "\033[0;31mdatadog user - Missing\033[0m"

Pour en savoir plus sur la création et la gestion des utilisateurs dans MongoDB, consultez documentation MongoDB sur la sécurité (en anglais).

    Host

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

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

      init_config:

instances:
  - server: "mongodb://<USER>:<PASSWORD>@localhost:27017"

    2. Redémarrez l’Agent pour commencer à envoyer des métriques TokuMX à Datadog.

    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é.

    ParamètreValeur
    <NOM_INTÉGRATION>tokumx
    <CONFIG_INIT>vide ou {}
    <CONFIG_INSTANCE>{"server": "mongodb://<UTILISATEUR>:<MOTDEPASSE>@%%host%%:27017"}

    Validation

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

    Données collectées

    Métriques

    Événements

    Changements d’état de réplication :

    Ce check émet un événement à chaque fois que l’état de réplication d’un nœud TokuMX change.

    Checks de service

    tokumx.can_connect
    Renvoie CRITICAL si l’Agent n’est pas capable de se connecter à l’instance TokuMX qu’il surveille. Si ce n’est pas le cas, renvoie OK.
    Statuses: ok, critical

    Dépannage

    Besoin d’aide ? Contactez l’assistance Datadog.

    Pour aller plus loin

    PREVIEWING: may/embedded-workflows