Intégration avec IBM ITM V6 (version préliminaire publique)

Récapitulatif

L'intégration de IBM Tivoli Monitoring V6 avec Instana s'effectue à l'aide du capteur ITM pour l'agent hôte Instana. Les agents ITM V6 ou ITCAM V7 sont configurés pour fonctionner en mode double, ce qui leur permet de continuer à envoyer des données au serveur TEMS de IBM tout en transmettant également des données à l'agent hôte de Instana. Le capteur ITM de l'agent hôte Instana reçoit les données de métrique provenant des agents ITM et les transmet au backend Instana, où elles sont traitées : des entités sont créées sur le serveur Instana et les métriques sont enregistrées pour être affichées dans l'interface utilisateur Instana.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un agent hôte d' Instana s installé directement sur le système d'exploitation de l'hôte. L'agent doit être installé directement sur le système d'exploitation hôte, et non dans un conteneur ou dans un environnement d' Kubernetes/OpenShift. Pour plus d'informations, consultez la section « Installation de l'agent hôte ».
• Les agents ITM V6, ITCAM et V7 ont été mis à jour avec les correctifs TEMA (infrastructure de base) requis :
  • Pour vous connecter via HTTP : appliquez le 6.3.0.7-TIV-ITM_TEMA-IF0003 correctif ou une version ultérieure.
  • Pour vous connecter via HTTPS : appliquez le 6.3.0.7-TIV-ITM_TEMA-IF0008 correctif ou une version ultérieure.

Activation de l'assistance ITM

Pour activer la prise en charge de l' V6 ITM, vous devez suivre les étapes suivantes :

1. Activez le capteur ITM dans votre agent hôte d' Instana.
2. Téléchargez et configurez le pack de configuration de l'agent ITM.
3. Configurez vos agents ITM V6 pour qu'ils se connectent à l'agent hôte Instana.

Activation du capteur ITM

La collecte des métriques via le capteur ITM dans l'agent hôte est désactivée par défaut. Pour activer le capteur ITM, repérez la com.instana.plugin.itm section du fichier de configuration de l'agent et configurez le capteur.

Modifier <agent_install_dir>/etc/instana/configuration.yaml:

# ITM Sensor
com.instana.plugin.itm:
  enabled: true
#  availabilityZone: 'My ITM zone' # default is 'ITM Remote Monitoring'

Options de configuration :

• enabled: Réglez sur true pour activer le capteur ITM.
• availabilityZone: Nom personnalisé facultatif pour regrouper les entités ITM dans l' Instana. Si aucune valeur n'est spécifiée, la valeur par défaut est ITM Remote Monitoring.

Adapter les besoins en stockage

Pour ajuster les besoins en espace de stockage de l'agent hôte d' Instana lors de l'utilisation du capteur ITM, modifiez le fichier suivant : /opt/instana/agent/bin/setenv.

Modifiez ensuite les lignes suivantes en y insérant les valeurs mises à jour, comme indiqué dans l'exemple ci-dessous :

DEFAULT_AGENT_MAX_MEM='2048m'
DEFAULT_HEAP_MAX_MEM='320m'

Configuration de la communication avec TLS ou HTTPS

Par défaut, les agents ITM communiquent avec l'agent hôte d' Instana via le protocole HTTP sur le port 42699. Pour garantir la sécurité des communications, vous pouvez configurer des connexions TLS / HTTPS entre les agents ITM et l'agent hôte Instana.

Pour configurer HTTPS, il faut :

1. Configuration des certificats d' TLS s sur l'agent hôte Instana afin d'activer HTTPS sur le port 42699.
2. Création de fichiers de trousseau GSK (Global Security Kit) d' IBM s pour les agents ITM qui font confiance au certificat de l'agent hôte Instana.
3. Mise à jour du env.properties fichier pour utiliser protocol=https.

Pour obtenir des instructions sur la configuration de TLS / HTTPS, consultez la section « Configuration de TLS / HTTPS pour l'intégration ITM V6 ».

Configuration du pack de configuration

Pour configurer vos agents d' V6 ITM afin qu'ils se connectent à l'agent hôte Instana, vous devez télécharger et utiliser le pack de configuration des agents.

Téléchargement du pack de configuration

1. Téléchargez le pack de configuration de l'agent à partir de la dernière version disponible sur https://github.com/instana/ibm-monitoring-integration/releases.
2. Téléchargez le instana-v6-configpack.zip fichier instana-v6-configpack.tar ou.
3. Décompressez le fichier de configuration dans un répertoire temporaire sur le système où vous allez effectuer la configuration.

Configuration des agents ITM

Vous pouvez configurer les agents d' V6 ITM soit localement (sur le même système que celui où les agents sont installés), soit à distance (à l'aide de tacmd commandes).

