Інструментування Python без коду

Автоматичне інструментування з Python використовує агент Python, який можна підʼєднати до будь-якого застосунку Python. Цей агент в основному використовує monkey patching, щоб змінювати функції бібліотек під час виконання, дозволяючи захоплювати телеметричні дані з багатьох популярних бібліотек та фреймворків.

Налаштування

Виконайте наступні команди, щоб встановити відповідні пакунки.

pip install opentelemetry-distro opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install

Пакунок opentelemetry-distro встановлює API, SDK та інструменти opentelemetry-bootstrap та opentelemetry-instrument.

Команда opentelemetry-bootstrap -a install переглядає список пакунків, встановлених у вашій активній теці site-packages, і встановлює відповідні бібліотеки інструментування для цих пакунків, якщо це можливо. Наприклад, якщо ви вже встановили пакунок flask, виконання opentelemetry-bootstrap -a install встановить opentelemetry-instrumentation-flask для вас. Агент OpenTelemetry Python використовуватиме monkey patching для зміни функцій у цих бібліотеках під час виконання.

Виконання opentelemetry-bootstrap без аргументів виводить список рекомендованих бібліотек інструментування для встановлення. Для отримання додаткової інформації дивіться opentelemetry-bootstrap.

Налаштування агента

Агент має широкі можливості для налаштування.

Один з варіантів — налаштувати агента за допомогою властивостей конфігурації з CLI:

opentelemetry-instrument \
    --traces_exporter console,otlp \
    --metrics_exporter console \
    --service_name your-service-name \
    --exporter_otlp_endpoint 0.0.0.0:4317 \
    python myapp.py

Альтернативно, ви можете використовувати змінні середовища для налаштування агента:

OTEL_SERVICE_NAME=your-service-name \
OTEL_TRACES_EXPORTER=console,otlp \
OTEL_METRICS_EXPORTER=console \
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=0.0.0.0:4317
opentelemetry-instrument \
    python myapp.py

Щоб побачити повний спектр параметрів конфігурації, дивіться Налаштування агента.

Підтримувані бібліотеки та фреймворки

Автоматично інструментуються ряд популярних бібліотек Python, включаючи Flask та Django. Для повного списку дивіться Реєстр.

Розвʼязання проблем

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