Підтримувані технології

Підтримувані версії PHP, SAPI, операційні системи, фреймворки та бібліотеки для OpenTelemetry PHP Distro.

OpenTelemetry PHP Distro є дистрибутивом OpenTelemetry PHP. Він наслідує сумісність OpenTelemetry та розширює runtime-функції нативними компонентами.

Обсяг автоінструментування

Автоінструментування захоплює телеметрію для підтримуваних фреймворків та бібліотек, але не інструментує:

  • Внутрішності пропрієтарних або власних фреймворків
  • Компоненти з закритим кодом без hook-ів інструментування
  • Бізнес-логіку, специфічну для застосунку

Для непідтримуваних областей використовуйте ручне OpenTelemetry інструментування.

Версії PHP

Підтримувані версії PHP: 8.1 до 8.5.

Підтримувані SAPI

  • php-cli
  • php-fpm
  • php-cgi/fcgi
  • mod_php (prefork)

Підтримувані операційні системи

  • Linux
    • Архітектури: x86_64, arm64
    • системи на базі glibc: deb, rpm
    • системи на базі musl (Alpine): apk

Інструментовані фреймворки

  • Laravel 6.x до 13.x
  • Slim 4.x

Інструментовані бібліотеки

  • cURL
  • HTTP async (php-http/httplug)
  • MySQLi
  • PDO
  • PostgreSQL
  • PSR-18 HTTP Client (psr/http-client)

Включені пакети автоінструментування

НазваВключено з версії distroПакунок
curl1.0open-telemetry/opentelemetry-auto-curl
http-async-client1.0open-telemetry/opentelemetry-auto-http-async
laravel1.0open-telemetry/opentelemetry-auto-laravel
mysqli1.0open-telemetry/opentelemetry-auto-mysqli
pdo1.0open-telemetry/opentelemetry-auto-pdo
postgresql1.2open-telemetry/opentelemetry-auto-postgresql
psr180.5open-telemetry/opentelemetry-auto-psr18
slim1.0open-telemetry/opentelemetry-auto-slim

Включені пакунки метрик

Включені з версії distroПакунокЕмітовані метрики
0.6.0open-telemetry/opentelemetry-metrics-runtimeВикористання PHP пам’яті, GC цикли, пікове використання пам’яті

Додаткові runtime-функції

  • Автоматичне створення кореневого відрізка
  • Групування URL кореневого відрізка
  • Виведені відрізки
  • Інструментування на основі атрибутів (#[WithSpan], #[SpanAttribute])
  • Фонове надсилання телеметрії
  • PHP runtime метрики (пам’ять, GC — експортуються автоматично через нативний асинхронний транспорт)

Фонове надсилання (експорт без блокування) працює з OTLP http/protobuf (стандартно). Якщо експортер або протокол змінено на непідтримуваний транспорт (наприклад gRPC), експорт стає синхронним.


Востаннє змінено July 12, 2026: [uk] Ukrainian documentation for OpenTelemetry (83a19542)