Configuration locale

Pour configurer localement les agents d' V6 e afin qu'ils se connectent à l'agent hôte Instana, procédez comme suit sur le système où les agents d' V6 e sont installés :

1. Modifiez le env.properties fichier situé dans le pack de configuration extrait et remplacez INSTANA_AGENT_HOST par le nom d'hôte sur lequel s'exécute votre agent hôte Instana. Par exemple :

   hostname=instana.example.com

   Remarque : pour utiliser HTTPS à la place de HTTP, consultez la section « Configuration de TLS / HTTPS pour l'intégration ITM V6 » afin d'obtenir les instructions de configuration complètes.
2. Exécutez le agent2server_itm script avec les options -i, -c-e , et :

   AIX/Linux:

   ./agent2server_itm.sh -i <agent_install_dir> -c <connection_mode> -e env.properties

   Windows:

   agent2server_itm.bat -i <agent_install_dir> -c <connection_mode> -e env.properties

   Où :

   • <agent_install_dir> est le répertoire d'installation de l'agent. Par exemple, /opt/IBM/ITM.
   • <connection_mode> c'est soit :
     • dual - L'agent se connecte à la fois à TEMS et à l'agent hôte d' Instana.
     • instana - L'agent se connecte uniquement à l'agent hôte Instana.
   Remarque : sur les systèmes Linux ou AIX, le shell système par défaut associé à /bin/sh doit être sh, bash ou ksh.
   Remarque : tous les agents actuellement en cours d'exécution sont redémarrés par le script.

Configuration à distance

Pour configurer à distance les agents d' V6 e afin qu'ils se connectent à l'agent hôte Instana, procédez comme suit :

1. Modifiez le env.properties fichier situé dans le pack de configuration extrait et remplacez INSTANA_AGENT_HOST par le nom d'hôte sur lequel s'exécute votre agent hôte Instana. Par exemple :

   hostname=instana.example.com

   Remarque : pour utiliser HTTPS à la place de HTTP, consultez la section « Configuration de TLS / HTTPS pour l'intégration ITM V6 » afin d'obtenir les instructions de configuration complètes.
2. Créez un répertoire temporaire sur le système distant où l'agent d' V6 ation est installé :

   Linux exemple :

   tacmd executecommand -m kvm-011235:LZ -c "nohup /bin/sh -c 'mkdir /tmp/configpack > /tmp/output'"

   Windows exemple :

   tacmd executecommand -m Primary:IMG-WINDOWS2008:NT -c "md C:\IBM\ITM\configpack"

3. Transférez les fichiers du pack de configuration de l'agent vers le système distant :

   Linux exemple (fichiers extraits) :

   tacmd putfile -m kvm-011235:LZ -s /mnt/configpacks/instana-v6-configpack/agent2server_itm.sh -d /tmp/configpack/agent2server_itm.sh -t text
   tacmd putfile -m kvm-011235:LZ -s /mnt/configpacks/instana-v6-configpack/env.properties -d /tmp/configpack/env.properties -t text
   # Make the script executable
   tacmd executecommand -m kvm-011235:LZ -c "chmod +x /tmp/configpack/agent2server_itm.sh"

   Windows exemple (fichiers extraits) :

   tacmd putfile -m Primary:IMG-WINDOWS2008:NT -s C:\temp\instana-v6-configpack\agent2server_itm.bat -d C:\IBM\ITM\configpack\agent2server_itm.bat -t text
   tacmd putfile -m Primary:IMG-WINDOWS2008:NT -s C:\temp\instana-v6-configpack\env.properties -d C:\IBM\ITM\configpack\env.properties -t text

4. Exécutez le agent2server_itm script sur le système distant :

   Linux exemple (mode double) :

   tacmd executecommand -m kvm-011235:LZ -c "nohup /bin/sh -c 'sleep 10; /tmp/configpack/agent2server_itm.sh -i /opt/IBM/ITM -c dual -e /tmp/configpack/env.properties > /tmp/output' &" -w /tmp/configpack

   Windows exemple (mode double) :

   tacmd executecommand -m Primary:IMG-WINDOWS2016:NT -c "START /B C:\IBM\ITM\configpack\agent2server_itm.bat -i C:\IBM\ITM -e C:\IBM\ITM\configpack\env.properties -c dual" -w C:\IBM\ITM\configpack

   Remplacez -c dual par -c instana si vous souhaitez que les agents se connectent uniquement à l'agent hôte Instana.

   Remarque : la tacmd executecommand commande s'exécute immédiatement, mais le script continue de s'exécuter en arrière-plan sur le système distant. Pour vérifier les résultats, patientez quelques instants, puis consultez le fichier de sortie :

   • Linux: tacmd executecommand -m kvm-011235:LZ -c "cat /tmp/output"
   • Windows: tacmd executecommand -m Primary:IMG-WINDOWS2016:NT -c "type C:\IBM\ITM\configpack\output.log"
   Remarque : sur les systèmes AIX ou Linux, le shell sh, bash ou ksh est nécessaire pour exécuter le agent2server_itm script sur le système distant.

