Конфігурація
На цій сторінці описано різні способи постачання конфігурації Java-агенту. Інформацію про самі параметри конфігурації наведено у розділі Налаштування SDK.
Конфігурація агента
Агент може споживати конфігурацію з одного або кількох наступних джерел (впорядкованих від найвищого до найнижчого пріоритету):
- Системні властивості
- Змінні середовища
- Файл конфігурації
- Властивості, надані функцією
AutoConfigurationCustomizer#addPropertiesSupplier(); використовуючиAutoConfigurationCustomizerProviderSPI
Конфігурація за допомогою змінних середовища
У певних середовищах налаштуванню параметрів за допомогою змінних середовища часто надається перевага. Будь-який параметр, який можна налаштувати за допомогою системної властивості, також можна встановити за допомогою змінної оточення. Хоча багато з наведених нижче параметрів надають приклади для обох форматів, для тих, які цього не роблять, скористайтеся наведеними нижче кроками, щоб визначити правильне зіставлення назв для потрібної системної властивості:
- Перетворити назву системної властивості у верхній регістр.
- Замініть усі символи
.та-на_.
Наприклад, otel.instrumentation.common.default-enabled перетвориться на OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED.
Файл конфігурації
Ви можете надати шлях до файлу конфігурації агента, встановивши наступну властивість:
System property:
otel.javaagent.configuration-file
Environment variable:
OTEL_JAVAAGENT_CONFIGURATION_FILEDescription: Шлях до дійсного файлу властивостей Java, який містить конфігурацію агента.
Розширення
Ви можете увімкнути розширення за допомогою встановлення наступної властивості:
System property:
otel.javaagent.extensions
Environment variable:
OTEL_JAVAAGENT_EXTENSIONSDescription: Шлях до jar-файлу розширення або теки, що містить jar-файли. Якщо вказано теку, кожен jar-файл у цій теці буде розглядатися як окреме, незалежне розширення.
Вивід логів Java агента
Вивід журналів агента можна налаштувати, встановивши наступну властивість:
System property:
otel.javaagent.logging
Environment variable:
OTEL_JAVAAGENT_LOGGINGDescription: Режим ведення журналів Java агента. Підтримуються наступні 3 режими:
simple: Агент буде виводити свої журнали за допомогою стандартного потоку помилок. Будуть виводитися лише журнали рівняINFOабо вище. Це стандартний режим ведення журналів Java агента.none: Агент не буде нічого записувати в лог — навіть свою власну версію.application: Агент спробує перенаправити свої власні журнали до логера slf4j інструментованого застосунку. Це найкраще працює для простих застосунків з одним jar-файлом, які не використовують кілька завантажувачів класів; підтримуються також застосунки Spring Boot. Вивід журналів Java агента можна додатково налаштувати за допомогою конфігурації журналювання інструментованого застосунку (наприклад,logback.xmlабоlog4j2.xml). Переконайтеся, що цей режим працює для вашого застосунку перед запуском його в промисловому середовищі.
Конфігурація SDK
Модуль автоконфігурації SDK використовується для базової конфігурації агента. Прочитайте документацію, щоб знайти налаштування, такі як конфігурація експорту або вибірки.
На відміну від автоконфігурації SDK, версії 2.0+ Java агента та стартера OpenTelemetry Spring Boot використовують http/protobuf як стандартний протокол, а не grpc.
Увімкнення постачальників ресурсів, які стандартно вимкнені
На додачу до конфігурації ресурсів з автоконфігурації SDK, ви можете увімкнути додаткових постачальників ресурсів, які стандартно вимкнені:
System property:
otel.resource.providers.aws.enabled
Environment variable:
OTEL_RESOURCE_PROVIDERS_AWS_ENABLEDDefault: false
Description:
Увімкнення Постачальника ресурсів AWS.
System property:
otel.resource.providers.gcp.enabled
Environment variable:
OTEL_RESOURCE_PROVIDERS_GCP_ENABLEDDefault: false
Description:
Увімкнення Постачальника ресурсів GCP.
System property:
otel.resource.providers.azure.enabled
Environment variable:
OTEL_RESOURCE_PROVIDERS_AZURE_ENABLEDDefault: false
Description:
Увімкнення Постачальника ресурсів Azure.
Зворотний зв’язок
Чи була ця сторінка корисною?
Дякуємо. Ми цінуємо ваші відгуки!
Будь ласка, дайте нам знати як ми можемо покращити цю сторінку. Ми цінуємо ваші відгуки!