Налаштування OpenTelemetry PHP Distro

Дізнайтеся, як інструментувати ваш PHP-застосунок за допомогою OpenTelemetry PHP Distro і надсилати телеметрію на сумісний з OTLP бекенд.

Передумови

• Майте місце призначення для даних телеметрії (точку доступу OTLP).
• Використовуйте підтримуваний дистрибутив Linux та версію PHP.
• Не запускайте інший PHP APM або агент OpenTelemetry в тому самому процесі.

Інформацію про підтримувані операційні системи та версії PHP див. у розділі Підтримувані технології.

Обмеження

Відомі обмеження середовища виконання та сумісності описані в Обмеженнях.

Завантаження та встановлення пакунків

Завантажте пакунок для вашої платформи зі сторінки GitHub Releases і встановіть його.

RPM (RHEL/CentOS/Fedora)

sudo rpm -ivh <package-file>.rpm

DEB (Debian/Ubuntu)

sudo dpkg -i <package-file>.deb

APK (Alpine)

sudo apk add --allow-untrusted <package-file>.apk

Налаштування експортера

Як мінімум, встановіть:

• OTEL_EXPORTER_OTLP_ENDPOINT
• OTEL_EXPORTER_OTLP_HEADERS

Приклад:

export OTEL_EXPORTER_OTLP_ENDPOINT="https://your-otlp-endpoint:443/"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer <token>"

Перезапуск PHP-процесів

Після встановлення та налаштування перезапустіть PHP-процеси (наприклад php-fpm, Apache workers або PHP-сервери, що працюють без перерви), щоб розширення завантажилося.

Підтвердження телеметрії

1. Відкрийте ваш бекенд спостережуваності.
2. Знайдіть ваш сервіс у трейсах.
3. Згенеруйте трафік, якщо трейси ще не видимі.

Усунення несправностей

• Перевірте опції конфігурації в Конфігурація.
• Перевірте відомі обмеження в Обмеження.
• Якщо використовуєте Laravel Octane (Swoole або RoadRunner), див. PHP-сервери, що працюють без перерви.