Surveillance d'IBM DataPower

Modifier en ligne

Une fois l'agent hôte d' Instana s installé, le capteur « IBM DataPower » est automatiquement installé, mais vous devez configurer ce capteur IBM DataPower comme indiqué dans cette rubrique. Vous pouvez ensuite consulter les indicateurs liés à IBM DataPower dans l'interface utilisateur d' Instana.

La fonctionnalité de traçage d' Instana DataPower permet de surveiller la capacité de API Management et d'examiner le processus de démarrage des API dans DataPower API Gateway. Pour utiliser le traçage « Instana » ( DataPower ), vous devez d'abord installer et activer la fonctionnalité de traçage « IBM DataPower ». Pour plus d'informations, consultez la page « IBM DataPower Tracing ».

Informations de support

Modifier en ligne

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

Systèmes d'exploitation pris en charge

Modifier en ligne

Consultez la section « Systèmes d'exploitation pris en charge » pour le capteur d' IBM DataPower.

Versions prises en charge et politique d'assistance

Modifier en ligne

Le capteur prend en charge les versions IBM DataPower, 2018.4, 10.0.1.x, 10.0.x et les versions ultérieures.

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
IBM DataPower	45 jours	11.0.0	10.6.0

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

Informations complémentaires sur l'assistance

Modifier en ligne

IBM DataPower Le capteur prend en charge à la fois la surveillance locale et la surveillance à distance.

Prérequis

Modifier en ligne

Pour que l'agent Instana puisse surveiller le dispositif IBM DataPower, la surveillance des ressources doit être activée, telle que l'interface de gestion REST et les statistiques.

Activation de l'interface de gestion REST. Pour plus d'informations, consultez la section « Activation de l'interface de gestion REST ».
Activation des statistiques Pour plus d'informations, consultez la section « Activation des statistiques ».

Configuration

Modifier en ligne

Instana permet de surveiller à la fois les appareils d' IBM DataPower s distants et locaux. Pour collecter des données, vous devez configurer les zones suivantes dans le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.ibmdatapower:
  enabled: true
  poll_rate: 60 # Default is 60 seconds
  instances: # Multiple DataPower instances can be specified
    DATAPOWER_INSTANCE_HOST_1: # Remote DataPower Host or IP address
      port: '<INSERT_PORT_HERE>' # DataPower instance REST management interface port
      username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower
      cluster: '<INSERT_CLUSTER_HERE>' # The cluster to group multiple DataPower instances (optional)
    DATAPOWER_INSTANCE_HOST_2: # Remote DataPower Host or IP address
      port: '<INSERT_PORT_HERE>' # DataPower instance REST management interface port
      username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower
      cluster: '<INSERT_CLUSTER_HERE>' # The cluster to group multiple DataPower instances (optional)
    local: # Local monitoring configuration
      port: '<INSERT_PORT_HERE>' # Local DataPower REST management interface port
      username: '<INSERT_USERNAME_HERE>' # User account to connect to DataPower
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to DataPower

Remarques :

Cette poll_rate variable indique la fréquence à laquelle des données sont récupérées sur IBM DataPower. Sa valeur est exprimée en secondes. La valeur par défaut de poll_rate est de 60 secondes. Si plusieurs appliances DataPower sont configurées, augmentez la valeur de poll_rate afin de réduire l'utilisation du processeur par le capteur « DataPower » à chaque intervalle de récupération des données.
Si cluster est configuré, l'instance DataPower distante est affichée en tant que zone distincte dans la zone de disponibilité spécifiée.

Configuration de la fréquence d'interrogation

Modifier en ligne

Remarque : les capteurs Instana, IBM DataPower, 1.0.20 et les versions ultérieures permettent de configurer la fréquence d'interrogation afin de réduire le volume de données collectées. Cette fonctionnalité est prise en charge sur le backend Instana auto-hébergé à partir de la version 311.

Vous pouvez configurer la fréquence à laquelle l' Instana interroge IBM DataPower pour collecter des données et des métriques en utilisant le poll_rate paramètre dans le fichier de configuration.yaml l'agent, comme le montre l'exemple suivant :

