Конфігурація сервера застосунків

При інструментуванні застосунку, який працює на сервері застосунків Java з Java агентом, необхідно додати шлях javaagent до аргументів JVM. Спосіб зробити це відрізняється від сервера до сервера.

JBoss EAP / WildFly

Ви можете додати аргумент javaagent в кінці файлу конфігурації standalone:

• Linux
• Windows

# Додати до standalone.conf
JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"

rem Додати до standalone.conf.bat
set "JAVA_OPTS=%JAVA_OPTS% -javaagent:<Drive>:\path\to\opentelemetry-javaagent.jar"

Jetty

Щоб визначити шлях до Java агента, використовуйте аргумент -javaagent:

java -javaagent:/path/to/opentelemetry-javaagent.jar -jar start.jar

Якщо ви використовуєте файл jetty.sh для запуску Jetty, додайте наступний рядок до файлу \<jetty_home\>/bin/jetty.sh:

JAVA_OPTIONS="${JAVA_OPTIONS} -javaagent:/path/to/opentelemetry-javaagent.jar"

Якщо ви використовуєте файл start.ini для визначення аргументів JVM, додайте аргумент javaagent після опції --exec:

#===========================================================
# Приклад файлу Jetty start.ini
#-----------------------------------------------------------
--exec
-javaagent:/path/to/opentelemetry-javaagent.jar

Glassfish / Payara

Додайте шлях до Java агента за допомогою інструменту asadmin:

• Linux
• Windows

<server_install_dir>/bin/asadmin create-jvm-options "-javaagent\:/path/to/opentelemetry-javaagent.jar"

<server_install_dir>\bin\asadmin.bat create-jvm-options '-javaagent\:<Drive>\:\\path\\to\\opentelemetry-javaagent.jar'

Ви також можете додати аргумент -javaagent з консолі адміністратора. Наприклад:

1. Відкрийте консоль адміністратора GlassFish за адресою http://localhost:4848.
2. Перейдіть до Конфігурації > server-config > Налаштування JVM.
3. Виберіть Опції JVM > Додати опцію JVM.
4. Введіть шлях до агента: -javaagent:/path/to/opentelemetry-javaagent.jar
5. Збережіть і перезапустіть сервер.

Переконайтеся, що файл domain.xml у вашій теці домену містить запис <jmv-options> для агента.

Tomcat / TomEE

Додайте шлях до Java агента до вашого стартового скрипту. Спосіб налаштування залежить від вашої інсталяції:

Для встановлення за допомогою пакунків (apt-get/yum), додайте до /etc/tomcat*/tomcat*.conf:

JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"

Для встановлення через завантаження, створіть або змініть <tomcat>/bin/setenv.sh (Linux) або <tomcat>/bin/setenv.bat (Windows):

• Linux
• Windows

# Додати до <tomcat_home>/bin/setenv.sh
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/opentelemetry-javaagent.jar"

rem Додати до <tomcat_home>\bin\setenv.bat
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:"<Drive>:\path\to\opentelemetry-javaagent.jar"

Для встановлення служб Windows використовуйте <tomcat>/bin/tomcat*w.exe, щоб додати -javaagent:<Drive>:\path\to\opentelemetry-javaagent.jar до опцій Java на вкладці Java.

WebLogic

Додайте шлях до Java агента до вашого стартового скрипту домену:

• Linux
• Windows

# Додати до <domain_home>/bin/startWebLogic.sh
export JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/path/to/opentelemetry-javaagent.jar"

rem Додати до <domain_home>\bin\startWebLogic.cmd
set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:"<Drive>:\path\to\opentelemetry-javaagent.jar"

Для керованих екземплярів сервера додайте аргумент -javaagent за допомогою консолі адміністратора.

WebSphere Liberty Profile

Додайте шлях до Java агента до файлу jvm.options. Для одного сервера редагуйте ${server.config.dir}/jvm.options, а для всіх серверів редагуйте ${wlp.install.dir}/etc/jvm.options:

-javaagent:/path/to/opentelemetry-javaagent.jar

Перезапустіть сервер після збереження файлу.

WebSphere Traditional

Відкрийте консоль адміністратора WebSphere і виконайте наступні кроки:

1. Перейдіть до Сервери > Тип сервера > Сервери застосунків WebSphere.
2. Виберіть сервер.
3. Перейдіть до Управління Java та процесами > Визначення процесу.
4. Виберіть Віртуальна машина Java.
5. У Загальні аргументи JVM введіть шлях до агента: -javaagent:/path/to/opentelemetry-javaagent.jar.
6. Збережіть конфігурацію і перезапустіть сервер.

Увімкніть попередньо визначені метрики JMX

Java-агент містить попередньо визначені конфігурації метрик JMX для декількох популярних серверів застосунків, але вони є стандартно вимкненими. Щоб увімкнути збір попередньо визначених метрик, вкажіть список цілей як значення для системної властивості otel.jmx.target.system. Наприклад:

$ java -javaagent:path/to/opentelemetry-javaagent.jar \
     -Dotel.jmx.target.system=jetty,tomcat \
     ... \
     -jar myapp.jar

Нижче наведено відомі значення сервера застосунків для otel.jmx.target.system:

• jetty
• tomcat
• wildfly

Для списку метрик, отриманих з кожного сервера застосунків, виберіть попередню назву або зверніться до Додаткові деталі та можливості налаштування.