Fehlerbehebung

Wenn Sie die Verbindung zum Kanal „ IBM MQ “ testen möchten, müssen Sie zunächst den „ IBM MQ Explorer“ einrichten. Anschließend können Sie die Kanalverbindung im „ IBM MQ Explorer“ mit den Anmeldedaten testen, die in der configuration.yaml Datei angegeben sind.

Wenn die automatische Erkennung fehlschlägt, erhalten Sie möglicherweise eine Warnung in Ihrem Dashboard. Die Erläuterung und Lösung für diese Warnungen lautet wie folgt:

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

  Diese Meldung wird angezeigt, wenn auf dem Host das Betriebssystem „ Windows s 10“ ausgeführt wird. Das Betriebssystem „ Windows s 10“ wird für die automatische Erkennung nicht unterstützt. Um dieses Problem zu beheben, müssen Sie die Informationen zum Integrationsknoten in der <agent_install_dir>/etc/instana/configuration.yaml Datei angeben, um die Überwachung mit dem REST- API fortzusetzen.

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

  Diese Meldung wird angezeigt, wenn auf dem Host entweder das Betriebssystem „ Windows s 10“ oder „ IBM s Integration Bus (IIB) 10“ ausgeführt wird. Beide werden nicht unterstützt. Um dieses Problem zu beheben, befolgen Sie dieselbe Lösung wie in der vorherigen Nachricht beschrieben.

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

  Diese Meldung wird angezeigt, wenn der Sensor „ IBM ACE “ den Arbeitspfad „ WebSphere Message Broker “ nicht abrufen kann oder wenn der Pfad „ WebSphere Message Broker “ leer ist. Um dieses Problem zu beheben, befolgen Sie dieselbe Lösung wie in der ersten Nachricht beschrieben.

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

  Diese Nachricht wird angezeigt, sobald der MQTT-Prozess unerwartet inaktiviert oder gestoppt wurde. Aktivieren Sie zum Beheben dieses Problems MQTT und starten Sie den Prozess. Wenn Sie es nicht aktivieren möchten, verwenden Sie dieselbe Lösung wie in der ersten Nachricht beschrieben.

Wenn Sie über die Benutzeroberfläche von „ Instana “ keine Metriken abrufen können, sondern stattdessen den Fehlercode 2058 im Agent-Protokoll erhalten, stellen Sie sicher, dass alle Informationen zu „ IBM MQ “ in der Konfigurationsdatei korrekt sind. Führen Sie den ps -ef | grep runmqlsr | grep '<QUEUEMGR NAME>' | grep '<LISTENER_PORT>' Befehl aus, um die detaillierten Informationen anzuzeigen. Wenn der Listener eine angegebene IP mit -ihat, müssen Sie die Einschränkung entfernen oder einen neuen Listener für ACE einrichten.

Sehen Sie sich die folgende Beispielausgabe mit der richtigen Einstellung an:

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

Sehen Sie sich die folgende Beispielausgabe mit einer falschen Einstellung an:

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

Wenn Sie den Port „ REST API “ abrufen möchten, den der aktuelle Integrationsknoten verwendet, führen Sie den folgenden Befehl aus:

• Wenn das Protokoll HTTP verwendet wird, rufen Sie den Port mit folgendem Befehl ab:

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

• Wenn das HTTPS -Protokoll verwendet wird, rufen Sie den Port mit folgendem Befehl ab:

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

Wenn Sie die Nutzdaten im Format „ JSON “ zur weiteren Untersuchung abrufen möchten, können Sie die folgenden Befehle verwenden:

• 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
  

Diese Meldung wird angezeigt, wenn der Agent „ Instana “ den DataFlowEngine Prozess, bei dem es sich um einen Wrapper für „ JVM “ handelt, nicht korrekt anbringen kann.

• Wenn Sie IIB 10 verwenden, können Sie diese Warnung wie folgt entfernen:

  1. Ignorieren Sie diesen Prozess in der Datei <agent_install_dir>/etc/instana/configuration.yaml wie folgt:

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

     Weitere Informationen finden Sie unter „Prozesse ignorieren “.

  2. Setzen Sie das forceRemote Feld in der <agent_install_dir>/etc/instana/configuration.yaml Datei für den Sensor „ IBM ACEtrue “ auf.

• Wenn Sie „ IBM ACE “ 11 oder 12 verwenden, können Sie diesen Vorgang entweder mit den oben genannten Schritten ignorieren oder die Warnung beheben, indem Sie die folgenden Schritte ausführen:

  1. Richten Sie die JAVA_HOME Umgebungsvariable ein und verweisen Sie sie auf die im ACE-Paket enthaltene JRE, indem Sie den folgenden Befehl ausführen:

     export JAVA_HOME= <PATH to your ACE Bundled JRE>
     

     Sehen Sie sich das folgende Beispiel an:

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

  2. Stoppen und starten Sie den ACE-Broker (mqsistop/mqsistart).

