IBM Db2

Supported OS Linux Mac OS Windows

Intégration1.11.2

Dashboard par défaut

Présentation

Ce check surveille IBM Db2 avec l’Agent Datadog.

Implémentation

Installation

Le check IBM Db2 est inclus avec le package de l’Agent Datadog.

Dépendances

La bibliothèque client ibm_db est requise. Pour l’installer, veillez à avoir un compilateur opérationnel et exécutez :

Unix
sudo -Hu dd-agent /opt/datadog-agent/embedded/bin/pip install ibm_db==3.0.1
Windows

Pour les versions <= 6.11 de l’Agent :

"C:\Program Files\Datadog\Datadog Agent\embedded\python.exe" -m pip install ibm_db==3.0.1

Pour les versions >= 6.12 et < 7.0 de l’Agent :

"C:\Program Files\Datadog\Datadog Agent\embedded<VERSION_MAJEURE_PYTHON>\python.exe" -m pip install ibm_db==3.0.1

Pour le versions >= 7.0 de l’Agent :

"C:\Program Files\Datadog\Datadog Agent\embedded3\python.exe" -m pip install ibm_db==3.1.0

Des fonctionnalités XML peuvent être requises sur Linux. Si vous rencontrez des erreurs durant le processus de création, installez libxslt-dev (ou libxslt-devel pour RPM).

Activer la surveillance

Pour surveiller la santé d’une instance, de ses bases de données et de ses objets de base de données, activez les switches de surveillance du système de base de données pour chacun des objets à surveiller :

  • Statement
  • Lock
  • Tables
  • Buffer pool

Basculez sur l’utilisateur principal de l’instance et exécutez ces commandes dans l’invite db2 :

update dbm cfg using HEALTH_MON on
update dbm cfg using DFT_MON_STMT on
update dbm cfg using DFT_MON_LOCK on
update dbm cfg using DFT_MON_TABLE on
update dbm cfg using DFT_MON_BUFPOOL on

Exécutez ensuite get dbm cfg pour obtenir un résultat similaire à ce qui suit :

 Default database monitor switches
   Buffer pool                         (DFT_MON_BUFPOOL) = ON
   Lock                                   (DFT_MON_LOCK) = ON
   Sort                                   (DFT_MON_SORT) = OFF
   Statement                              (DFT_MON_STMT) = ON
   Table                                 (DFT_MON_TABLE) = ON
   Timestamp                         (DFT_MON_TIMESTAMP) = ON
   Unit of work                            (DFT_MON_UOW) = OFF
 Monitor health of instance and databases   (HEALTH_MON) = ON

Configuration

    Host

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

    Collecte de métriques

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

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

      logs:
  - type: file
    path: /home/db2inst1/sqllib/db2dump/db2diag.log
    source: ibm_db2
    service: db2sysc
    log_processing_rules:
      - type: multi_line
        name: new_log_start_with_date
        pattern: \d{4}\-(0?[1-9]|[12][0-9]|3[01])\-(0?[1-9]|1[012])

    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>ibm_db2
    <CONFIG_INIT>vide ou {}
    <CONFIG_INSTANCE>{"db": "<NOM_BASEDEDONNÉES>", "username":"<NOMUTILISATEUR>", "password":"<MOTDEPASSE>", "host":"%%host%%", "port":"%%port%%"}
    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”: “ibm_db2”, “service”: “<NOM_SERVICE>”, “log_processing_rules”: {“type”:“multi_line”,“name”:“new_log_start_with_date”, “pattern”:"\d{4}-(0?[1-9]

    Validation

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

    Données collectées

    Métriques

    Événements

    • ibm_db2.tablespace_state_change se déclenche à chaque changement d’état d’un tablespace.

    Checks de service

    Dépannage

    Besoin d’aide ? Contactez l’assistance Datadog.

    Pour aller plus loin

    Documentation, liens et articles supplémentaires utiles :

    PREVIEWING: may/embedded-workflows