Начало работы (дополнение)
В следующих разделах вы узнаете, как получить автоинструментацию Java для конкретных технических сред.
Служба приложений Azure
Дополнительные сведения см. в разделе "Мониторинг приложений" для службы приложение Azure и Java.
Функции Azure
Дополнительные сведения см. в разделе Мониторинг решения "Функции Azure" с помощью Azure Monitor в Application Insights.
Azure Spring Apps
Дополнительные сведения см. в статье Использование внутрипроцессного агента Java Application Insights в Приложениях Azure Spring.
Контейнеры
Примечание.
С помощью приложений Spring Boot Native Image используйте проект приложения Java для OpenTelemetry OpenTelemetry в Spring Boot, а не агент Java Application Insights.
Точка входа Docker
Если используется форма exec, добавьте параметр -javaagent:"path/to/applicationinsights-agent-3.5.4.jar"
в список параметров — где-то перед параметром "-jar"
, например:
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.5.4.jar", "-jar", "<myapp.jar>"]
Если вы используете форму оболочки, добавьте arg -javaagent:"path/to/applicationinsights-agent-3.5.4.jar"
виртуальной машины Java (JVM) где-то раньше-jar
, например:
ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.5.4.jar" -jar <myapp.jar>
Файл Docker
Пример Dockerfile:
FROM ...
COPY target/*.jar app.jar
COPY agent/applicationinsights-agent-3.5.4.jar applicationinsights-agent-3.5.4.jar
COPY agent/applicationinsights.json applicationinsights.json
ENV APPLICATIONINSIGHTS_CONNECTION_STRING="CONNECTION-STRING"
ENTRYPOINT["java", "-javaagent:applicationinsights-agent-3.5.4.jar", "-jar", "app.jar"]
В этом примере вы копируете applicationinsights-agent-3.5.4.jar
файлы applicationinsights.json
из agent
папки (вы можете выбрать любую папку компьютера). Эти два файла должны находиться в одной папке в контейнере Docker.
Образы контейнеров партнеров
Если вы используете образ контейнера партнера, который нельзя изменить, подключите jar-файл агента Java Application Insights к контейнеру извне. Задайте переменную среды для контейнера JAVA_TOOL_OPTIONS=-javaagent:/path/to/applicationinsights-agent.jar
.
Spring Boot
Дополнительные сведения см. в статье Об использовании Azure Monitor Application Insights с Spring Boot.
Серверы приложений Java
Дополнительные сведения о настройке агента Java Application Insights см. в статье "Включение Azure Monitor OpenTelemetry для Java". В следующих разделах содержатся сведения, которые могут быть полезны при настройке -javaagent:...
arg JVM на разных серверах приложений.
Tomcat 8 (Linux)
Tomcat установлен через apt-get или yum
Если вы установили Tomcat через apt-get
или yum
у вас должен быть файл /etc/tomcat8/tomcat8.conf
. Добавьте следующую строку в конец этого файла:
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.5.4.jar"
Tomcat, установленный с помощью скачивания и распаковки
Если вы установили Tomcat через скачивание и распакуйте его https://tomcat.apache.org, у вас должен быть файл <tomcat>/bin/catalina.sh
. Создайте в том же каталоге новый файл с именем <tomcat>/bin/setenv.sh
, содержащий следующее:
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.5.4.jar"
Если файл <tomcat>/bin/setenv.sh
уже существует, измените этот файл и добавьте -javaagent:path/to/applicationinsights-agent-3.5.4.jar
его CATALINA_OPTS
.
Tomcat 8 (Windows)
Запуск Tomcat из командной строки
Найдите файл <tomcat>/bin/catalina.bat
. Создайте в том же каталоге новый файл с именем <tomcat>/bin/setenv.bat
, содержащий следующее:
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.5.4.jar
Кавычки не являются обязательными, но если вы хотите их включить, правильное расположение для них выглядит так:
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.5.4.jar"
Если файл <tomcat>/bin/setenv.bat
уже существует, измените этот файл и добавьте -javaagent:path/to/applicationinsights-agent-3.5.4.jar
его CATALINA_OPTS
.
Запуск Tomcat в качестве службы Windows
Найдите файл <tomcat>/bin/tomcat8w.exe
. Запустите этот исполняемый файл и добавьте -javaagent:path/to/applicationinsights-agent-3.5.4.jar
к Java Options
на вкладке Java
.
Платформа корпоративных приложений JBoss 7
В Red Hat JBoss Enterprise Application Platform (EAP) 7 можно настроить автономный сервер или доменный сервер.
Отдельный сервер
Добавьте -javaagent:path/to/applicationinsights-agent-3.5.4.jar
в существующую переменную среды JAVA_OPTS
в файле JBOSS_HOME/bin/standalone.conf
(Linux) или JBOSS_HOME/bin/standalone.conf.bat
(Windows):
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.5.4.jar -Xms1303m -Xmx1303m ..."
...
Сервер домена
Добавьте -javaagent:path/to/applicationinsights-agent-3.5.4.jar
к существующему параметру jvm-options
в 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.4.jar"/>
<option value="-XX:MetaspaceSize=96m"/>
<option value="-XX:MaxMetaspaceSize=256m"/>
</jvm-options>
</jvm>
</jvms>
...
Если вы используете несколько управляемых серверов на одном узле, необходимо добавить applicationinsights.agent.id
в system-properties
каждый из них 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>
...
Указанное значение applicationinsights.agent.id
должно быть уникальным. Значение используется для создания подкаталога в каталоге Application Insights. Для каждого процесса JVM требуется собственный локальный файл конфигурации Application Insights и локальный файл журнала Application Insights. Кроме того, если отчеты центральному сборщику, несколько управляемых серверов совместно applicationinsights.properties
используют файл, поэтому указанный applicationinsights.agent.id
параметр необходим для переопределения agent.id
параметра в этом общем файле. Можно applicationinsights.agent.rollup.id
также указать в сервере system-properties
, если необходимо переопределить agent.rollup.id
параметр на каждом управляемом сервере.
Jetty 9
Добавьте следующие строки в start.ini
:
--exec
-javaagent:path/to/applicationinsights-agent-3.5.4.jar
Payara 5
Добавьте -javaagent:path/to/applicationinsights-agent-3.5.4.jar
к существующему параметру jvm-options
в glassfish/domains/domain1/config/domain.xml
:
...
<java-config ...>
<!--Edit the JVM options here-->
<jvm-options>
-javaagent:path/to/applicationinsights-agent-3.5.4.jar>
</jvm-options>
...
</java-config>
...
WebSphere 8
Откройте консоль управления.
Перейдите на> серверы> серверов приложений WebSphere. Выберите соответствующие серверы приложений и выберите виртуальную машину Java и определения>процесса управления процессами>Java.
Добавьте
Generic JVM arguments
следующий аргумент JVM.-javaagent:path/to/applicationinsights-agent-3.5.4.jar
Сохраните и перезапустите сервер приложений.
OpenLiberty 18
Создайте файл jvm.options
в каталоге сервера (например, <openliberty>/usr/servers/defaultServer
и добавьте следующую строку:
-javaagent:path/to/applicationinsights-agent-3.5.4.jar
Другие
Дополнительные сведения о добавлении аргументов виртуальной машины Java приведены в документации по серверу приложений.