Configuration d'agents personnalisés ( Agent Builder ou Agent Factory)

Si vous disposez d'agents ITM personnalisés créés à l'aide d' Agent Builder ou d'Agent Factory, vous devez inclure le fichier JAR SDA (Self Describing Agent) pour permettre une intégration correcte avec Instana. Utilisez -j l'option pour indiquer l'emplacement du fichier JAR SDA.

Syntaxe :

-j "productcode=path_to_support_directory"

Où :

• productcode est le code produit ITM à deux caractères (par exemple, 01 pour un agent personnalisé).
• path_to_support_directory est le répertoire contenant le fichier JAR SDA.

Le répertoire « support » doit contenir un fichier JAR correspondant au modèle k{productcode}_sda_*.jar ou {productcode}_sda_*.jar. Pour plus d'informations sur la création d'agents personnalisés compatibles SDA, consultez la documentation ITM Agent Builder XML Configuration pour SDA.

Exemples de configuration locale :

AIX/Linux:

./agent2server_itm.sh -i /opt/IBM/ITM -c dual -j "01=/tmp/k01/support"

Windows:

agent2server_itm.bat -i C:\IBM\ITM -c dual -j "01=C:\Downloads\k01\support"

Plusieurs agents personnalisés :

Pour configurer plusieurs agents personnalisés, séparez les correspondances par des virgules :

-j "01=/path/to/k01/support,11=/path/to/k11/support"

Fonctionnalités du script :

Lorsque vous spécifiez -j l'option, le script :

• Vérifie que le fichier JAR SDA se trouve bien dans le répertoire de support indiqué.
• Copie le fichier JAR dans le répertoire de support de l'agent ITM approprié sur le système cible.
• Le modèle de nommage des fichiers JAR attendu est : k{productcode}_sda_*.jar ou {productcode}_sda_*.jar.

Par exemple, pour le code produit 01, le script recherche k01_sda_*.jar ou 01_sda_*.jar dans le répertoire indiqué.

Configuration à distance avec des agents personnalisés :

Lorsque vous utilisez la configuration à distance avec tacmd, vous pouvez inclure -j l'option dans la executecommand commande :

Linux exemple :

tacmd executecommand -m kvm-011235:LZ -c "nohup /bin/sh -c 'sleep 10; /tmp/configpack/agent2server_itm.sh -i /opt/IBM/ITM -c dual -e /tmp/configpack/env.properties -j "01=/tmp/k01/support" > /tmp/output' &" -w /tmp/configpack

Windows exemple :

tacmd executecommand -m Primary:IMG-WINDOWS2016:NT -c "START /B C:\IBM\ITM\configpack\agent2server_itm.bat -i C:\IBM\ITM -e C:\IBM\ITM\configpack\env.properties -c dual -j "01=C:\temp\k01\support"" -w C:\IBM\ITM\configpack

Résultat de la configuration

Une fois la configuration effectuée, les agents ITM V6 se connecteront selon le mode que vous avez spécifié :

• Mode double (-c dual): Les agents se connectent à la fois à TEMS et à l'agent hôte d' Instana. Les données de surveillance sont disponibles à la fois sur l'interface utilisateur du TEP et sur celle de l' Instana.
• Instana mode (-c instana): Les agents se connectent uniquement à l'agent hôte Instana. Les données de surveillance sont disponibles uniquement dans l'interface utilisateur d' Instana.

Se reconnecter uniquement à TEMS

Si vous devez uniquement reconnecter les agents à TEMS, exécutez la commande suivante :

AIX/Linux:

./agent2server_itm.sh -i <agent_install_dir> -c itm

Windows:

agent2server_itm.bat -i <agent_install_dir> -c itm

Où <agent_install_dir> se trouve le répertoire d'installation de l'agent.

Versions prises en charge de l'agent ITM

Le capteur ITM prend en charge les agents ITM V6 de version 6.3.0.7 ou ultérieure qui ont été mis à jour avec les correctifs TEMA (infrastructure de base) requis. Consultez la section « Conditions préalables » pour connaître les exigences spécifiques relatives aux correctifs.

Visualisation des données

La manière dont les données de surveillance sont visualisées dans Instana dépend du type d'agent ITM :

Types d'entités natifs d' Instana

Les types d'agents ITM suivants s'affichent via les tableaux de bord intégrés pour les types d'entités natifs d' Instana :

