Surveillance de la base de données Informix

Modifier en ligne

Vous pouvez surveiller de manière exhaustive la base de données IBM® Informix® à l'aide de Instana. Une fois l'agent hôte Instana installé, vous devez installer la base de données du SDK du capteur Instana OTel. Vous devez ensuite exécuter le SDK Instana OTel pour les bases de données sur l'hôte où votre base de données Informix est en cours d'exécution.

Vous pouvez consulter les indicateurs relatifs à la base de données « Informix » dans l'interface utilisateur d' Instana, une fois que vous avez configuré le capteur de la base de données « Informix » comme indiqué dans la section « Configuration de la base de données « Informix » ».

Informations de support

Modifier en ligne

Pour vous assurer que le capteur DB d' Informix est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :

Systèmes d'exploitation pris en charge

Modifier en ligne

Les systèmes d'exploitation pris en charge par le capteur de base de données « Informix » sont conformes aux exigences des agents hôtes, qui peuvent être consultées dans la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, comme par exemple les systèmes d'exploitation pris en charge pour « Unix ».

Versions prises en charge et politique d'assistance

Modifier en ligne

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

Technologie Politique de support Dernière version technologique Dernière version prise en charge
Informix B.D A la demande 15.0 14.0

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

Installation du SDK d' OTel pour la base de données d' Informix

Modifier en ligne
Remarque : ce SDK nécessite la version 11 d' Java.

Pour installer le SDK d' OTel pour la base de données d' Informix, procédez comme suit :

  1. Téléchargez le fichier .tar à partir de Editions.

  2. Extrayez le fichier .tar à l'aide de la commande suivante:
    tar vxf otel-dc-rdb-X.Y.Z.tar

    Vous pouvez maintenant voir que le dossier otel-dc-rdb-X.Y.Z est créé.

  3. Go vers otel-dc-rdb-X.Y.Z le répertoire :
    cd otel-dc-rdb-X.Y.Z
  4. Go dans le config répertoire :
    cd config

  5. Modifiez le fichier config-informix.yaml avec les détails de la base de données Informix . Pour plus d'informations, consultez le site GitHub.

    Le fichier de configuration par défaut est config/config.yaml. Vous pouvez également utiliser la variable d'environnement DC_CONFIG pour spécifier le fichier de configuration comme suit :
    export DC_CONFIG=config/config-informix.yaml
  6. Go Revenez au otel-dc-rdb-X.Y.Z répertoire, puis exécutez la commande suivante depuis le terminal pour lancer le fichier exécutable du SDK Otel d' Instana pour la base de données d' Informix :
    ./bin/otel-dc-rdb

Configuration de la base de données d' Informix

Modifier en ligne
Le détecteur de base de données Informix prend en charge la surveillance locale et distante. La surveillance locale a lieu lorsque le SDK Instana OTel pour les bases de données s'exécute sur le même hôte que la base de données Informix. La surveillance à distance intervient lorsque le SDK Instana OTel pour bases de données s'exécute sur un hôte différent de celui sur lequel la base de données Informix est en cours d'exécution. Pour tirer le meilleur parti du capteur de base de données Informix, utilisez la surveillance locale. Dans les deux cas, ajoutez la configuration suivante dans le fichier configuration.yaml de l'agent, puis démarrez l'agent.
# OpenTelemetry Collector
com.instana.plugin.opentelemetry:
  enabled: true
  grpc:
    enabled: true # takes precedence over legacy settings above, defaults to true if "grpc:" is present
  http:
    enabled: true # allows to enable http endpoints, defaults to true if "http:" is present

Surveillance locale

Modifier en ligne

Pour configurer la surveillance locale, procédez comme suit:

  1. Go dans le config dossier à l'aide de la commande suivante :
    cd config

  2. Modifiez le fichier config-informix.yaml avec les détails de la base de données Informix . Pour plus d'informations, consultez le site GitHub.

    Consultez l'exemple de fichier de configuration suivant:
    db.system: informix #Keep as it is
db.driver: com.informix.jdbc.IfxDriver #Keep as it is
instances:
  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    # vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    # vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://127.0.0.1:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sequential.scan.count: 0
      db.sql.trace.enabled: false #Default is false. Make it true only if `SqlTrace` is enabled for the DB.
    ### Uncomment the below section in case you are using Vault to retrieve the password.
    # vault:
    #  connection_url: #Vault Address URL
    #  token: #Vault Token
    #  #Use the pem file path in case you are using TLS/SSL connection for vault.
    #  #path_to_pem_file: auth/web-cert.pem
    #  kv_version: 2 #It is the vault version. Please crosscheck your configuration.
