Başlarken (Ek)

Makale
03/19/2024

Aşağıdaki bölümlerde, belirli teknik ortamlar için Java otomatik dağıtımını nasıl edineceğinizi öğrenin.

Azure App Service

Daha fazla bilgi için bkz. Azure Uygulaması Hizmeti ve Java için uygulama izleme.

Azure İşlevleri

Daha fazla bilgi için bkz. Azure İzleyici Application Insights ile Azure İşlevleri'ni İzleme.

Azure Spring Apps

Daha fazla bilgi için bkz. Azure Spring Apps'te Uygulama Analizler Java İşlem İçi Aracısı'nı kullanma.

Kapsayıcılar

Not

Spring Boot Yerel Görüntü uygulamalarıyla, Application Analizler Java aracısı yerine Spring Boot yerel görüntüsü Java uygulama projesinde Azure İzleyici OpenTelemetry Distro / Application Analizler kullanın.

Docker giriş noktası

exec formunu kullanıyorsanız parametresini parametreden -javaagent:"path/to/applicationinsights-agent-3.5.1.jar" önceki "-jar" bir yere parametre listesine ekleyin, örneğin:

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

Kabuk formunu kullanıyorsanız Java Sanal Makinesi (JVM) arg'sini -javaagent:"path/to/applicationinsights-agent-3.5.1.jar" öncesinde -jarbir yere ekleyin, örneğin:

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

Docker dosyası

Dockerfile örneği:

FROM ...