com.instana.plugin.ibmdatapower:
  poll_rate: 60 # Default is 60 seconds

Tableau de compatibilité pour la surveillance d' IBM DataPower

Modifier en ligne

Le tableau suivant présente la matrice de prise en charge pour la surveillance d' IBM DataPower :


Matrice de prise en charge	Instana agent dans une machine virtuelle	Instana agent dans un cluster d' Kubernetes	Instana agent dans un conteneur « Docker »
DataPower dans une machine virtuelle	Pris en charge	Non pris en charge	Pris en charge
DataPower dans un cluster Kubernetes	Pris en charge	Pris en charge	Pris en charge
DataPower dans un conteneur Docker	Pris en charge	Non pris en charge	Pris en charge

Surveillance de l' IBM DataPower s dans une machine virtuelle

Modifier en ligne

Surveillance locale

Modifier en ligne

La surveillance locale a lieu lorsque l'agent Instana et IBM DataPower s'exécutent tous deux dans la même machine virtuelle. Dans un tel scénario, vous n'avez pas besoin de configurer l'hôte ou l'adresse IP DataPower , mais seulement de l'indiquer en tant que local dans le fichier de configuration de l'agent. Le capteur « IBM DataPower » détecte alors automatiquement l'adresse IP de l'appareil « DataPower ». Voir l'exemple de configuration suivant :

com.instana.plugin.ibmdatapower:
  enabled: true
  poll_rate: 60
  instances:
    local:
      port: '5554'       # DataPower instance REST management interface port (required)
      username: 'admin'  # User account to connect to DataPower (required)
      password: 'admin'  # User password to connect to DataPower (required)

Surveillance à distance

Modifier en ligne

La surveillance à distance s'effectue lorsque l'agent Instana et IBM DataPower s'exécutent dans des machines virtuelles distinctes. Dans un tel scénario, vous devez configurer l'hôte ou l'adresse IP DataPower . Voir l'exemple de configuration suivant :

com.instana.plugin.ibmdatapower:
  enabled: true
  poll_rate: 60
  instances:                   # Multiple DataPower instances can be specified
    10.0.0.1:                  # Remote DataPower Host or IP address
      port: '5554'             # DataPower instance REST management interface port (required)
      username: 'dpUser'       # User account to connect to DataPower (required)
      password: 'dpPassword'   # User password to connect to DataPower (required)
      cluster: 'clusterName'   # The cluster to group multiple DataPower instances (optional)
    datapower-inst.ibm.com:    # Remote DataPower Host or IP address
      port: '443'              # DataPower instance REST management interface port (required)
      username: 'dpUser'       # User account to connect to DataPower (required)
      password: 'dpPassword'   # User password to connect to DataPower (required)
      cluster: 'clusterName'   # The cluster to group multiple DataPower instances (optional)

Surveillance de l' IBM DataPower dans un cluster d' Kubernetes

Modifier en ligne

Surveillance locale

Modifier en ligne

La surveillance locale a lieu lorsque l'agent Instana et IBM DataPower s'exécutent tous deux dans la même machine virtuelle. Dans un tel scénario, vous n'avez pas besoin de configurer l'hôte ou l'adresse IP DataPower , mais seulement de l'indiquer en tant que local dans le fichier de configuration de l'agent. La configuration est identique à celle décrite dans la section Surveillance locale .

Remarque : le capteur « IBM DataPower » détecte automatiquement l'adresse IP de l'appareil « DataPower ». Par conséquent, le détecteur ne peut pas différencier chaque dispositif DataPower . Par conséquent, tous les dispositifs DataPower qui s'exécutent dans le cluster Kubernetes doivent avoir le même port, le même nom d'utilisateur et le même mot de passe.

Surveillance à distance

Modifier en ligne

La surveillance à distance s'effectue lorsque l' IBM DataPower e s'exécute dans un cluster d' Kubernetes, tandis que l'agent Instana s'exécute dans une autre machine virtuelle. La configuration est identique à celle décrite dans la section Surveillance à distance .

