Traitement des incidents

Si vous souhaitez tester la connectivité du canal « IBM MQ », vous devez d'abord configurer l' IBM MQ Explorer. Vous pouvez ensuite tester la connectivité du canal dans l' IBM MQ Explorer à l'aide des identifiants fournis dans le configuration.yaml fichier.

Si la reconnaissance automatique échoue, un message d'avertissement peut s'afficher sur votre tableau de bord. L'explication et la solution de ces messages d'avertissement sont les suivantes:

• Auto-discovery: The OS Windows 10 is not supported for automatic discovery.

  Ce message s'affiche si le système d'exploitation Windows 10 est installé sur l'hôte. Windows s 10 n'est pas pris en charge pour la détection automatique. Pour résoudre ce problème, vous devez indiquer les informations relatives au nœud d'intégration dans le <agent_install_dir>/etc/instana/configuration.yaml fichier afin de poursuivre la surveillance via l' API REST.

• Auto-discovery: The OS Windows 10 or the ACE/IIB v10 is not supported for automatic discovery currently.

  Ce message s'affiche lorsque l'hôte exécute soit le système d'exploitation Windows 10, soit IBM Integration Bus (IIB) 10. Les deux ne sont pas pris en charge. Pour résoudre ce problème, suivez la même solution que celle décrite dans le message précédent.

• Auto-discovery: Unix Domain Socket is unable to access as the mqsi work path is null.

  Ce message s'affiche lorsque le capteur IBM ACE ne parvient pas à récupérer le chemin de travail WebSphere Message Broker ou lorsque le chemin WebSphere Message Broker est vide. Pour résoudre ce problème, suivez la même solution que celle décrite dans le premier message.

• Auto-discovery: MQTT is disabled. You can enable MQTT or specify MQ information in the configuration.yaml file.

  Ce message s'affiche lorsque le processus MQTT est désactivé ou arrêté de manière inattendue. Pour résoudre ce problème, activez MQTT et démarrez le processus. Si vous ne souhaitez pas l'activer, reportez-vous à la même solution que celle décrite dans le premier message.

Si vous ne parvenez pas à obtenir les métriques via l'interface utilisateur d' Instana, mais que vous recevez à la place le code d'erreur 2058 dans le journal de l'agent, assurez-vous que toutes les informations relatives à IBM MQ sont correctes dans le fichier de configuration. Exécutez la ps -ef | grep runmqlsr | grep '<QUEUEMGR NAME>' | grep '<LISTENER_PORT>' commande pour afficher les informations détaillées. Si le programme d'écoute possède une adresse IP spécifiée avec -i, vous devez supprimer la limitation ou configurer un nouveau programme d'écoute pour ACE.

Consultez l'exemple de sortie suivant avec un paramètre correct:

root@upstairs1:~# ps -ef | grep "runmqlsr" | grep QM1 | grep  1414
mqm       9956  9872  0 Aug30 ?        00:00:05 /opt/mqm/bin/runmqlsr -r -m QM1 -t TCP -p 1414

Consultez l'exemple de sortie suivant avec un paramètre incorrect:

root@upstairs1:~# ps -ef | grep "runmqlsr" | grep QM1 | grep  1417
mqm       9957 9872  0 Aug30 ?        00:00:06 /opt/mqm/bin/runmqlsr -r -m QM1 -t TCP -p 1417 -i 10.17.59.113

Si vous souhaitez connaître le port REST API utilisé par le nœud d'intégration actuel, exécutez la commande suivante :

• Si le protocole HTTP est utilisé, obtenez le port à l'aide de la commande suivante:

  mqsireportproperties integrationNode -b webadmin -o HTTPConnector -a | grep port
  

• Si le protocole HTTPS est utilisé, obtenez le port à l'aide de la commande suivante:

  mqsireportproperties integrationNode  -b webadmin -o HTTPSConnector -a | grep port
  

Si vous souhaitez obtenir la charge utile au format « JSON » afin de l'analyser plus en détail, vous pouvez utiliser les commandes suivantes :

• IIB 10 :

  curl -u <USERNAME> --header "Accept: application/json" "http://<ACE_HOST>:<INTEGTATION_NODE_API_PORT>/apiv1?depth=6" >> payload.json
  

• ACE 11

  curl -u <USERNAME> --header "Accept: application/json" "http://<ACE_HOST>:<INTEGTATION_NODE_API_PORT>/apiv2?depth=6" >> payload.json
  

Ce message s'affiche lorsque l'agent « Instana » ne parvient pas à s'associer correctement au DataFlowEngine processus, qui est un wrapper de l' JVM.

• Si vous utilisez IIB 10, vous pouvez supprimer cet avertissement en procédant comme suit:

  1. Ignorez ce processus dans le fichier <agent_install_dir>/etc/instana/configuration.yaml comme suit:

      com.instana.ignore:
        processes:
          - 'DataFlowEngine'
     

     Pour plus d'informations, consultez la section « Ignorer les processus ».

  2. Définissez le forceRemote champ sur true dans le <agent_install_dir>/etc/instana/configuration.yaml fichier correspondant au capteur « IBM ACE ».