Remarque : lorsque vous devez fournir le mot de passe en clair, la valeur du champ « db.password » doit être codée en format « Base64 ». Les détails de configuration du coffre-fort « text.The » doivent être désactivés dans ce « case.The ». Le SDK prend également en charge l'authentification via un coffre-fort « mechanism.When ». Si le mot de passe doit être fourni via les configurations du coffre-fort, celles-ci doivent être ajoutées au champ « db.password ».

Nous fournissons les détails de configuration du coffre-fort suivants au db.password champ :

  1. vault_secret.path: Spécifiez le chemin du secret du coffre-fort dans ce champ.
  2. vault_secret.key: Spécifiez la clé d'authentification basée sur le coffre-fort dans ce champ.

De plus, la clé « vault » doit être activée dans la configuration lorsque vous utilisez le mécanisme d'authentification « Vault ». Les champs suivants doivent également être activés :

  1. connection_url : l' URL e de l'adresse Vault
  2. token : la valeur du jeton Vault
  3. path_to_pem_file : Chemin d'accès au fichier PEM si la connexion TLS / SSL est utilisée pour le coffre-fort.
  4. kv_version : la version de l' Vault

Pour en savoir plus sur la configuration d' Vault, consultez la documentation officielle d' Vault.

Surveillance à distance

Modifier en ligne

Pour exécuter le SDK dans un système différent de celui de l'agent, ajoutez la configuration suivante au fichier backend.cfg dans /instana-agent/etc/instana/com.instana.agent.main.config.Agent.cfg.

#If your DC is in a different host from your Instana Agent

http.listen=*

Dans le cadre de la surveillance à distance, le SDK Instana OTel s'exécute sur un hôte différent de celui de la base de données Informix.

L'exemple de fichier de configuration pour une base de données unique est le suivant:
db.system: informix #Keep as it is
db.driver: com.informix.jdbc.IfxDriver #Keep as it is
instances:
  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    #  vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    #  vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://<ip_of_host_having_instana_otel_sdk>:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sequential.scan.count: 0
      db.sql.trace.enabled: false #Default is false. Make it true only if `SqlTrace` is enabled for the DB.
     ### Uncomment the below section in case you are using Vault to retrieve the password.
     # vault:
        #  connection_url: #Vault Address URL
        #  token: #Vault Token
        #  #Use the pem file path in case you are using TLS/SSL connection for vault.
        #  #path_to_pem_file: auth/web-cert.pem
        #  kv_version: 2 #It is the vault version. Please crosscheck your configuration.
L'exemple de fichier de configuration pour plusieurs bases de données est le suivant:
db.system: informix #Keep as it is
db.driver: com.informix.jdbc.IfxDriver #Keep as it is
instances:
  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    #  vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    #  vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://127.0.0.1:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sequential.scan.count: 0

  - db.address: xxx.xxx.xxx.xxx #IP Address
    db.port: 9088 #Port on which DB is running
    db.serverName: ol_informix1410
    db.username: Informix_User_Name
    ### Either use password with Base 64 encoding or use vault configuration.
    db.password: BASE64_Encoded_Password
    #db.password:
    #  vault_secret.path: #path to the vault secret. Example: /kv/instana/informix
    #  vault_secret.key: #Provide the VaultSecretKey name
    db.name: InformixDB
    db.path: /opt/IBM/Informix_Software_Bundle

    #OTel properties:
    otel.service.name: InformixDB #Keep as it is

    #Data collector properties:
    #Either use `poll.interval` or `custom.poll.interval`
    #poll.interval: 30
    #All three category value is Mandatory if leveraging Custom Poll Rate
    custom.poll.interval:
      high: 300 #polling_value_in_sec
      medium: 45 #polling_value_in_sec
      low: 20 #polling_value_in_sec
    callback.interval: 20 #Keep as it is
    otel.backend.url: http://127.0.0.1:4317 #Point to the running agent

    #Custom Input
    custom.input: # Optional
      #Time Frame for which you want to get the expensive query. Default value 900 Sec
      db.sql.elapsed.timeframe: 900   # Values should be in Seconds
      db.sql.trace.enabled: false #Default is false. Make it true only if `SqlTrace` is enabled for the DB.
    ### Uncomment the below section in case you are using Vault to retrieve the password.
     # vault:
        #  connection_url: #Vault Address URL
        #  token: #Vault Token
        #  #Use the pem file path in case you are using TLS/SSL connection for vault.
        #  #path_to_pem_file: auth/web-cert.pem
        #  kv_version: 2 #It is the vault version. Please crosscheck your configuration.