Suivi de l' IBM DataPower dans Docker

Modifier en ligne

Surveillance locale

Modifier en ligne

La surveillance locale a lieu lorsque l'agent Instana et IBM DataPower s'exécutent dans des conteneurs Docker distincts au sein de la même machine virtuelle. Dans un tel scénario, vous n'avez pas besoin de configurer l'hôte ou l'adresse IP DataPower , mais seulement de l'indiquer en tant que local dans le fichier de configuration de l'agent. La configuration est identique à celle décrite dans la section Surveillance locale .

Surveillance à distance

Modifier en ligne

La surveillance à distance s'effectue lorsque l' IBM DataPower e s'exécute dans un conteneur d' Docker, tandis que l'agent Instana s'exécute dans une autre machine virtuelle. La configuration est identique à celle décrite dans la section Surveillance à distance .

Surveillance de l'appareil physique d' IBM DataPower

Modifier en ligne

Surveillance à distance

Modifier en ligne

Vous pouvez surveiller à distance une appliance physique Datapower d' IBM en configurant l'agent avec les informations d'identification requises. La configuration est identique à celle décrite dans la section Surveillance à distance .

Instana surveille les appliances physiques Datapower 10.5.x et versions ultérieures.

Affichage des mesures

Modifier en ligne

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

Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
Cliquez sur un hôte surveillé spécifique.

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

Métriques de performance

Modifier en ligne

Dispositifs

Modifier en ligne


Métrique	Description
Charge du système	Pourcentage de la charge totale sur le dispositif pendant l'intervalle de mesure.
Utilisation de l'UC	Utilisation moyenne de l'UC du dispositif DataPower surveillé au cours des 10 dernières secondes.
Utilisation de la mémoire	Utilisation instantanée de la mémoire en pourcentage de la mémoire totale.
Utilisation du système de fichiers chiffré	Utilisation de l'espace de stockage chiffré sur l'appareil.
Connexion acceptée	Nombre de connexions TCP acceptées.
Liste de travaux	Nombre de travaux en attente, y compris la communication interne, dans la file d'attente, devant être traités par l'appliance.
Domaines mis au repos	Indique l'état de repos du domaine.
Objets inactifs	Nombre d'objets inactifs déployés sur le dispositif.
Récapitulatif TCP établi	Le nombre de connexions TCP dans l'état Établi.
Syn du récapitulatif TCP envoyé	Nombre de connexions TCP dans l'état syn-sent.
Syn du récapitulatif TCP reçu	Nombre de connexions TCP dans l'état syn-received.
Récapitulatif TCP Fin Wait1	Nombre de connexions TCP dans l'état fin-wait-1.
Récapitulatif TCP Fin Wait2	Nombre de connexions TCP dans l'état fin-wait-2.
Récapitulatif TCP fermé	Nombre de connexions TCP dans l'état fermé.
Attente de la fermeture du récapitulatif TCP	Nombre de connexions TCP dans l'état close-wait.
Délai d'attente du récapitulatif TCP	Nombre de connexions TCP dans l'état close-wait.
Accepter le dernier récapitulatif TCP	Nombre de connexions TCP dans l'état last-ack.
Écoute du récapitulatif TCP	Nombre de connexions TCP dans l'état Écoute.
Fermeture du récapitulatif TCP	Nombre de connexions TCP dans l'état Fermeture.

Domaines

Modifier en ligne


Métrique	Description
Utilisation actuelle de la mémoire	Utilisation instantanée de la mémoire en tant que pourcentage de la mémoire totale dans ce domaine.

Noms XML

Modifier en ligne


Métrique	Description
Utilisé	Le nombre de noms de domaine de type « XML » actuellement utilisés dans ce domaine.
Pourcentage disponible	Pourcentage de noms de domaine disponibles actuellement dans ce domaine. XML

Statut d'appairage

Modifier en ligne


