Első lépések (kiegészítő)

A következő szakaszokban megtudhatja, hogyan szerezheti be a Java autoinstrumentációt adott technikai környezetekhez.

Azure App Service

További információ: Alkalmazásfigyelés Azure-alkalmazás Szolgáltatáshoz és Java-hoz.

Azure Functions

További információért lásd: Az Azure Functions monitorozása az Azure Monitor Application Insights segítségével.

Azure Spring Apps

További információ: Az Alkalmazás Elemzések Java In-Process Agent használata az Azure Spring Appsben.

Tárolók

Feljegyzés

A Spring Boot natív rendszerkép-alkalmazásokkal az Azure Monitor OpenTelemetry Distro/Application Elemzések használata a Spring Boot natív rendszerkép Java-alkalmazásprojektjében az Alkalmazás Elemzések Java-ügynök helyett.

Docker belépési pont

Ha az exec űrlapot használja, adja hozzá a paramétert -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" a paraméterlistához valahol a "-jar" paraméter előtt, például:

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

Ha a rendszerhéj űrlapot használja, adja hozzá a Java Virtual Machine (JVM) arg-t -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" valahol korábban -jar, például:

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

Docker-fájl

Példa Dockerfile-ra:

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

Ebben a példában a fájlokat és applicationinsights.json a applicationinsights-agent-3.5.2.jar fájlokat egy agent mappából másolja (a gép bármelyik mappáját kiválaszthatja). Ennek a két fájlnak ugyanabban a mappában kell lennie a Docker-tárolóban.

Partnertároló lemezképe

Ha olyan partnertároló-lemezképet használ, amelyet nem tud módosítani, csatlakoztassa az alkalmazást Elemzések Java-ügynök jart kívülről a tárolóba. A tároló JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jarkörnyezeti változójának beállítása.

Spring Boot

További információ: Az Azure Monitor-alkalmazás Elemzések használata a Spring Boot használatával.

Java-alkalmazáskiszolgálók

Az alkalmazás Elemzések Java-ügynök beállításáról további információt az Azure Monitor OpenTelemetry engedélyezése Java-hoz című témakörben talál. A következő szakaszok olyan részleteket nyújtanak, amelyek hasznosak lehetnek a JVM arg -javaagent:... különböző alkalmazáskiszolgálókon való konfigurálásakor.

Tomcat 8 (Linux)

Az apt-get vagy yum használatával telepített Tomcat

Ha a Tomcatet a vagy yuma másikon keresztül apt-get telepítette, rendelkeznie kell egy fájllal/etc/tomcat8/tomcat8.conf. Adja hozzá ezt a sort a fájl végéhez:

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

Letöltéssel telepített Tomcat és unzip

Ha letöltéssel telepítette a Tomcat-et, és kicsomagolt a fájlból https://tomcat.apache.org, rendelkeznie kell egy fájllal <tomcat>/bin/catalina.sh. Hozzon létre egy új fájlt ugyanabban a könyvtárban a következő tartalommal:<tomcat>/bin/setenv.sh

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

Ha a fájl <tomcat>/bin/setenv.sh már létezik, módosítsa a fájlt, és adja hozzá -javaagent:path/to/applicationinsights-agent-3.5.2.jar a fájlhoz CATALINA_OPTS.

Tomcat 8 (Windows)

A Tomcat futtatása a parancssorból

Keresse meg a fájlt <tomcat>/bin/catalina.bat. Hozzon létre egy új fájlt ugyanabban a könyvtárban a következő tartalommal:<tomcat>/bin/setenv.bat

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

Az idézőjelek nem szükségesek, de ha fel szeretné venni őket, a megfelelő elhelyezés a következő:

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

Ha a fájl <tomcat>/bin/setenv.bat már létezik, módosítsa a fájlt, és adja hozzá -javaagent:path/to/applicationinsights-agent-3.5.2.jar a fájlhoz CATALINA_OPTS.

A Tomcat futtatása Windows-szolgáltatásként

Keresse meg a fájlt <tomcat>/bin/tomcat8w.exe. Futtassa a végrehajtható fájlt, és adja hozzá -javaagent:path/to/applicationinsights-agent-3.5.2.jar a JavaJava Options lap alatti laphoz.

JBoss Enterprise Application Platform 7

A Red Hat JBoss Enterprise Application Platform (EAP) 7-ben önálló kiszolgálót vagy tartományi kiszolgálót állíthat be.

Önálló kiszolgáló

Adja hozzá -javaagent:path/to/applicationinsights-agent-3.5.2.jar a meglévő JAVA_OPTS környezeti változót a fájlban JBOSS_HOME/bin/standalone.conf (Linux) vagy JBOSS_HOME/bin/standalone.conf.bat (Windows):

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

Tartománykiszolgáló

Hozzáadás -javaagent:path/to/applicationinsights-agent-3.5.2.jar a meglévőhöz jvm-options a következőben 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>
...

Ha több felügyelt kiszolgálót futtat egyetlen gazdagépen, hozzá kell adnia applicationinsights.agent.id az system-properties egyes serverkiszolgálókhoz:

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

A megadott applicationinsights.agent.id értéknek egyedinek kell lennie. Az érték használatával alkönyvtárat hozhat létre az Alkalmazás Elemzések könyvtár alatt. Minden JVM-folyamathoz saját helyi alkalmazás Elemzések konfigurációra és helyi alkalmazás Elemzések naplófájlra van szükség. Ha a központi gyűjtőnek jelent, több felügyelt kiszolgáló is megosztja a applicationinsights.properties fájlt, ezért a megadott applicationinsights.agent.id értékre van szükség a agent.id megosztott fájlban lévő beállítás felülbírálásához. A applicationinsights.agent.rollup.id kiszolgálóhoz hasonlóan megadható system-properties , ha felül kell bírálnia a agent.rollup.id felügyelt kiszolgálónkénti beállítást.

Jetty 9

Adja hozzá ezeket a sorokat a következőhöz start.ini:

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

Payara 5

Hozzáadás -javaagent:path/to/applicationinsights-agent-3.5.2.jar a meglévőhöz jvm-options a következőben 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

1. Nyissa meg a Felügyeleti konzolt.

2. Lépjen a Servers>WebSphere alkalmazáskiszolgálók alkalmazáskiszolgálóira.> Válassza ki a megfelelő alkalmazáskiszolgálót, és válassza a Java és a Folyamatkezelési>folyamat definíciója>Java virtuális gép lehetőséget.

3. Adja Generic JVM argumentshozzá a következő JVM-argumentumot.

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

4. Mentse és indítsa újra az alkalmazáskiszolgálót.

OpenLiberty 18

Hozzon létre egy új fájlt jvm.options a kiszolgálókönyvtárban (például <openliberty>/usr/servers/defaultServer), és adja hozzá a következő sort:

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

Egyéb

Tekintse meg az alkalmazáskiszolgáló dokumentációját a JVM args hozzáadásáról.