• Linux Agent OS, Windows Agent OS, Unix Agent OS ( AIX ) - Consultez le capteur « Host » pour les métriques collectées.
• IBM MQ agent - Consultez le capteur « IBM MQ » pour connaître les métriques collectées.

OpenTelemetry types d'entités

Tous les autres types d'agents ITM (tels que DataPower,, App Connect Enterprise (ACE), WebSphere Application Server ( WAS ) et les agents personnalisés créés à l'aide de Agent Builder /Agent Factory) sont représentés sous forme d'entités OpenTelemetry dans Instana.

Prise en charge de l'agent personnalisé SDA

Pour les agents personnalisés créés à l'aide d' Agent Builder /Agent Factory afin de fournir du contenu SDA (Self Describing Agent) à Instana, le fichier JAR SDA doit être inclus dans la version de l'agent. Pour plus de détails sur la configuration, consultez la documentation ITM Agent Builder XML Configuration pour SDA.

Collecte des métriques

Pour consulter les métriques collectées par les agents ITM d' V6, sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana, cliquez sur un hôte ou une entité surveillée spécifique, puis vous verrez s'afficher un tableau de bord contenant toutes les métriques collectées.

Comment les données sont-elles collectées?

1. Gestion des fichiers d'abonnement : le capteur ITM fournit des fichiers d'abonnement aux agents d' V6 ITM lorsque ceux-ci en font la demande. Ces fichiers définissent les indicateurs à collecter ainsi que les intervalles de collecte (valeurs SUBINTERVAL) pour chaque table.
2. Collecte des données par les agents ITM : les agents ITM V6 recueillent des métriques pour les tables en fonction des valeurs SUBINTERVAL définies dans leurs fichiers d'abonnement (généralement toutes les 1 à 5 minutes). Chaque table peut avoir un intervalle de collecte différent.
3. Transmission de données en mode connecté :
   • Mode double (-c dual): Une fois les données collectées, les agents ITM les transmettent à la fois à TEMS (pour l'affichage dans TEP) et à l'agent hôte d' Instana (pour l'affichage dans l'interface utilisateur d' Instana ).
   • Instana mode (-c instana): Une fois les données collectées, les agents ITM envoient les métriques uniquement à l'agent hôte d' Instana (pour l'affichage dans l'interface utilisateur d' Instana ).
4. Traitement des données du capteur ITM : le capteur ITM de l'agent hôte d' Instana traite les données dès leur réception depuis les agents ITM et les transmet au backend d' Instana.
5. Disponibilité des indicateurs : l'intégration recueille les indicateurs de performance clés auprès des agents ITM. Certains indicateurs spécialisés ou historiques disponibles dans TEP peuvent ne pas l'être dans l' Instana, car l'intégration se concentre sur les indicateurs de performance clés.

Traitement des incidents

Problèmes de connexion

Si les agents ITM ne se connectent pas à l'agent hôte Instana :

1. Vérifiez que le capteur ITM est activé dans la configuration de l'agent hôte d' Instana.
2. Vérifiez que le env.properties fichier contient le nom d'hôte correct pour l'agent hôte de l' Instana.
3. Assurez-vous que les agents ITM ont bien reçu les correctifs requis pour le framework TEMA.
4. Vérifiez la connexion réseau :
   • Vérifier la connexion : telnet <instana_host> 42699
   • Assurez-vous que le port 42699 est ouvert sur le système hôte de l'agent d' Instana.
   • Vérifiez que les règles du pare-feu autorisent le trafic provenant des systèmes des agents ITM.
5. Consulter les journaux :
   • Journaux de l'agent ITM : $CANDLEHOME/logs/<hostname>_<product_code>_*.log.
   • Instana journaux de l'agent hôte : /opt/instana/agent/data/log/agent.log.

Échec de la connexion à l'agent hôte Instana

Si les agents ITM ne parviennent pas à se connecter à l'agent hôte d' Instana, vous devrez peut-être configurer l'agent hôte pour qu'il écoute sur les interfaces réseau disponibles. Pour plus d'informations, consultez la section « Référence générale - Réseau ».

Les agents ITM envoient des données à l'agent hôte d' Instana s sur le port 42699 (comme défini dans le env.properties fichier). Assurez-vous que ce port est accessible depuis les systèmes sur lesquels vos agents ITM sont en cours d'exécution.

Métriques manquantes

Si les indicateurs n'apparaissent pas dans Instana :

1. Vérifiez que les agents ITM fonctionnent en mode double.
2. Vérifiez que l'agent hôte d' Instana s reçoit bien les données provenant du capteur ITM.
3. Consultez les journaux de l'agent hôte d' Instana s pour vérifier s'il y a des erreurs liées au capteur ITM.
4. Assurez-vous que les agents ITM sont configurés pour collecter les métriques attendues.