Aan de slag (aanvullend)

Artikel
04/22/2024

In de volgende secties leert u hoe u automatische java-instrumentatie voor specifieke technische omgevingen kunt verkrijgen.

Azure App Service

Zie Toepassingsbewaking voor Azure-app Service en Java voor meer informatie.

Azure Functions

Zie Azure Functions bewaken met Azure Monitor Application Insights voor meer informatie.

Azure Spring Apps

Zie Application Insights Java In-Process Agent gebruiken in Azure Spring Apps voor meer informatie.

Containers

Notitie

Gebruik met Spring Boot Native Image-toepassingen het Azure Monitor OpenTelemetry Distro/Application Insights in spring Boot native image Java application project in plaats van de Application Insights Java-agent.

Docker-toegangspunt

Als u het exec-formulier gebruikt, voegt u de parameter -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" ergens vóór de parameter toe aan de "-jar" lijst met parameters, bijvoorbeeld:

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

Als u het shell-formulier gebruikt, voegt u het JVM-argument -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" (Java Virtual Machine) ergens eerder -jartoe, bijvoorbeeld:

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

Docker-bestand

Een Dockerfile-voorbeeld:

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 dit voorbeeld kopieert u de applicationinsights-agent-3.5.2.jar bestanden uit applicationinsights.json een agent map (u kunt elke map van uw computer kiezen). Deze twee bestanden moeten zich in dezelfde map in de Docker-container bevinden.

Containerinstallatiekopieën van partners

Als u een containerinstallatiekopieën van partners gebruikt die u niet kunt wijzigen, koppelt u het Jar-bestand van de Java-agent van Application Insights aan de container van buiten. Stel de omgevingsvariabele voor de container JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jarin.

Spring Boot

Zie Azure Monitor Application Insights gebruiken met Spring Boot voor meer informatie.

Java-toepassingsservers

Zie Azure Monitor OpenTelemetry voor Java inschakelen voor Java voor meer informatie over het instellen van de Application Insights Java-agent. De volgende secties bevatten details die nuttig kunnen zijn bij het configureren van het -javaagent:... JVM-argument op verschillende toepassingsservers.

Tomcat 8 (Linux)

Tomcat geïnstalleerd via apt-get of yum

Als u Tomcat hebt geïnstalleerd via apt-get of yum, moet u een bestand /etc/tomcat8/tomcat8.confhebben. Voeg deze regel toe aan het einde van dat bestand:

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

Tomcat geïnstalleerd via downloaden en uitpakken

Als u Tomcat hebt geïnstalleerd via downloaden en uitpakken https://tomcat.apache.org, moet u een bestand <tomcat>/bin/catalina.shhebben. Maak een nieuw bestand in dezelfde map met de naam <tomcat>/bin/setenv.sh met de volgende inhoud:

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

Als het bestand al bestaat, wijzigt u dat bestand <tomcat>/bin/setenv.sh en voegt u dit toe-javaagent:path/to/applicationinsights-agent-3.5.2.jar.CATALINA_OPTS

Tomcat 8 (Windows)

Tomcat uitvoeren vanaf de opdrachtregel

Zoek het bestand <tomcat>/bin/catalina.bat. Maak een nieuw bestand in dezelfde map met de naam <tomcat>/bin/setenv.bat met de volgende inhoud:

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

Aanhalingstekens zijn niet nodig, maar als u ze wilt opnemen, is de juiste plaatsing:

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

Als het bestand al bestaat, wijzigt u dat bestand <tomcat>/bin/setenv.bat en voegt u dit toe-javaagent:path/to/applicationinsights-agent-3.5.2.jar.CATALINA_OPTS

Tomcat uitvoeren als een Windows-service

Zoek het bestand <tomcat>/bin/tomcat8w.exe. Voer dat uitvoerbare bestand uit en voeg deze toe aan -javaagent:path/to/applicationinsights-agent-3.5.2.jar het Java OptionsJava tabblad.

JBoss Enterprise Application Platform 7

In Red Hat JBoss Enterprise Application Platform (EAP) 7 kunt u een zelfstandige server of een domeinserver instellen.

Zelfstandige server

Toevoegen -javaagent:path/to/applicationinsights-agent-3.5.2.jar aan de bestaande omgevingsvariabele JAVA_OPTS in het bestand JBOSS_HOME/bin/standalone.conf (Linux) of JBOSS_HOME/bin/standalone.conf.bat (Windows):

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

Domeinserver

Toevoegen -javaagent:path/to/applicationinsights-agent-3.5.2.jar aan de bestaande jvm-options in JBOSS_HOME/domain/configuration/host.xml:

...
<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>
...

Als u meerdere beheerde servers op één host uitvoert, moet u het system-properties volgende servertoevoegenapplicationinsights.agent.id:

...
<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>
...

De opgegeven applicationinsights.agent.id waarde moet uniek zijn. U gebruikt de waarde om een submap te maken onder de Application Insights-map. Elk JVM-proces heeft een eigen lokale Application Insights-configuratie en een lokaal Application Insights-logboekbestand nodig. Als u rapporteert aan de centrale collector, delen meerdere beheerde servers het applicationinsights.properties bestand, zodat de opgegeven applicationinsights.agent.id instelling in dat gedeelde bestand moet worden overschreven agent.id . De applicationinsights.agent.rollup.id waarde kan op dezelfde manier worden opgegeven in de server system-properties als u de agent.rollup.id instelling per beheerde server moet overschrijven.

Jetty 9

Voeg deze regels toe aan start.ini:

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

Payara 5

Toevoegen -javaagent:path/to/applicationinsights-agent-3.5.2.jar aan de bestaande jvm-options in glassfish/domains/domain1/config/domain.xml:

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

WebSphere 8

Open de beheerconsole.
Ga naar Servers>WebSphere-toepassingsservers>Toepassingsservers. Kies de juiste toepassingsservers en selecteer Java- en Procesbeheerdefinitie>>Java Virtual Machine.
Voeg Generic JVM argumentsin het volgende JVM-argument toe.
```
-javaagent:path/to/applicationinsights-agent-3.5.2.jar
```
Sla de toepassingsserver op en start deze opnieuw.

OpenLiberty 18

Maak een nieuw bestand jvm.options in de servermap (bijvoorbeeld <openliberty>/usr/servers/defaultServer) en voeg deze regel toe:

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

Andere

Raadpleeg de documentatie van uw toepassingsserver over het toevoegen van JVM-argumenten.