Systemanforderungen für die Überwachung von „ Java “

Instana unterstützt die folgenden „ JVM “-Distributionen:

• Amazon Corretto
• Azul Zulu
• IBM J9 (Weitere Informationen finden Sie unter IBM, J9 und OpenJ9 (Hinweise) sowie unter IBM, J9 und OpenJ9 (Einschränkungen))
• Eclipse OpenJ9 (Weitere Informationen finden Sie unter IBM, J9 und OpenJ9 )
• OpenJDK
• AdoptOpenJDK
• Oracle HotSpot
• SAP JVM
• Sun HotSpot
• BEA JRockit
• Hitachi JVM

Wenn Sie die „ Java “-Laufzeitumgebung 8 oder frühere Versionen verwenden, stellen Sie bitte sicher, dass Sie die folgenden Schritte ausführen:

• Stellen Sie unter Amazon Corretto, Azul Zulu, OpenJDK, Oracle HotSpot oder SAP JVM die Datei tools.jar in der Laufzeit jeder überwachten JVM zur Verfügung. Die Datei befindet sich im Verzeichnis $JAVA_HOME/lib/tools.jar.

• Wenn Sie „ Java “ 8 verwenden, führen Sie ein Upgrade auf „ Java “ 8 1.8.0_181 oder eine neuere Version durch. Die Builds von „ Java “ 8 bis hin zu „ 1.8.0_40 “ weisen zahlreiche bekannte Probleme auf, die mit der Implementierung der Lambda-Funktion zusammenhängen. Der „ Instana “-Agent unterstützt also für „ Java 8“ weder „ 1.8.0_40 “ noch frühere Versionen. Daher müssen Sie ein Upgrade auf spätere Versionen durchführen, da einige Abstürze in ihnen behoben sind.

Java Version 9 führt modulare Builds auf Basis des Jigsaw-Frameworks ein. Wenn Sie „ Java “ Runtimes 9 oder eine neuere Version verwenden, führen Sie die folgenden Schritte aus:

• Wenn Sie ein benutzerdefiniertes Laufzeit-Image verwenden, wie beispielsweise solche, die mit jmod jlink oder erstellt wurden, stellen Sie sicher, dass Sie die folgenden Module in das instrumentierte JVM aufnehmen:

  • java.instrument
  • jdk.attach

  Um zu überprüfen, ob Ihre „ Java “ 9-Laufzeitumgebung oder eine neuere Version die erforderlichen java.instrumentjdk.attach Module enthält, führen Sie den folgenden Befehl aus:

  java --list-modules
   

  Wenn Sie den Befehl auf einer JVM 8 oder älter ausführen, Unrecognized option: --list-modules Es wird eine Fehlermeldung angezeigt.

• Wenn „ Apache Tomcat “ auf Windows als Dienst ausgeführt wird, laufen die überwachten Prozesse nicht als Benutzer C:\java12\bin\java.exe „file“, sondern als BenutzerC:\Program Files\Apache Software Foundation\Tomcat 8.5\bin\Tomcat8.exe „file“.

  Instana unterstützt diese Konfiguration. Bevor Sie den Dienst jedoch starten, muss sich das bin Verzeichnis auf dem JVM, auf dem der Dienst ausgeführt wird, im Verzeichnis PATH. befinden. Um den Pfad festzulegen, führen Sie den folgenden Befehl aus:

  set PATH=%PATH%;C:\java12\bin
   

  Der Pfad muss festgelegt werden, da die Serverdatei jvm.dll die Datei C:\java12\bin\instrument.dll laden muss. Ist die Datei nicht im Pfad angegeben, kann der Server sie nicht finden, und der folgende Fehler wird angezeigt:

  com.sun.tools.attach.AgentLoadException: Failed to load agent library: instrument was not loaded.Can't find dependent libraries
   

Wenn Sie „ Java “ Runtime 21 verwenden, werden möglicherweise die folgenden Warnmeldungen angezeigt:

WARNING: A Java agent has been loaded dynamically (/tmp/.instana/javaagent-loader-1.3.56.jar)
WARNING: If a serviceability tool is in use, please run with -XX:+EnableDynamicAgentLoading to hide this warning
WARNING: If a serviceability tool is not in use, please run with -Djdk.instrument.traceUsage for more information
WARNING: Dynamic loading of agents will be disallowed by default in a future release
 

Um dieses Problem zu vermeiden, fügen Sie den folgenden Befehl in VM-Argumenten hinzu, bevor Sie Ihre Anwendung starten:

-XX:+EnableDynamicAgentLoading
 

Der Host-Agent von „ Instana “ erstellt temporäre JAR-Dateien im Verzeichnis $TMP/.instana . Diese JAR-Dateien werden für die Überwachung von „ JVM “ benötigt. Um eine erfolgreiche Überwachung von „ JVM “ zu gewährleisten, stellen Sie sicher, dass der Root-Benutzer, unter dem der Agent ausgeführt wird, und der Benutzer, unter dem der „ JVM “ ausgeführt wird, über die erforderlichen Lese- und Schreibrechte für das $TMP Verzeichnis verfügen. Entfernen Sie außerdem nicht die Dateien „ Instana “ aus den $TMP Verzeichnissen $TMP/.instana und.

Wenn Sie im Agent-Protokoll Einträge wie Suppressed spans due to high number of short oder sehen Discarded span due to queue overflow, bedeutet dies, dass der „ Java “-Tracer bei der Span-Verarbeitung stark ausgelastet war. Infolgedessen reduziert der „ Java -Tracer“ die Anzahl der Spannen, um Leistungsprobleme in der Anwendung zu vermeiden.

Um die Auslastung zu verringern, führt der „ Java “ Tracer die folgenden Schritte aus:

1. Er unterdrückt die Exitbereiche, die eine kurze Dauer haben.
2. Wenn die Arbeitslast weiterhin hoch ist, erstreckt sie sich in Stapeln.
3. Wenn die Stapelverarbeitung nicht erfolgreich ist, werden einige Bereiche gelöscht.