Systemanforderungen für die Java-Überwachung

Instana unterstützt die folgenden JVM-Distributionen:

• Amazon Corretto
• Azul Zulu
• J9IBM (Weitere Informationen finden Sie unter IBMJ9 und OpenJ9 Überlegungen und IBMJ9 und OpenJ9 Einschränkungen )
• OpenJ9Eclipse (Weitere Informationen finden Sie unter IBMJ9 und OpenJ9 Überlegungen )
• OpenJDK
• AdoptOpenJDK
• Oracle HotSpot
• SAP JVM
• Sun HotSpot
• BEA JRockit
• Hitachi JVM

Wenn Sie Java Runtimes 8 oder frühere Versionen verwenden, stellen Sie sicher, dass Sie die folgenden Aktionen durchfü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 ist unter $JAVA_HOME/lib/tools.jar zu finden.

• Wenn Sie Java 8 verwenden, aktualisieren Sie auf Java 8 1.8.0_181 oder höhere Versionen. Die Java 8-Builds bis zu 1.8.0_40 haben viele bekannte Probleme, die mit der Implementierung der Lambda-Funktion zusammenhängen. Für Java 8 unterstützt der Instana-Agent also nicht 1.8.0_40 oder frühere Versionen. Daher müssen Sie auf neuere Versionen aktualisieren, da einige Abstürze in diesen Versionen behoben sind.

Java 9 führt modularisierte Builds auf der Grundlage des Jigsaw-Frameworks ein. Wenn Sie Java Runtimes 9 oder eine spätere Version verwenden, führen Sie die folgenden Aktionen durch:

• Wenn Sie ein benutzerdefiniertes Laufzeit-Image verwenden, wie z. B. die mit jmod oder jlink erstellt wurde, stellen Sie sicher, dass Sie die folgenden Module in die instrumentierte JVM aufnehmen:

  • java.instrument
  • jdk.attach

  Um zu prüfen, ob Ihr Java 9 oder höher die erforderlichen Module java.instrument und jdk.attach enthält, führen Sie den folgenden Befehl aus:

  java --list-modules
   

  Wenn Sie den Befehl auf einer JVM 8 oder früher ausführen, wird die Fehlermeldung Unrecognized option: --list-modules angezeigt.

• Wenn Apache Tomcat unter Windows als Dienst ausgeführt wird, laufen die überwachten Prozesse nicht als Datei C:\java12\bin\java.exe , sondern als DateiC:\Program Files\Apache Software Foundation\Tomcat 8.5\bin\Tomcat8.exe .

  Instana unterstützt diese Einrichtung. Bevor Sie jedoch den Dienst starten, muss sich das Verzeichnis bin auf der JVM, auf der der Dienst läuft, auf PATH befinden. Um den Pfad festzulegen, führen Sie den folgenden Befehl aus:

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

  Der Pfad muss angegeben werden, da die Serverdatei jvm.dll die Datei C:\java12\bin\instrument.dll laden muss. Wenn die Datei nicht im Pfad angegeben ist, kann der Server sie nicht finden, und es wird folgende Fehlermeldung 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, können die folgenden Warnmeldungen auftreten:

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 die Argumente der virtuellen Maschine ein, bevor Sie Ihre Anwendung starten:

-XX:+EnableDynamicAgentLoading
 

Der Instana-Host-Agent erstellt temporäre JAR-Dateien im Verzeichnis $TMP/.instana . Diese JAR-Dateien sind für die JVM-Überwachung erforderlich. Für eine erfolgreiche JVM-Überwachung muss sichergestellt werden, dass der Root-Benutzer, unter dem der Agent läuft, und der Benutzer, unter dem die JVM läuft, über die erforderlichen Lese- und Schreibrechte für das Verzeichnis $TMP verfügen. Bereinigen Sie auch nicht die Instana-Dateien in den Verzeichnissen $TMP und $TMP/.instana .

Wenn Sie Protokolle wie Suppressed spans due to high number of short oder Discarded span due to queue overflow im Agentenprotokoll sehen, bedeutet dies, dass der Java Tracer eine hohe Belastung bei der Span-Verarbeitung erfahren hat. Infolgedessen lässt der Java Tracer ein paar Spans aus, um Leistungsprobleme in der Anwendung zu vermeiden.

Um die Belastung zu verringern, führt der Java Tracer folgende Schritte durch:

1. Es unterdrückt die Ausgänge, die eine kurze Dauer haben.
2. Wenn die Belastung noch hoch ist, werden die Spannen in Stapeln zusammengefasst.
3. Wenn die Dosierung nicht erfolgreich ist, werden ein paar Abschnitte gestrichen.