Seit release-217wurde eine Designänderung für Flussknotenmetriken eingeführt. Die Dashboardseite 'Flussknoten' wird entfernt und alle Metriken für Flussknoten werden mit erweiterbaren Tabellen angezeigt. Für selbst gehostete Umgebungen müssen Sie eine der folgenden Lösungen auswählen, um die Metriken des Ablaufknotens erneut anzuzeigen:

• Führen Sie ein Upgrade der selbst gehosteten Version auf release-217durch. Mit dieser Lösung stehen Ihnen alle neuen Funktionen von Instana zur Verfügung.
• Wenn Sie für das Back-End kein Upgrade durchführen möchten, damit die Funktionen des alten Agenten verwendet werden können, können Sie den Agenten auf Version 1.1.620fixieren. Weitere Informationen finden Sie unter „Versionsbindung “.

Wenn die Metriken des „ Windows “-Agenten in der Benutzeroberfläche von „ Instana “ nicht angezeigt werden, sondern stattdessen eine Fehlermeldung Create WMQ connection for ACE sensor failed in der Benutzeroberfläche des Agenten erscheint, stellen Sie sicher, dass die Sicherheitsfunktion „ IBM MQ “ deaktiviert ist. Wenn die Fehlermeldung weiterhin angezeigt wird, nachdem die Sicherheit unter „ IBM MQ “ deaktiviert wurde, überprüfen Sie, ob der Benutzer „ IBM MQ “ der Benutzergruppe „ Windowsmqm“ hinzugefügt wurde.

Um zu überprüfen, ob die ACE-Verfolgung in „ Instana “ aktiviert ist, führen Sie die folgenden Schritte aus:

1. Überprüfen Sie die Datei stdout des Integrationsservers, z. B. /var/mqsi/components/BK1/servers/EG1/stdout. Wenn die ACE-Verfolgung von „ Instana “ erfolgreich aktiviert wurde, wird folgende Meldung angezeigt:

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

2. Überprüfen Sie, ob das Verzeichnis /tmp/trace generiert wurde. Wenn die ACE-Protokollierung von „ Instana “ erfolgreich aktiviert wurde, erstellt der User-Exit die Protokolldatei, beispielsweise aceExit.13312.log im /tmp/trace Verzeichnis. Die Nummer 13312 ist die Prozess-ID des „ DataFlowEngine “ oder des „Integration Server“. Sehen Sie sich das folgende Beispiel an:

   [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. Falls die ACE-Protokollierung unter Instana nicht aktiviert werden kann, erfassen Sie das Systemprotokoll /var/log/messagesowie die stderr Dateien und stdout des Integrationsknotens und die Dateien stderr und stdout des Integrationsservers. Senden Sie alle Dateien an das Support-Team von Instana.

Wenn Sie die ACE-Tracing-Aufrufe in der Benutzeroberfläche von „ Instana “ nicht sehen können oder der Tracing-Aufruf nicht wie erwartet angezeigt wird, führen Sie die folgenden Schritte aus:

1. Aktivieren Sie das Debugging für die ACE-Protokollierung unter Instana.

   • Für die herkömmliche ACE-Umgebung legen Sie die Umgebungsvariable LOG_LEVEL="debug" in der Befehlszeile fest, z. B. export LOG_LEVEL=debug .

     Führen Sie anschließend in derselben Befehlszeile die Befehle mqsistopmqsistart und aus, um die Instanz von „ IBM ACE “ neu zu starten.

   • Legen Sie für den Container „ACE“ in „ IBM Cloud Pak for Integration “ die Umgebungsvariablen LOG_LEVEL so fest, wie es debug für die Instanz „ IBM ACE “ vorgesehen ist.

     • Informationen zu ACE- 11.x en finden Sie unter „Verwalten von Umgebungsvariablen des Integrationsservers“ unter Red Hat OpenShift.
     • Informationen zu ACE ( 12.x ) finden Sie unter „ App Connect Integration Server-Referenz – Benutzerdefinierte Ressourcenwerte“ – spec.env.

2. Starten Sie den Integrationsserver erneut und erfassen Sie alle Dateien im Verzeichnis /tmp/trace und Dateien (z. B. MqsiTransportUserExitBase.debug.*.log) im Verzeichnis /tmp/ .

3. Sammeln Sie die Screenshots des Tracing-Aufrufs in der Benutzeroberfläche von „ Instana “.

4. Senden Sie die Debug-Dateien und Screenshots an das Support-Team von Instana.