• Si vous utilisez IBM ACE s 11 ou 12, vous pouvez choisir d'ignorer cette procédure en suivant les étapes précédentes ou de résoudre le problème en suivant les étapes suivantes :

  1. Configurez la variable JAVA_HOME d'environnement et associez-la au JRE fourni avec ACE en exécutant la commande suivante :

     export JAVA_HOME= <PATH to your ACE Bundled JRE>
     

     Voir l'exemple suivant :

     export JAVA_HOME=/opt/ace-11.0.0.11/common/jdk/jre
     

  2. Arrêtez et démarrez le courtier ACE (mqsistop/mqsistart).

Une modification de conception a été introduite pour les métriques de noeud de flux depuis la release-217. La page de tableau de bord des noeuds de flux est supprimée et toutes les métriques de noeud de flux sont affichées avec des tableaux extensibles. Pour les environnements auto-hébergés, vous devez choisir l'une des solutions suivantes pour afficher à nouveau les métriques de noeud de flux:

• Mettez à niveau la version auto-hébergée vers release-217. Grâce à cette solution, vous pouvez bénéficier de toutes les nouvelles fonctionnalités d' Instana.
• Si vous ne souhaitez pas mettre à niveau le système de back end pour qu'il utilise les fonctions de l'ancien agent, vous pouvez l'épingler à la version 1.1.620. Pour plus d'informations, consultez la section « Version pinning ».

Si les indicateurs de l'agent « Windows » n'apparaissent pas dans l'interface utilisateur d' Instana, mais qu'un message d'erreur s'affiche Create WMQ connection for ACE sensor failed à la place dans l'interface utilisateur de l'agent, assurez-vous que la fonctionnalité de sécurité « IBM MQ » est désactivée. Si le message d'erreur persiste après avoir désactivé la sécurité d' IBM MQ, vérifiez si l'utilisateur IBM MQ a bien été ajouté au groupe d'utilisateurs Windowsmqm.

Pour vérifier si la fonctionnalité « ACE Tracing » d' Instana est activée ou non, procédez comme suit :

1. Vérifiez le fichier stdout du serveur d'intégration, tel que /var/mqsi/components/BK1/servers/EG1/stdout. Si la fonctionnalité « ACE Tracing » d' Instana s a été activée avec succès, le message suivant s'affiche :

   Load Tracing Agent in shared mode, 0x7f322822bbbe, (nil)
   /var/mqsi/shared-classes/tracelibrary.so
   Found agent library!
   

2. Vérifiez si le répertoire /tmp/trace est généré ou non. Si l'option « ACE Tracing » d' Instana s est activée correctement, l'exit utilisateur crée le fichier journal, par exemple aceExit.13312.log dans le /tmp/trace répertoire. Ce numéro 13312 correspond à l'identifiant du processus d' DataFlowEngine ou d'Integration Server. Voir l'exemple suivant :

   [root@hastened1 trace]# ps -ef | grep 13312
   root     13312 13260 13 18:37 ?        00:00:29 DataFlowEngine v12_BK1 00000000-0000-0000-0000-000000000000 BK1-EG1
   

3. Si l'activation du traçage ACE d' Instana échoue, récupérez le journal système /var/log/message, les fichiers stderr et stdout du nœud d'intégration, ainsi que les fichiers stderr et stdout du serveur d'intégration. Envoyez tous les fichiers à l'équipe d'assistance d' Instana.

Si vous ne voyez pas les appels de traçage ACE dans l'interface utilisateur d' Instana, ou si l'appel de traçage ne s'affiche pas comme prévu, procédez comme suit :

1. Activer le débogage pour le traçage ACE d' Instana.

   • Dans l'environnement ACE classique, définissez la variable d'environnement LOG_LEVEL="debug" en ligne de commande, par exemple export LOG_LEVEL=debug .

     Ensuite, dans la même ligne de commande, exécutez les mqsistop commandes mqsistart et pour redémarrer l'instance d' IBM ACE.

   • Pour le conteneur ACE dans l' IBM Cloud Pak for Integration, configurez les variables d'environnement LOG_LEVEL comme debug pour l'instance d' IBM ACE.

     • Pour plus d'informations sur ACE ( 11.x ), consultez la section « Gestion des variables d'environnement du serveur d'intégration » sur Red Hat OpenShift.
     • Pour plus d'informations sur l' 12.x d'ACE, consultez la page de référence d'Integration Server sur App Connect - Valeurs de ressources personnalisées - spec.env.

2. Redémarrez le serveur d'intégration et collectez tous les fichiers dans le répertoire /tmp/trace et les fichiers, tels que MqsiTransportUserExitBase.debug.*.log, dans le répertoire /tmp/ .

3. Récupérez les captures d'écran de l'appel de traçage dans l'interface utilisateur d' Instana.

4. Envoyez les fichiers de débogage et les captures d'écran à l'équipe d'assistance d' Instana.