Surveillance d'IBM Db2

Le capteur prend en charge les versions IBM Db2, 10.5 et les versions ultérieures.

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Le capteur ne prend pas en charge la surveillance des instances d' Db2 s dotées d'un mécanisme DATA_ENCRYPT de sécurité par authentification.

Pour cette technologie, Instana prend en charge le traçage côté client pour les langages et environnements d'exécution suivants :

• Java
• Node.js
• PHP
• .NET Framework
• .Net Core

Pour utiliser un port personnalisé, une base de données, un utilisateur, un mot de passe, une instance ou une fréquence d'interrogation, vous devez configurer les zones suivantes dans le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yaml:

Pour que l'agent d' Instana s puisse se connecter en toute sécurité à votre serveur Db2, il doit être configuré ici <agent_install_dir>/etc/instana/configuration.yaml:

Instana prend en charge la surveillance locale de l' IBM Db2, disponible sur Red Hat OpenShift Container Platform. Les instances de base de données d' IBM Db2 s dans l'environnement de conteneurs sont créées sous le nom StatefulSets. Ils sont rendus à partir du même modèle de pod à l'aide de ressources personnalisées (CR). L'exemple suivant présente un modèle de configuration pour IBM Db2 :

com.instana.plugin.db2:
  local:
    - host: 'c-db2ucluster-sample-one-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases:
        - 'BLUDB'
    - host: 'c-db2ucluster-sample-two-db2u.openshift-operators.svc'
      instance: 'db2inst1'
      port: '50000'
      environment: 'OCP'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      availabilityZone: 'DB2 Monitoring'
      poll_rate: 5 # seconds
      databases: # multiple databases are supported
        - 'database1'
        - 'database2'
 

Si plusieurs instances d' IBM Db2 s existent sur le même nœud de travail, vous pouvez les ajouter dans le même fichier de configuration.

L' URL -hôte des services IBM Db2 est constituée du nom du service et de l'espace de noms du cluster OpenShift Container Platform dans lequel les instances de base de données sont créées. L' URL e se présente généralement sous le format *serviceName*.*namespace*.svc. Par exemple, si c-db2ucluster-sample-one est le nom du service et openshift-operators l'espace de noms, l' URL d'hôte est c-db2ucluster-sample-one-db2u.openshift-operators.svc.

Si vous recréez un pod, utilisez le même nom de service afin de conserver l'historique de la base de données dans Instana.

Le délai d'attente de connexion définit la durée maximale en secondes pendant laquelle le détecteur attend la connexion à la base de données. Vous pouvez définir un délai d'expiration de la session dans le capteur « Instana » ( Db2 ) en utilisant la loginTimeout propriété dans le configuration.yaml fichier. Si la connexion n'est pas obtenue dans l'intervalle loginTimeout spécifié, une erreur de connexion s'affiche. La valeur par défaut de cette propriété est de 5 secondes. Cette propriété est facultative et s'applique aux configurations locale et distante. L'exemple suivant montre comment personnaliser la propriétéloginTimeout :

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      loginTimeout: 20 #value in seconds
 

Vous pouvez personnaliser l'intervalle de temps permettant de compter les attentes de verrouillage et les requêtes de longue durée dans le capteur « Instana » ( Db2 ) en utilisant la lockAndLongQueryInterval propriété dans le configuration.yaml fichier. Par défaut, le temps mis par le détecteur pour classer une requête ou une attente de verrouillage en tant que durée d'exécution longue est de 100 secondes. Cette mesure peut être utilisée pour les configurations d'alerte ou d'événement. La propriété lockAndLongQueryInterval est facultative et s'applique aux configurations locales et distantes. L'exemple suivant montre comment personnaliser cette propriété:

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      lockAndLongQueryInterval: 60 # value in seconds
 

Vous pouvez désormais personnaliser l'intervalle de temps de collecte des statistiques d'exécution et des métriques de réorganisation. Pour personnaliser votre intervalle de temps, utilisez la propriété customRunStatsPollRate dans le fichier configuration.yaml . Par défaut, les métriques sont collectées toutes les 180 minutes. La propriété customRunStatsPollRate est facultative et s'applique aux configurations locales et distantes. L'exemple suivant montre comment personnaliser cette propriété:

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      customRunStatsPollRate: 30 # value in minutes
 

Vous pouvez désormais personnaliser le nombre de lignes affichées pour les tailles de table par schéma. Pour personnaliser le nombre de lignes, utilisez la propriété tableSizeRowsLimit dans le fichier configuration.yaml . Par défaut, seules les 50 premières tables par taille par schéma sont affichées. La propriété tableSizeRowsLimit est facultative et s'applique aux configurations locales et distantes. L'exemple suivant montre comment personnaliser cette propriété:

      port: '50000'
      tabschema: 'SYSTOOLS'
      user: 'db2inst1'
      password: 'db2inst1'
      poll_rate: 5 # seconds
      tableSizeRowsLimit: 100 # number of rows to fetch
 

JSON Les jetons Web (JWT) constituent un mécanisme d'authentification pris en charge par Db2; ils sont désormais pris en charge par les capteurs Db2 à partir de la version 1.0.27. Pour que l'agent Instana prenne en charge la connexion JWT à votre serveur Db2, vous devez configurer le <agent_install_dir>/etc/instana/configuration.yaml fichier comme suit :

La surveillance de plusieurs instances est prise en charge pour la surveillance locale et distante. Voici un exemple de la façon dont vous pouvez le configurer dans le fichier configuration.yaml :