Affichage des mesures

Modifier en ligne

Pour afficher les métriques, procédez comme suit:

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».

  2. Cliquez sur un hôte surveillé spécifique.

Vous pouvez voir un tableau de bord hôte avec toutes les métriques collectées et les processus surveillés.

Les métriques suivantes sont disponibles pour chaque détecteur de base de données Informix :

Métrique Description Assistance sur place ou à distance Catégorie d'intervalle de sondage
Nombre d'instances Nombre d'instances de la base de données Informix À distance (SQL) Court
Nombre de sessions actives Nombre d'instances de la base de données Informix actives À distance (SQL) Court
Nombre de sessions Nombre de sessions de base de données Informix Local (CMD) Court
Nombre de sessions actives Nombre de sessions de base de données Informix actives Local (CMD) Court
Nombre de transactions Nombre de transactions de base de données Informix Local (CMD) Moyen
Nombre de temps d'attente de transaction Temps d'attente de transaction Local (CMD) Moyen
Nombre d'instructions SQL Nombre de requêtes exécutées Local (CMD) Moyen
Instructions SQL par seconde Nombre de requêtes exécutées par seconde Local (CMD) Moyen
Nombre de lectures d'E-S Nombre de lectures d'E-S Local (CMD) Court
Écriture IO Compte Nombre d'écritures IO Local (CMD) Court
Temps écoulé pour les instructions SQL Requêtes les plus longues avec leur temps d'exécution À distance (SQL) Moyen
Ecritures sur le disque Nombre d'écritures sur le disque Local (CMD) Court
Lectures disque Nombre de lectures du disque Local (CMD) Court
Analyses Nombre d'analyses séquentielles pour chaque table À distance (SQL) Court
Analyses de table Nombre de sessions de la base de données Informix avec les analyses séquentielles À distance (SQL) Court
Dépassement de capacité-Verrouillage Nombre de fois où une unité d'exécution a tenté d'acquérir un verrou alors que des verrous n'étaient pas disponibles Local (CMD) Court
Dépassement-Utilisateur Nombre de fois où une unité d'exécution utilisateur a tenté d'acquérir un verrou alors que des verrous n'étaient pas disponibles Local (CMD) Court
Débordement - Transaction Nombre de fois où une unité d'exécution a tenté d'allouer une entrée dans la table de transactions alors que les entrées de la table de mémoire partagée n'étaient pas disponibles Local (CMD) Court
Utilisation de la mémoire Quantité de mémoire utilisée Local (CMD) Court
Taux d'utilisation du cache tampon (lecture) Pourcentage de lectures de pages satisfaites par une image de page mise en cache Local (CMD) Court
Taux d'utilisation du cache tampon (écriture) Pourcentage des écritures de page satisfaites par une image de page mise en cache Local (CMD) Court
Écritures LRU Nombre d'écritures les moins récemment utilisées (LRU) effectuées Local (CMD) Court
Attentes de verrouillage de la base de données Nombre de threads en attente d'un verrou Local (CMD) Court
Espace table Informations sur l'espace de stockage disponible et utilisé pour les 20 tables les plus importantes de la base de données À distance (SQL) Long
  • Assistance locale : les indicateurs sont récupérés directement depuis le système à l'aide de la onstat commande.
  • Assistance à distance : les indicateurs sont collectés via SQL queries, qui peut être exécuté soit localement, soit à distance. Ces indicateurs sont donc pris en charge aussi bien dans le cadre de la surveillance locale que de la surveillance à distance.
  • Catégories d'intervalle d'interrogation : chaque indicateur est affecté à une catégorie d'intervalle d'interrogation : court, moyen ou long. L'intervalle d'interrogation détermine la fréquence ou le délai utilisé pour l'extraction des métriques.
  • Les intervalles de sondage par défaut sont définis comme suit :
    • Court - 20 secondes
    • Moyen - 45 secondes
    • Long - 300 secondes.