Kom igång (kompletterande)

Artikel
04/22/2024

I följande avsnitt får du lära dig hur du hämtar automatisk Java-instrumentering för specifika tekniska miljöer.

Azure App Service

Mer information finns i Programövervakning för Azure App Service och Java.

Azure Functions

Mer information finns i Övervaka Azure Functions med Azure Monitor Application Insights.

Azure Spring Apps

Mer information finns i Använda Application Insights Java In-Process Agent i Azure Spring Apps.

Containers

Kommentar

Med Spring Boot Native Image-program använder du Azure Monitor OpenTelemetry Distro/Application Insights i Det inbyggda Java-avbildningsprojektet för Spring Boot i stället för Application Insights Java-agenten.

Docker-startpunkt

Om du använder exec-formuläret lägger du till parametern -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" i parameterlistan någonstans före parametern"-jar", till exempel:

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

Om du använder gränssnittet lägger du till Java Virtual Machine (JVM) arg -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" någonstans före -jar, till exempel:

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

Docker-fil

Ett Dockerfile-exempel:

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"]

I det här exemplet kopierar applicationinsights-agent-3.5.2.jar du filerna och applicationinsights.json från en agent mapp (du kan välja valfri mapp på datorn). Dessa två filer måste finnas i samma mapp i Docker-containern.

Partnercontaineravbildningar

Om du använder en partnercontaineravbildning som du inte kan ändra monterar du Application Insights Java-agentburken i containern utifrån. Ange miljövariabeln för containern JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar.

Spring Boot

Mer information finns i Använda Azure Monitor Application Insights med Spring Boot.

Java-programservrar

Information om hur du konfigurerar Application Insights Java-agenten finns i Aktivera Azure Monitor OpenTelemetry för Java. Följande avsnitt innehåller information som kan vara till hjälp när du konfigurerar -javaagent:... JVM arg på olika programservrar.

Tomcat 8 (Linux)

Tomcat installerat via apt-get eller yum

Om du har installerat Tomcat via apt-get eller yumbör du ha en fil /etc/tomcat8/tomcat8.conf. Lägg till den här raden i slutet av filen:

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

Tomcat installerat via nedladdning och packa upp

Om du har installerat Tomcat via nedladdning och packa upp från https://tomcat.apache.orgbör du ha en fil <tomcat>/bin/catalina.sh. Skapa en ny fil i samma katalog <tomcat>/bin/setenv.sh med namnet med följande innehåll:

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

Om filen <tomcat>/bin/setenv.sh redan finns ändrar du filen och lägger till -javaagent:path/to/applicationinsights-agent-3.5.2.jar i CATALINA_OPTS.

Tomcat 8 (Windows)

Kör Tomcat från kommandoraden

Leta upp filen <tomcat>/bin/catalina.bat. Skapa en ny fil i samma katalog <tomcat>/bin/setenv.bat med namnet med följande innehåll:

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

Citattecken är inte nödvändiga, men om du vill inkludera dem är rätt placering:

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

Om filen <tomcat>/bin/setenv.bat redan finns ändrar du filen och lägger till -javaagent:path/to/applicationinsights-agent-3.5.2.jar i CATALINA_OPTS.

Kör Tomcat som en Windows-tjänst

Leta upp filen <tomcat>/bin/tomcat8w.exe. Kör den körbara filen och lägg till -javaagent:path/to/applicationinsights-agent-3.5.2.jar under Java Options fliken Java .

JBoss Enterprise Application Platform 7

I Red Hat JBoss Enterprise Application Platform (EAP) 7 kan du konfigurera en fristående server eller en domänserver.

Fristående server

Lägg till -javaagent:path/to/applicationinsights-agent-3.5.2.jar i den befintliga JAVA_OPTS miljövariabeln i filen JBOSS_HOME/bin/standalone.conf (Linux) eller JBOSS_HOME/bin/standalone.conf.bat (Windows):

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

Domänserver

Lägg till -javaagent:path/to/applicationinsights-agent-3.5.2.jar i den befintliga jvm-options i 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>
...

Om du kör flera hanterade servrar på en enda värd måste du lägga applicationinsights.agent.id till system-properties för varje server:

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

Det angivna applicationinsights.agent.id värdet måste vara unikt. Du använder värdet för att skapa en underkatalog under katalogen Application Insights. Varje JVM-process behöver en egen lokal Application Insights-konfiguration och en lokal Application Insights-loggfil. Om du rapporterar till den centrala insamlaren delar applicationinsights.properties dessutom flera hanterade servrar filen, så den angivna applicationinsights.agent.id behövs för att åsidosätta inställningen i den agent.id delade filen. applicationinsights.agent.rollup.id Kan anges på samma sätt i serverns system-properties om du behöver åsidosätta agent.rollup.id inställningen per hanterad server.

Brygga 9

Lägg till dessa rader i start.ini:

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

Payara 5

Lägg till -javaagent:path/to/applicationinsights-agent-3.5.2.jar i den befintliga jvm-options i 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

Öppna hanteringskonsolen.
Gå till Servrar>WebSphere-programservrar>Programservrar. Välj lämpliga programservrar och välj Java- och processhanteringsprocessens>definition>Java Virtual Machine.
I Generic JVM argumentslägger du till följande JVM-argument.
```
-javaagent:path/to/applicationinsights-agent-3.5.2.jar
```
Spara och starta om programservern.

OpenLiberty 18

Skapa en ny fil jvm.options i serverkatalogen (till exempel <openliberty>/usr/servers/defaultServer) och lägg till den här raden:

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

Andra

Se dokumentationen för programservern om hur du lägger till JVM args.

Share via