PHP

Специфічна для мови реалізація OpenTelemetry для PHP.

Ласкаво просимо до документації OpenTelemetry для PHP. У цьому розділі описано, як використовувати OpenTelemetry з PHP для генерації та збору телеметричних даних, таких як метрики, журнали та трасування, за допомогою API та SDK OpenTelemetry. Ці сторінки призначені для того, щоб допомогти вам розпочати роботу та зрозуміти поточні можливості та стан OpenTelemetry для PHP.

Статус та випуски

Поточний стан основних функціональних компонентів OpenTelemetry PHP наступний:

Випуски, зокрема останній випуск, див. у розділі Випуски.

Додатково

• OpenTelemetry для PHP на GitHub
• Приклади

Вимоги

OpenTelemetry SDK для PHP прагне підтримувати всі офіційно підтримувані версії PHP відповідно до www.php.net/supported-versions, і підтримка буде припинена для версій PHP протягом 12 місяців після завершення терміну їх підтримки.

Автоінструментування вимагає версію PHP 8.0+.

Залежності

Деякі пакунки SDK та Contrib мають залежність від HTTP Factories (PSR-17) та php-http/async-client. Ви можете знайти відповідні пакети composer, що реалізують дані стандарти, на packagist.org.

Дивіться http-factory-implementations, щоб знайти реалізацію PSR-17 (HTTP factories), та async-client-implementations, щоб знайти реалізацію php-http/async-client.

Необовʼязкові розширення PHP

ext-ffi

Підтримка fiber може бути увімкнена шляхом встановлення змінної середовища OTEL_PHP_FIBERS_ENABLED до true. Використання fiber з не-CLI SAPIs може вимагати попереднього завантаження звʼязків. Один зі способів досягти цього — встановити ffi.preload до src/Context/fiber/zend_observer_fiber.h та встановити opcache.preload до vendor/autoload.php.

ext-protobuf

Нативна бібліотека protobuf є значно повільнішою, ніж розширення. Ми настійно рекомендуємо використовувати розширення.

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

OpenTelemetry для PHP розповсюджується через packagist, у ряді пакунків. Ми рекомендуємо встановлювати лише ті пакунки, які вам потрібні, що зазвичай мінімально включає API, Context, SDK та експортер.

Ми наполегливо рекомендуємо, щоб ваш код залежав лише від класів та інтерфейсів у пакунку API.