COPY target/*.jar app.jar

COPY agent/applicationinsights-agent-3.5.1.jar applicationinsights-agent-3.5.1.jar 

COPY agent/applicationinsights.json applicationinsights.json

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

Bu örnekte, ve applicationinsights.json dosyalarını bir klasörden applicationinsights-agent-3.5.1.jar kopyalarsınız (makinenizin herhangi bir agent klasörünü seçebilirsiniz). Bu iki dosyanın Docker kapsayıcısında aynı klasörde olması gerekir.

İş ortağı kapsayıcı görüntüleri

Değiştiremediğiniz bir iş ortağı kapsayıcı görüntüsü kullanıyorsanız Application Analizler Java aracı jar dosyasını kapsayıcıya dışarıdan bağlayın. kapsayıcısı JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jariçin ortam değişkenini ayarlayın.

Spring Boot

Daha fazla bilgi için bkz. Spring Boot ile Azure İzleyici Uygulaması Analizler kullanma.

Java Uygulama sunucuları

Application Analizler Java aracısını ayarlama hakkında bilgi için bkz. Java için Azure İzleyici OpenTelemetry'yi etkinleştirme. Aşağıdaki bölümlerde, JVM arg'yi farklı uygulama sunucularında yapılandırırken -javaagent:... yararlı olabilecek ayrıntılar sağlanır.

Tomcat 8 (Linux)

apt-get veya yum aracılığıyla yüklenen Tomcat

Tomcat'i veya yumaracılığıyla apt-get yüklediyseniz bir dosyanız /etc/tomcat8/tomcat8.confolmalıdır. Bu satırı dosyanın sonuna ekleyin:

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

İndirme ve sıkıştırmayı açma yoluyla yüklenen Tomcat

Tomcat'i indirme ve dosyasından https://tomcat.apache.orgsıkıştırmasını açma yoluyla yüklediyseniz bir dosyanız <tomcat>/bin/catalina.sholmalıdır. Aynı dizinde aşağıdaki içeriğe sahip adlı <tomcat>/bin/setenv.sh yeni bir dosya oluşturun:

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

Dosya <tomcat>/bin/setenv.sh zaten varsa, bu dosyayı değiştirin ve öğesine CATALINA_OPTSekleyin-javaagent:path/to/applicationinsights-agent-3.5.1.jar.

Tomcat 8 (Windows)

Komut satırından Tomcat'i çalıştırma

dosyasını <tomcat>/bin/catalina.batbulun. Aynı dizinde aşağıdaki içeriğe sahip adlı <tomcat>/bin/setenv.bat yeni bir dosya oluşturun:

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

Tırnak işaretleri gerekli değildir, ancak bunları dahil etmek istiyorsanız, uygun yerleştirme şu şekildedir:

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

Dosya <tomcat>/bin/setenv.bat zaten varsa, bu dosyayı değiştirin ve öğesine CATALINA_OPTSekleyin-javaagent:path/to/applicationinsights-agent-3.5.1.jar.

Tomcat'i Windows hizmeti olarak çalıştırma

dosyasını <tomcat>/bin/tomcat8w.exebulun. Bu yürütülebilir dosyayı çalıştırın ve sekmesinin Java OptionsJava altına ekleyin-javaagent:path/to/applicationinsights-agent-3.5.1.jar.

JBoss Enterprise Application Platform 7

Red Hat JBoss Enterprise Application Platform (EAP) 7'de tek başına sunucu veya etki alanı sunucusu ayarlayabilirsiniz.

Tek başına sunucu

Dosyada JBOSS_HOME/bin/standalone.conf (Linux) veya JBOSS_HOME/bin/standalone.conf.bat (Windows) mevcut JAVA_OPTS ortam değişkenine ekleyin-javaagent:path/to/applicationinsights-agent-3.5.1.jar:

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

Etki alanı sunucusu

içinde JBOSS_HOME/domain/configuration/host.xmlvar olan jvm-options öğesini ekleyin-javaagent:path/to/applicationinsights-agent-3.5.1.jar:

...
<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.1.jar"/>
            <option value="-XX:MetaspaceSize=96m"/>
            <option value="-XX:MaxMetaspaceSize=256m"/>
        </jvm-options>
    </jvm>
</jvms>
...

Tek bir konakta birden çok yönetilen sunucu çalıştırıyorsanız, her serveriçin öğesine system-properties eklemeniz applicationinsights.agent.id gerekir:

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

Belirtilen applicationinsights.agent.id değer benzersiz olmalıdır. Değerini, Application Analizler dizini altında bir alt dizin oluşturmak için kullanırsınız. Her JVM işleminin kendi yerel Application Analizler yapılandırmasına ve yerel Application Analizler günlük dosyasına ihtiyacı vardır. Ayrıca, merkezi toplayıcıya rapor veriyorsanız, birden çok yönetilen sunucu dosyayı paylaşırapplicationinsights.properties, bu nedenle bu paylaşılan dosyadaki ayarı geçersiz kılmak agent.id için belirtilen applicationinsights.agent.id gereklidir. applicationinsights.agent.rollup.id ayarı yönetilen sunucu system-properties başına geçersiz kılmanız agent.rollup.id gerekiyorsa, sunucularda da benzer şekilde belirtilebilir.

Jetty 9

Bu satırları içine start.iniekleyin:

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

Payara 5

içinde glassfish/domains/domain1/config/domain.xmlvar olan jvm-options öğesini ekleyin-javaagent:path/to/applicationinsights-agent-3.5.1.jar:

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

WebSphere 8

Yönetim Konsolu'nu açın.
Sunucular>WebSphere uygulama sunucuları Uygulama sunucuları'na> gidin. Uygun uygulama sunucularını seçin ve Java ve İşlem Yönetimi>İşlem tanımı>Java Sanal Makinesi'ni seçin.
içine Generic JVM argumentsaşağıdaki JVM bağımsız değişkenini ekleyin.
```
-javaagent:path/to/applicationinsights-agent-3.5.1.jar
```
Uygulama sunucusunu kaydedin ve yeniden başlatın.

OpenLiberty 18

Sunucu dizininde yeni bir dosya jvm.options oluşturun (örneğin, <openliberty>/usr/servers/defaultServer) ve şu satırı ekleyin:

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

Diğer

JVM args ekleme hakkında uygulama sunucusu belgelerinize bakın.