Erste Schritte (Ergänzung)

Artikel
04/25/2024

In den folgenden Abschnitten erfahren Sie, wie Sie die automatische Java-Instrumentierung für bestimmte technische Umgebungen abrufen.

Azure App Service

Weitere Informationen finden Sie unter Anwendungsüberwachung für Azure App Service und Java.

Azure-Funktionen

Weitere Informationen finden Sie unter Überwachen von Azure Functions mit Azure Monitor Application Insights.

Azure Spring Apps

Weitere Informationen finden Sie unter Application Insights: Verwenden des Java-In-Process-Agents in Azure Spring Apps.

Container

Hinweis

Verwenden Sie mit Spring Boot Native Image-Anwendungen das Projekt Azure Monitor OpenTelemetry-Distribution / Application Insights in Java-Anwendung mit nativem Spring Boot-Image anstelle des Application Insights Java-Agents.

Docker-Einstiegspunkt

Wenn Sie die exec-Form verwenden, fügen Sie den Parameter -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" der Parameterliste an einer Position vor dem Parameter "-jar" hinzu. Beispiel:

ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.5.2.jar", "-jar", "<myapp.jar>"]

Wenn Sie die shell-Form verwenden, fügen Sie das Java-VM (JVM)-Argument -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" an einer Position vor -jar ein. Beispiel:

ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" -jar <myapp.jar>

Docker-Datei

Ein Docker-Dateibeispiel:

FROM ...

