Wprowadzenie (uzupełniające)

  • Artykuł

W poniższych sekcjach dowiesz się, jak uzyskać autoinstrumentację Języka Java dla określonych środowisk technicznych.

Azure App Service

Aby uzyskać więcej informacji, zobacz Monitorowanie aplikacji dla usługi aplikacja systemu Azure i języka Java.

Azure Functions

Aby uzyskać więcej informacji, zobacz Monitorowanie usługi Azure Functions za pomocą usługi Azure Monitor Application Insights.

Azure Spring Apps

Aby uzyskać więcej informacji, zobacz Use Application Szczegółowe informacje Java In-Process Agent in-Process Agent in-Process w usłudze Azure Spring Apps.

Kontenery

Uwaga

W przypadku aplikacji Spring Boot Native Image użyj projektu aplikacji Java obrazów natywnych obrazów środowiska Spring Boot za pomocą narzędzia Azure Monitor OpenTelemetry Distro/ Application Szczegółowe informacje w projekcie aplikacji Java usługi Application Szczegółowe informacje.

Punkt wejścia platformy Docker

Jeśli używasz formularza exec , dodaj parametr -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" do listy parametrów gdzieś przed parametrem "-jar" , na przykład:

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

Jeśli używasz formularza powłoki, dodaj arg -javaagent:"path/to/applicationinsights-agent-3.5.2.jar" maszyny wirtualnej Java (JVM) gdzieś przed -jar, na przykład:

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

Plik platformy Docker

Przykład pliku 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"]

W tym przykładzie skopiujesz applicationinsights-agent-3.5.2.jar pliki i applicationinsights.json z agent folderu (możesz wybrać dowolny folder komputera). Te dwa pliki muszą znajdować się w tym samym folderze w kontenerze platformy Docker.

Obrazy kontenerów partnerów

Jeśli używasz obrazu kontenera partnera, którego nie możesz modyfikować, zainstaluj plik JAR agenta Java application Szczegółowe informacje do kontenera spoza. Ustaw zmienną środowiskową dla kontenera JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar.

Spring Boot

Aby uzyskać więcej informacji, zobacz Using Azure Monitor Application Szczegółowe informacje with Spring Boot (Korzystanie z usługi Azure Monitor Application Szczegółowe informacje z platformą Spring Boot).

Serwery aplikacji Java

Aby uzyskać informacje na temat konfigurowania agenta java usługi Application Szczegółowe informacje, zobacz Włączanie usługi Azure Monitor OpenTelemetry dla języka Java. Poniższe sekcje zawierają szczegółowe informacje, które mogą być przydatne podczas konfigurowania -javaagent:... arg JVM na różnych serwerach aplikacji.

Tomcat 8 (Linux)

Tomcat zainstalowany za pomocą polecenia apt-get lub yum

Jeśli program Tomcat został zainstalowany za pośrednictwem programu apt-get lub yum, powinien istnieć plik /etc/tomcat8/tomcat8.conf. Dodaj ten wiersz na końcu tego pliku:

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

Oprogramowanie Tomcat zainstalowane za pośrednictwem pobierania i rozpakuj

Jeśli narzędzie Tomcat zostało zainstalowane za pośrednictwem pobierania i rozpakuj z https://tomcat.apache.orgprogramu , powinien istnieć plik <tomcat>/bin/catalina.sh. Utwórz nowy plik w tym samym katalogu o nazwie <tomcat>/bin/setenv.sh o następującej zawartości:

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

Jeśli plik <tomcat>/bin/setenv.sh już istnieje, zmodyfikuj ten plik i dodaj -javaagent:path/to/applicationinsights-agent-3.5.2.jar go do CATALINA_OPTSpliku .

Tomcat 8 (Windows)

Uruchamianie serwera Tomcat z wiersza polecenia

Znajdź plik <tomcat>/bin/catalina.bat. Utwórz nowy plik w tym samym katalogu o nazwie <tomcat>/bin/setenv.bat o następującej zawartości:

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

Cudzysłowy nie są konieczne, ale jeśli chcesz je uwzględnić, odpowiednie umieszczenie jest następujące:

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

Jeśli plik <tomcat>/bin/setenv.bat już istnieje, zmodyfikuj ten plik i dodaj -javaagent:path/to/applicationinsights-agent-3.5.2.jar go do CATALINA_OPTSpliku .

Uruchamianie serwera Tomcat jako usługi systemu Windows

Znajdź plik <tomcat>/bin/tomcat8w.exe. Uruchom ten plik wykonywalny i dodaj -javaagent:path/to/applicationinsights-agent-3.5.2.jar go do Java OptionsJava karty.

JBoss Enterprise Application Platform 7

W systemie Red Hat JBoss Enterprise Application Platform (EAP) 7 można skonfigurować serwer autonomiczny lub serwer domeny.

Autonomiczny serwer

Dodaj -javaagent:path/to/applicationinsights-agent-3.5.2.jar do istniejącej JAVA_OPTS zmiennej środowiskowej w pliku JBOSS_HOME/bin/standalone.conf (Linux) lub JBOSS_HOME/bin/standalone.conf.bat (Windows):

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

Serwer domeny

Dodaj -javaagent:path/to/applicationinsights-agent-3.5.2.jar do istniejącego jvm-options elementu w pliku 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>
...

Jeśli korzystasz z wielu serwerów zarządzanych na jednym hoście, musisz dodać applicationinsights.agent.id element do system-properties elementu dla każdego serverelementu :

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

Określona applicationinsights.agent.id wartość musi być unikatowa. Wartość służy do tworzenia podkatalogu w katalogu Application Szczegółowe informacje. Każdy proces JVM wymaga własnej lokalnej konfiguracji aplikacji Szczegółowe informacje i lokalnego pliku dziennika aplikacji Szczegółowe informacje. Ponadto w przypadku raportowania do centralnego modułu zbierającego wiele zarządzanych serwerów współużytkuje applicationinsights.properties plik, dlatego określony applicationinsights.agent.id jest wymagany do zastąpienia agent.id ustawienia w tym udostępnionym pliku. Można applicationinsights.agent.rollup.id je również określić w serwerach system-properties , jeśli musisz zastąpić agent.rollup.id ustawienie dla serwera zarządzanego.

Jetty 9

Dodaj następujące wiersze do polecenia start.ini:

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

Payara 5

Dodaj -javaagent:path/to/applicationinsights-agent-3.5.2.jar do istniejącego jvm-options elementu w pliku 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. Otwórz konsolę zarządzania.

  2. Przejdź do pozycji Serwery serwerów>aplikacji WebSphere Serwerów> aplikacji. Wybierz odpowiednie serwery aplikacji i wybierz pozycję Java i definicja>procesu zarządzania procesami>Java Virtual Machine.

  3. W Generic JVM argumentspliku dodaj następujący argument JVM.

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

  4. Zapisz i uruchom ponownie serwer aplikacji.

OpenLiberty 18

Utwórz nowy plik jvm.options w katalogu serwera (na przykład <openliberty>/usr/servers/defaultServer), a następnie dodaj następujący wiersz:

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

Inne

Zapoznaj się z dokumentacją serwera aplikacji, aby dowiedzieć się, jak dodać args JVM.