IKuznetsov: Новая страница: «В этом пошаговом руководстве показано, как добавить наблюдаемость в ваше приложение '''Pyt...»

2025-10-09T18:49:19Z

Новая страница: «В этом пошаговом руководстве показано, как добавить наблюдаемость в ваше приложение '''Pyt...»

Новая страница

В этом пошаговом руководстве показано, как добавить наблюдаемость в ваше приложение '''Python''' с помощью автоматического инструментария для '''OpenTelemetry''' '''Python'''.
{| class="wikitable"
|<u>Расширение с помощью ЕдиногоАгента</u>

В настоящее время невозможно автоматически дополнять сервисы информацией, относящейся к хосту. Для этого потребуется перейти на ручное инструментирование.
|}

== Получите данные для доступа к Ключ-АСТРОМ ==

=== Определение базового URL API ===
Подробную информацию о сборке базового '''URL-адреса''' конечной точки '''OTLP''' см. в разделе [[Экспорт с помощью OTLP]]. URL-адрес должен заканчиваться на <code>/api/v2/otlp</code>.

=== Получение токена доступа API ===
Токен доступа для сбора трассировок, логов и метрик можно создать в разделе [[Токен доступа|Токены доступа]].

Экспорт с помощью '''OTLP''' содержит более подробную информацию о формате и необходимых областях доступа.

== Инструментирование своего приложения ==
В следующем примере показано, как автоматически настроить все доступные и применимые библиотеки инструментирования <code>opentelemetry-distro</code>. Вместо этого вы можете пропустить шаги '''1 и 2''' и выборочно добавить [https://github.com/open-telemetry/opentelemetry-python-contrib/blob/main/instrumentation/README.md библиотеки] инструментирования <code>[https://pypi.org/project/opentelemetry-instrumentation/ opentelemetry-instrumentation]</code>, установив их вручную.

1. Используйте [https://pypi.org/project/pip/ pip] для установки следующих пакетов.
{| class="wikitable"
|pip install opentelemetry-distro

pip install opentelemetry-exporter-otlp
|}
2. Выполните следующую команду для инициализации и начальной загрузки автоматического инструментария.
{| class="wikitable"
|opentelemetry-bootstrap -a install
|}
3. Настройте следующие переменные среды, чтобы задать сведения о службе и экспорте, заменив <code>[URL]</code> и <code>[TOKEN]</code> значениями для базового '''URL-адреса''' и токена доступа .
{| class="wikitable"
|OTEL_EXPORTER_OTLP_ENDPOINT=[URL]

OTEL_EXPORTER_OTLP_HEADERS="Authorization=Api-Token%20[TOKEN]"

OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta

OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

OTEL_SERVICE_NAME="python-quickstart"
|}
''<u>URL-кодирование в переменных среды</u>''

Обратите внимание, что пробел кодируется так, как если бы переменная следовала [https://opentelemetry.io/docs/specs/otel/protocol/exporter/#specifying-headers-via-environment-variables соглашению о контексте корреляции] <code>OTEL_EXPORTER_OTLP_HEADERS</code>, а ее значение должно быть [https://github.com/w3c/baggage/blob/main/baggage/HTTP_HEADER_FORMAT.md#value кодировано процентами] <code>%20</code>.

4. Запустите приложение <code>opentelemetry-instrument</code> с помощью агента.
{| class="wikitable"
|opentelemetry-instrument python myapp.py
|}

== Добавление телеметрических сигналов вручную (необязательно) ==
Поскольку автоматическое инструментирование на '''Python''' не предоставляет предварительно настроенных поставщиков трассировщиков и измерителей, вам необходимо будет выполнить шаги инициализации и инструментирования , описанные в разделе '''Ручное''' инструментирование вашего приложения '''Python''' с помощью '''OpenTelemetry''', если вы хотите вручную добавлять пользовательские сигналы (такие как трассировки и метрики) поверх автоматического инструментирования.

== Обеспечение распространения контекста ==
Распространение контекста особенно важно, когда задействованы сетевые вызовы (например, '''REST''').

При автоматическом инструментировании это должно быть автоматически реализовано библиотеками инструментирования. Если используемые сетевые библиотеки не покрываются этим инструментированием, вам придётся перейти на ручное инструментирование и управлять распространением вручную.

== Настройка сбора данных в соответствии с требованиями конфиденциальности (необязательно) ==
Хотя Ключ-АСТРОМ автоматически собирает все атрибуты '''OpenTelemetry''', в веб-интерфейсе Ключ-АСТРОМ сохраняются и отображаются только значения атрибутов, указанные в списке разрешенных. Это предотвращает случайное сохранение персональных данных, позволяя вам соблюдать требования к конфиденциальности и контролировать объем хранимых данных мониторинга.

Чтобы просматривать пользовательские атрибуты, необходимо сначала разрешить их использование в веб-интерфейсе Ключ-АСТРОМ.

== Проверка загрузки данных в Ключ-АСТРОМ ==
После завершения инструментирования вашего приложения выполните несколько тестовых действий для создания и отправки демонстрационных трассировок, метрик и логов, а также проверьте, что они были правильно загружены в Ключ-АСТРОМ.

Чтобы сделать это для трассировок, перейдите в раздел '''Трассировки''' и выберите вкладку '''Распределенные трассировки'''. Если вы используете ЕдиныйАгент, выберите '''PurePaths''' .

Для просмотра метрик и логов перейдите в раздел '''Метрики''' или '''Логов''' или '''Логи и события'''.

Автоматическое внедрение OpenTelemetry в Python-приложение - История изменений

IKuznetsov: Новая страница: «В этом пошаговом руководстве показано, как добавить наблюдаемость в ваше приложение '''Pyt...»