Memulai (Tambahan)

  • Artikel

Di bagian berikut, pelajari cara mendapatkan autoinstrumentasi Java untuk lingkungan teknis tertentu.

Azure App Service

Untuk informasi selengkapnya, lihat Pemantauan aplikasi untuk Azure App Service dan Java.

Azure Functions

Untuk informasi selengkapnya, lihat Memantau Azure Functions dengan Azure Monitor Application Insights.

Azure Spring Apps

Untuk informasi selengkapnya, harap lihat Agen Proses Java Application Insights di Azure Spring Apps.

Kontainer

Catatan

Dengan aplikasi Spring Boot Native Image, gunakan azure Monitor OpenTelemetry Distro / Application Insights di proyek aplikasi Java gambar asli Spring Boot alih-alih agen Application Insights Java.

Titik masuk Docker

Jika Anda menggunakan formulir exec, tambahkan parameter -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" ke daftar parameter di suatu tempat sebelum parameter "-jar", misalnya:

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

Jika Anda menggunakan formulir shell , tambahkan arg -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" Java Virtual Machine (JVM) di suatu tempat sebelum -jar, misalnya:

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

File Docker

Contoh Dockerfile:

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

Dalam contoh ini, Anda menyalin applicationinsights-agent-3.5.2.jar file dan applicationinsights.json dari agent folder (Anda dapat memilih folder apa pun dari komputer Anda). Kedua file ini harus berada di folder yang sama di kontainer Docker.

Gambar kontainer mitra

Jika Anda menggunakan gambar kontainer mitra yang tidak dapat Anda ubah, pasang jar agen Application Insights Java ke dalam kontainer dari luar. Atur variabel lingkungan untuk kontainer JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar.

Spring Boot

Untuk informasi selengkapnya, lihat Menggunakan Azure Monitor Application Insights dengan Spring Boot.

Server Aplikasi Java

Untuk informasi tentang menyiapkan agen Application Insights Java, lihat Mengaktifkan Azure Monitor OpenTelemetry untuk Java. Bagian berikut memberikan detail yang mungkin berguna saat mengonfigurasi -javaagent:... arg JVM di server aplikasi yang berbeda.

Tomcat 8 (Linux)

Tomcat diinstal melalui apt-get atau yum

Jika Anda menginstal Tomcat melalui apt-get atau yum, Anda harus memiliki file /etc/tomcat8/tomcat8.conf. Tambahkan baris ini ke akhir file tersebut:

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

Tomcat diinstal melalui unduh dan unzip

Jika Anda menginstal Tomcat melalui unduhan dan unzip dari https://tomcat.apache.org, Anda harus memiliki file <tomcat>/bin/catalina.sh. Buat file baru dalam direktori yang sama dengan nama <tomcat>/bin/setenv.sh dengan konten berikut:

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

Jika file <tomcat>/bin/setenv.sh sudah ada, ubah file tersebut dan tambahkan -javaagent:path/to/applicationinsights-agent-3.5.2.jar ke CATALINA_OPTS.

Tomcat 8 (Windows)

Jalankan Tomcat dari baris perintah

Temukan file <tomcat>/bin/catalina.bat. Buat file baru dalam direktori yang sama dengan nama <tomcat>/bin/setenv.bat dengan konten berikut:

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

Kuotasi tidak diperlukan, namun jika Anda ingin menyertakannya, penempatan yang tepat adalah:

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

Jika file <tomcat>/bin/setenv.bat sudah ada, ubah file tersebut dan tambahkan -javaagent:path/to/applicationinsights-agent-3.5.2.jar ke CATALINA_OPTS.

Menjalankan Tomcat sebagai layanan Windows

Temukan file <tomcat>/bin/tomcat8w.exe. Jalankan executable tersebut lalu tambahkan -javaagent:path/to/applicationinsights-agent-3.5.2.jar ke Java Options pada tab Java.

Platform Aplikasi JBoss Enterprise 7

Di Red Hat JBoss Enterprise Application Platform (EAP) 7, Anda dapat menyiapkan server mandiri atau server domain.

Server mandiri

Tambahkan -javaagent:path/to/applicationinsights-agent-3.5.2.jar ke variabel lingkungan JAVA_OPTS yang sudah ada dalam file JBOSS_HOME/bin/standalone.conf (Linux) atau JBOSS_HOME/bin/standalone.conf.bat (Windows):

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

Server domain

Tambahkan -javaagent:path/to/applicationinsights-agent-3.5.2.jar ke jvm-options yang sudah ada di 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>
...

Jika Anda menjalankan beberapa server terkelola pada satu host, Anda perlu menambahkan applicationinsights.agent.id ke system-properties untuk masing-masing 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>
...

Nilai applicationinsights.agent.id yang ditentukan harus unik. Anda menggunakan nilai untuk membuat subdirektori di bawah direktori Application Insights. Setiap proses JVM memerlukan konfigurasi Application Insights lokalnya sendiri dan file log Application Insights lokal. Selain itu, jika melaporkan ke pengumpul pusat, beberapa server terkelola berbagi applicationinsights.properties file, sehingga yang ditentukan applicationinsights.agent.id diperlukan untuk mengambil alih pengaturan dalam file bersama tersebut agent.id . applicationinsights.agent.rollup.id dapat ditentukan secara serupa di server system-properties jika Anda perlu mengambil alih pengaturan per server terkelolaagent.rollup.id.

Jetty 9

Tambahkan baris ini ke start.ini:

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

Payara 5

Tambahkan -javaagent:path/to/applicationinsights-agent-3.5.2.jar ke jvm-options yang sudah ada di 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. Buka Konsol Manajemen.

  2. Buka Server>server>aplikasi WebSphere Server aplikasi. Pilih server aplikasi yang sesuai dan pilih Java dan Proses Manajemen>Proses definisi>Java Virtual Machine.

  3. Di Generic JVM arguments, tambahkan argumen JVM berikut.

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

  4. Simpan dan mulai ulang server aplikasi.

OpenLiberty 18

Buat file jvm.options baru di direktori server (misalnya, <openliberty>/usr/servers/defaultServer), dan tambahkan baris ini:

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

Lainnya

Lihat dokumentasi server aplikasi Anda tentang cara menambahkan argumen JVM.