Métrique	Description
Mises à jour en attente	Nombre de commandes en attente sur ce membre. Pour plus d'informations, consultez la commande `show gateway-peering-status`.
Décalage de réplication	Décalage de réplication d'un membre. Le décalage de réplication d'un membre correspond au décalage du membre principal lorsqu'il partage la réplication de données.

Interfaces Ethernet

Modifier en ligne


Métrique	Description
Octets RX	Nombre d'octets du trafic reçu.
Abandons RX	Nombre de paquets reçus qui ont été abandonnés.
Octets TX	Nombre d'octets du trafic reçu.
Abandons TX	Nombre de paquets abandonnés pendant la transmission.
Reçus par seconde	Nombre de paquets reçus sur l'interface réseau par seconde.
Transmissions par seconde	Nombre de paquets reçus sur l'interface transmise par seconde.

MQ gestionnaire de file d'attente (obsolète)

Modifier en ligne


Métrique	Description
Connexions actives back-end	Nombre de connexions actives pour le côté dorsal.
Connexions actives front-end	Nombre de connexions actives pour le côté front-end.
Statut	État opérationnel de l'objet gestionnaire de file d'attente de l' MQ.

IBM MQ Gestionnaire de file d'attente V9+

Modifier en ligne


Métrique	Description
Conversations actives en arrière-plan	Nombre de sessions actives entre le gestionnaire de file d'attente d' MQ s et les systèmes backend.
Conversations actives en interface utilisateur	Nombre de sessions actives entre le gestionnaire de file d'attente d' MQ s et les clients.
Statut	État opérationnel de l'objet gestionnaire de files d'attente MQ V9+.

services

Modifier en ligne


Métrique	Description
Utilisation actuelle de la mémoire	Utilisation actuelle de la mémoire par le service au cours des 5 dernières minutes.
Durée moyenne des transactions	Durée moyenne des transactions au cours des 10 dernières minutes.
Débit	Débit de transaction sur les 10 dernières minutes.

Source de données SQL

Modifier en ligne


Métrique	Description
Connexions actives	Nom de la source de données SQL.

Signatures d'intégrité

Modifier en ligne

Pour chaque capteur, il existe une base de connaissances des signatures d'intégrité qui sont évaluées en permanence par rapport aux métriques entrantes et qui sont utilisées pour traiter les problèmes ou les incidents en fonction de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des problèmes ou des incidents en fonction de signatures d'anomalie détectées sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'une métrique spécifique à une entité donnée.

Pour plus d'informations sur les événements intégrés pour le détecteur Datapower, voir Référence des événements intégrés.

Traitement des incidents

Modifier en ligne

Instance DataPower non affichée dans l'interface utilisateur

Modifier en ligne

Dans la liste des problèmes de surveillance, recherchez les événements connexes DataPower et vérifiez la solution en fonction du type de problème.

Variable non dÚfinie

Modifier en ligne

Type de problème de surveillance : ibmdatapower_var_not_defined

Il manque un ou plusieurs éléments requis dans la configuration. Assurez-vous que le port, le nom d'utilisateur et le mot de passe de votre instance d' DataPower sont correctement configurés dans le fichier « configuration.yaml ».

La variable a une valeur non valide

Modifier en ligne

Type de problème de surveillance : ibmdatapower_var_invalid_value

Un ou plusieurs éléments requis ont une valeur non valide dans la configuration. Assurez-vous que le port, le nom d'utilisateur et le mot de passe de votre instance d' DataPower sont correctement configurés dans le fichier configuration.yaml.

Erreur de connexion

Modifier en ligne

Type de problème de surveillance : ibmdatapower_connection_error

Le détecteur DataPower n'a pas pu se connecter à l'instance DataPower après de nombreuses tentatives. Assurez-vous que le port, le nom d'utilisateur et le mot de passe de votre instance d' DataPower sont correctement configurés dans le fichier configuration.yaml.

Autre exception

Modifier en ligne

Type de problème de surveillance : ibmdatapower_exception_error

Le capteur DataPower a rencontré une exception peu commune qui n'est pas encore documentée. Cela pourrait indiquer un problème au niveau de l'agent « Instana » ou du service « DataPower ».