Vous pouvez surveiller l'instance Db2 pureScale en local et à distance. Les exemples suivants montrent comment configurer la surveillance locale et distante pour une instance Db2 pureScale dans le fichier configuration.yaml :

Vous devez attribuer les autorisations suivantes au compte utilisateur « Db2 » utilisé par Instana :

GRANT DBADM ON DATABASE TO USER db2inst1;

ou

GRANT DATAACCESS ON DATABASE TO USER db2inst1;
GRANT SQLADM ON DATABASE TO USER db2inst1;
 

ou EXECUTE sur les fonctions / vues de table ou les procédures suivantes:

GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONTAINER TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TRANSACTION_LOG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_DATABASE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_TABLESPACE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_PKG_CACHE_STMT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_AGENT TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_HADR TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_CONNECTION TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UTILITY TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_WORKLOAD TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_UNIT_OF_WORK TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.MON_GET_INSTANCE TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_DIAG_HIST TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.PD_GET_LOG_MSGS TO USER db2inst1;
GRANT SELECT ON SYSIBMADM.MON_TRANSACTION_LOG_UTILIZATION TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.INDEXES TO USER db2inst1;
GRANT SELECT ON TABLE SYSCAT.TABLES TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CURRENT_SQL TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DB_HISTORY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.DBCFG TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_CONNECTION_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_DB_SUMMARY TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.MON_LOCKWAITS TO USER db2inst1;
GRANT SELECT ON TABLE SYSIBMADM.SNAP_REORG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DB_GET_CFG() TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.DBM_GET_CFG TO USER db2inst1;
GRANT EXECUTE ON FUNCTION SYSPROC.ENV_GET_INST_INFO TO USER db2inst1;

SYSIBMADM.SNAP_REORG

GRANT SELECT ON TABLE SYSIBMADM.SNAPTAB_REORG TO USER db2inst1;

Exemple :

db2 connect to db
 

db2 "grant dataaccess, sqladm on database to user db2inst1"
 

db2 "grant execute on FUNCTION SYSPROC.MON_GET_DATABASE to USER db2inst1"
 

Remarques :

• Une configuration d'interrogation pour un capteur LUW d' IBM Db2 t activée. Avec cette fonction, vous pouvez définir une configuration personnalisée pour l'extraction des statistiques à des intervalles requis et également désactiver les statistiques non pertinentes.
• Si vous utilisez la configuration d'interrogation personnalisée, ce paramètre est prioritaire sur les paramètres système par défaut.
• La personnalisation d'interrogation est activée uniquement pour les statistiques indiquées dans le tableau de la section Statistiques configurables . Les statistiques pour lesquelles la personnalisation d'interrogation n'est pas activée sont collectées moins fréquemment et sont vitales pour le système. Pour plus d'informations sur les statistiques collectées et l'intervalle d'interrogation par défaut, voir la section Statistiques configurables .
• Vous ne pouvez pas définir une configuration d'intervalle inférieure à la valeur par défaut. Si vous effectuez une configuration incorrecte, cette entrée est déplacée vers le compartiment de configuration de taux d'interrogation supérieur suivant qui est disponible.
• Si vous omettez des statistiques dans les éléments configurables (les statistiques ne sont ajoutées à aucun des compartiments poll_intervals ou disabled_metrics ), elles sont automatiquement ajoutées au compartiment supérieur disponible suivant. Toutefois, si aucun compartiment de ce type n'existe, il est déplacé vers la liste des métriques désactivées.
• Les intervalles d'interrogation peuvent être personnalisés pour la surveillance locale et distante. Définissez tous les intervalles d'interrogation en secondes.
• Les noms des statistiques et des compartiments (disabled_metrics, poll_rate_1, poll_rate_2, poll_rate_3et poll_rate_4) sont fixes. Vous devez les nommer comme indiqué dans le tableau de la section Statistiques de configuration ou comme dans l'exemple de configuration suivant.

Pour personnaliser l'interrogation pour la surveillance locale et distante, procédez à la configuration suivante:

      poll_rate: 5 # seconds
      custom_polling:
        disabled_metrics:
          metrics: DBM_CONFIG_STATS, AGENT_STATS #Stats that you don't want to be monitored
        poll_rate_1:
          poll_interval: 30
          metrics: TOP_QUERIES_STATS, TABLE_SPACE_STATS
        poll_rate_2:
          poll_interval: 200
          metrics: ELAPSED_TIME_STATS, WORKLOAD_STATS, TOP_TOTAL_STMT_IDS_STATS
        poll_rate_3:
          poll_interval: 900
          metrics: LOG_DISK_WAIT_STATS, DB_CONFIG_STATS, UNIT_OF_WORK_STATS
        poll_rate_4:
          poll_interval: 2000
          metrics: HADR_STATS, VMON_LOCK_STATS
      databases:
        - 'database1'
 

Vous pouvez collecter des métriques personnalisées, en plus des métriques standard, en utilisant les fonctions de table d' DB2. Indiquez les fonctions de table et les métriques que vous souhaitez collecter; le capteur génère alors automatiquement les requêtes SQL appropriées en fonction de votre configuration et exporte toutes les métriques au format « Prometheus ».

Vous pouvez définir la configuration des métriques personnalisées pour la surveillance locale et à distance d' IBM Db2 dans le fichier de <agent_install_dir>/etc/instana/configuration.yaml configuration de l'agent comme suit :

• ID du processus
• Port
• Version
• Heure de début / Temps d'activité