COPY target/*.jar app.jar

COPY agent/applicationinsights-agent-3.5.2.jar applicationinsights-agent-3.5.2.jar 

COPY agent/applicationinsights.json applicationinsights.json

ENV APPLICATIONINSIGHTS_CONNECTION_STRING="CONNECTION-STRING"
        
ENTRYPOINT["java", "-javaagent:applicationinsights-agent-3.5.2.jar", "-jar", "app.jar"]

In diesem Beispiel kopieren Sie die Dateien applicationinsights-agent-3.5.2.jar und applicationinsights.json aus einem agent-Ordner (Sie können einen beliebigen Ordner auf Ihrem Computer auswählen). Diese beiden Dateien müssen sich im selben Ordner im Docker-Container befinden.

Partnercontainerimages

Wenn Sie ein Partnercontainerimage verwenden, das Sie nicht ändern können, fügen Sie die Application Insights Java-Agent-JAR-Datei von außen in den Container ein. Legen Sie die Umgebungsvariable für den Container JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar fest.

Spring Boot

Weitere Informationen finden Sie unter Verwenden von Azure Monitor Application Insights mit Spring Boot.

Java-Anwendungsserver

Informationen zum Einrichten des Application Insights-Java-Agents finden Sie unter Aktivieren von Azure Monitor OpenTelemetry für Java. Die folgenden Abschnitte enthalten Details, die beim Konfigurieren der JVM-Arg -javaagent:... auf verschiedenen Anwendungsservern hilfreich sein könnten.

Tomcat 8 (Linux)

Installation von Tomcat über apt-get oder yum

Wenn Sie Tomcat über apt-get oder yum installiert haben, sollten Sie über eine Datei /etc/tomcat8/tomcat8.conf verfügen. Fügen Sie die folgende Zeile am Ende dieser Datei hinzu:

JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.5.2.jar"

Durch Herunterladen und Entpacken installiertes Tomcat

Wenn Sie Tomcat durch Herunterladen von https://tomcat.apache.org und Entpacken installiert haben, sollten Sie über eine Datei <tomcat>/bin/catalina.sh verfügen. Erstellen Sie im gleichen Verzeichnis eine neue Datei mit dem Namen <tomcat>/bin/setenv.sh und folgendem Inhalt:

CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.5.2.jar"

Wenn die Datei <tomcat>/bin/setenv.sh bereits vorhanden ist, ändern Sie diese Datei, und fügen Sie -javaagent:path/to/applicationinsights-agent-3.5.2.jar zu CATALINA_OPTS hinzu.

Tomcat 8 (Windows)

Ausführen von Tomcat über die Befehlszeile

Suchen Sie die <tomcat>/bin/catalina.bat-Datei. Erstellen Sie im gleichen Verzeichnis eine neue Datei mit dem Namen <tomcat>/bin/setenv.bat und folgendem Inhalt:

set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.5.2.jar

Anführungszeichen sind nicht erforderlich, doch wenn Sie welche einfügen möchten, werden sie hier platziert:

set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.5.2.jar"

Wenn die Datei <tomcat>/bin/setenv.bat bereits vorhanden ist, ändern Sie diese Datei, und fügen Sie -javaagent:path/to/applicationinsights-agent-3.5.2.jar zu CATALINA_OPTS hinzu.

Ausführen von Tomcat als Windows-Dienst

Suchen Sie die <tomcat>/bin/tomcat8w.exe-Datei. Führen Sie diese ausführbare Datei aus, und fügen Sie auf der Registerkarte Java für Java Options den Eintrag -javaagent:path/to/applicationinsights-agent-3.5.2.jar hinzu.

JBoss Enterprise Application Platform 7

In Red Hat JBoss Enterprise Application Platform (EAP) 7 können Sie einen eigenständigen Server oder einen Domänenserver einrichten.

Eigenständiger Server

Fügen Sie in der Datei JBOSS_HOME/bin/standalone.conf (Linux) oder JBOSS_HOME/bin/standalone.conf.bat (Windows) der vorhandenen Umgebungsvariablen JAVA_OPTS den Eintrag -javaagent:path/to/applicationinsights-agent-3.5.2.jar hinzu:

    JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.5.2.jar -Xms1303m -Xmx1303m ..."
    ...

Domänenserver

Fügen Sie in JBOSS_HOME/domain/configuration/host.xml den vorhandenen jvm-options den Eintrag -javaagent:path/to/applicationinsights-agent-3.5.2.jar hinzu:

...
<jvms>
    <jvm name="default">
        <heap size="64m" max-size="256m"/>
        <jvm-options>
            <option value="-server"/>
            <!--Add Java agent jar file here-->
            <option value="-javaagent:path/to/applicationinsights-agent-3.5.2.jar"/>
            <option value="-XX:MetaspaceSize=96m"/>
            <option value="-XX:MaxMetaspaceSize=256m"/>
        </jvm-options>
    </jvm>
</jvms>
...

Wenn Sie mehrere verwaltete Server auf einem einzigen Host ausführen, müssen Sie den Eintrag applicationinsights.agent.id bei system-properties für jeden server hinzufügen:

...
<servers>
    <server name="server-one" group="main-server-group">
        <!--Edit system properties for server-one-->
        <system-properties> 
            <property name="applicationinsights.agent.id" value="..."/>
        </system-properties>
    </server>
    <server name="server-two" group="main-server-group">
        <socket-bindings port-offset="150"/>
        <!--Edit system properties for server-two-->
        <system-properties>
            <property name="applicationinsights.agent.id" value="..."/> 
        </system-properties>
    </server>
</servers>
...

Der angegebene Wert für applicationinsights.agent.id muss eindeutig sein. Sie verwenden den Wert, um ein Unterverzeichnis im Application Insights-Verzeichnis zu erstellen. Jeder JVM-Prozess benötigt eine eigene lokale Application Insights-Konfiguration und eine lokale Application Insights-Protokolldatei. Außerdem nutzen bei der Berichterstattung an den zentralen Collector mehrere verwaltete Server die Datei applicationinsights.properties gemeinsam, sodass die angegebene applicationinsights.agent.id benötigt wird, um die agent.id-Einstellung in dieser gemeinsam genutzten Datei zu überschreiben. Die applicationinsights.agent.rollup.id kann auf ähnliche Weise in den system-properties des Servers angegeben werden, wenn Sie die agent.rollup.id-Einstellung für einzelne verwaltete Server überschreiben müssen.

Jetty 9

Fügen Sie start.ini die folgenden Zeilen hinzu:

--exec
-javaagent:path/to/applicationinsights-agent-3.5.2.jar

Payara 5

Fügen Sie in glassfish/domains/domain1/config/domain.xml den vorhandenen jvm-options den Eintrag -javaagent:path/to/applicationinsights-agent-3.5.2.jar hinzu:

...
<java-config ...>
    <!--Edit the JVM options here-->
    <jvm-options>
        -javaagent:path/to/applicationinsights-agent-3.5.2.jar>
    </jvm-options>
        ...
</java-config>
...

WebSphere 8

Öffnen Sie die Verwaltungskonsole.
Wechseln Sie zu Server>WebSphere-Anwendungsserver>Anwendungsserver. Wählen Sie die entsprechenden Anwendungsserver aus, und wählen Sie Java- und Prozessverwaltung>Prozessdefinition>Java-VM aus.
Fügen Sie in Generic JVM arguments das folgende JVM-Argument hinzu.
```
-javaagent:path/to/applicationinsights-agent-3.5.2.jar
```
Speichern Sie den Anwendungsserver, und starten Sie ihn neu.

OpenLiberty 18

Erstellen Sie eine neue Datei jvm.options im Serververzeichnis (z. B. <openliberty>/usr/servers/defaultServer), und fügen Sie die folgende Zeile hinzu:

-javaagent:path/to/applicationinsights-agent-3.5.2.jar

Sonstige

Informationen zum Hinzufügen von JVM-Argumenten finden Sie in der Dokumentation des Anwendungsservers.