Конфігурація
На цій сторінці описано різні способи постачання конфігурації 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.
Відгук
Чи це було корисним?
Дякуємо. Ми цінуємо ваші відгуки!
Будь ласка, дайте нам знати як ми можемо покращити цю сторінку. Ми цінуємо ваші відгуки!