# Конфігурація

LLMS index: [llms.txt](/llms.txt)

---

> [!NOTE] Розʼяснення
>
> На цій сторінці описано різні способи постачання конфігурації Java-агенту. Інформацію про самі параметри конфігурації наведено у розділі [Налаштування SDK](/docs/languages/java/configuration).

## Конфігурація агента {#agent-configuration}

Агент може споживати конфігурацію з одного або кількох наступних джерел (впорядкованих від найвищого до найнижчого пріоритету):

- Системні властивості
- [Змінні середовища](#configuring-with-environment-variables)
- [Файл конфігурації](#configuration-file)
- Властивості, надані функцією [`AutoConfigurationCustomizer#addPropertiesSupplier()`](https://github.com/open-telemetry/opentelemetry-java/blob/f92e02e4caffab0d964c02a32fe305d6d6ba372e/sdk-extensions/autoconfigure-spi/src/main/java/io/opentelemetry/sdk/autoconfigure/spi/AutoConfigurationCustomizer.java#L73); використовуючи [`AutoConfigurationCustomizerProvider`](https://github.com/open-telemetry/opentelemetry-java/blob/main/sdk-extensions/autoconfigure-spi/src/main/java/io/opentelemetry/sdk/autoconfigure/spi/AutoConfigurationCustomizerProvider.java) SPI

## Конфігурація за допомогою змінних середовища {#configuring-with-environment-variables}

У певних середовищах налаштуванню параметрів за допомогою змінних середовища часто надається перевага. Будь-який параметр, який можна налаштувати за допомогою системної властивості, також можна встановити за допомогою змінної оточення. Хоча багато з наведених нижче параметрів надають приклади для обох форматів, для тих, які цього не роблять, скористайтеся наведеними нижче кроками, щоб визначити правильне зіставлення назв для потрібної системної властивості:

- Перетворити назву системної властивості у верхній регістр.
- Замініть усі символи `.` та `-` на `_`.

Наприклад, `otel.instrumentation.common.default-enabled` перетвориться на `OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED`.

## Файл конфігурації {#configuration-file}

Ви можете надати шлях до файлу конфігурації агента, встановивши наступну властивість:

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.javaagent.configuration-file</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_JAVAAGENT_CONFIGURATION_FILE</code>
</details>

<span class="label">Description</span>:
Шлях до дійсного файлу властивостей Java, який містить конфігурацію агента.
</div>


## Розширення {#extensions}

Ви можете увімкнути [розширення][] за допомогою встановлення наступної властивості:

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.javaagent.extensions</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_JAVAAGENT_EXTENSIONS</code>
</details>

<span class="label">Description</span>:
Шлях до jar-файлу розширення або теки, що містить jar-файли. Якщо вказано теку, кожен jar-файл у цій теці буде розглядатися як окреме, незалежне розширення.
</div>


## Вивід логів Java агента {#java-agent-logging-output}

Вивід журналів агента можна налаштувати, встановивши наступну властивість:

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.javaagent.logging</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_JAVAAGENT_LOGGING</code>
</details>

<span class="label">Description</span>:
Режим ведення журналів Java агента. Підтримуються наступні 3 режими:

- `simple`: Агент буде виводити свої журнали за допомогою стандартного потоку помилок. Будуть виводитися лише журнали рівня `INFO` або вище. Це стандартний режим ведення журналів Java агента.
- `none`: Агент не буде нічого записувати в лог — навіть свою власну версію.
- `application`: Агент спробує перенаправити свої власні журнали до логера slf4j інструментованого застосунку. Це найкраще працює для простих застосунків з одним jar-файлом, які не використовують кілька завантажувачів класів; підтримуються також застосунки Spring Boot. Вивід журналів Java агента можна додатково налаштувати за допомогою конфігурації журналювання інструментованого застосунку (наприклад, `logback.xml` або `log4j2.xml`). **Переконайтеся, що цей режим працює для вашого застосунку перед запуском його в промисловому середовищі.**
</div>


## Конфігурація SDK {#sdk-configuration}

Модуль автоконфігурації SDK використовується для базової конфігурації агента. Прочитайте [документацію](/docs/languages/java/configuration), щоб знайти налаштування, такі як конфігурація експорту або семплінгу.

> [!IMPORTANT]
>
> На відміну від автоконфігурації SDK, версії 2.0+ Java агента та стартера OpenTelemetry Spring Boot використовують `http/protobuf` як стандартний протокол, а не `grpc`.

## Увімкнення постачальників ресурсів, які стандартно вимкнені {#enable-resource-providers-that-are-disabled-by-default}

На додачу до конфігурації ресурсів з автоконфігурації SDK, ви можете увімкнути додаткових постачальників ресурсів, які стандартно вимкнені:

<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.resource.providers.aws.enabled</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_RESOURCE_PROVIDERS_AWS_ENABLED</code>
</details>

<span class="label">Default</span>: false<br>
<span class="label">Description</span>:
Увімкнення [Постачальника ресурсів AWS](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/aws-resources).
</div>


<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.resource.providers.gcp.enabled</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_RESOURCE_PROVIDERS_GCP_ENABLED</code>
</details>

<span class="label">Default</span>: false<br>
<span class="label">Description</span>:
Увімкнення [Постачальника ресурсів GCP](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/gcp-resources).
</div>


<div class="config-option">
<details>
  <summary title="Expand to view environment variable">
    <span class="label">System property</span>:
      <code>otel.resource.providers.azure.enabled</code>
  </summary>
  <span class="label">Environment variable</span>:
    <code>OTEL_RESOURCE_PROVIDERS_AZURE_ENABLED</code>
</details>

<span class="label">Default</span>: false<br>
<span class="label">Description</span>:
Увімкнення [Постачальника ресурсів Azure](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/azure-resources).
</div>


[розширення]: https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/examples/extension#readme