Skip to content

Latest commit

 

History

History
65 lines (45 loc) · 2.33 KB

File metadata and controls

65 lines (45 loc) · 2.33 KB

Supported technologies

OpenTelemetry PHP Distro is a distribution of OpenTelemetry PHP. It inherits OpenTelemetry compatibility and extends runtime features with native components.

Auto-instrumentation scope

Auto-instrumentation captures telemetry for supported frameworks and libraries, but it does not instrument:

  • proprietary or custom framework internals
  • closed-source components without instrumentation hooks
  • application-specific business logic

For unsupported areas, use manual OpenTelemetry instrumentation.

PHP versions

Supported PHP versions: 8.1 to 8.4.

Supported SAPIs

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

Supported operating systems

  • Linux
    • Architectures: x86_64, arm64
    • glibc-based systems: deb, rpm
    • musl-based systems (Alpine): apk

Instrumented frameworks

  • Laravel 6.x to 11.x
  • Slim 4.x

Instrumented libraries

  • cURL
  • HTTP async (php-http/httplug)
  • MySQLi
  • PDO
  • PostgreSQL

Included auto-instrumentation packages

Name Included from distro version Package
curl 1.0 open-telemetry/opentelemetry-auto-curl
http-async-client 1.0 open-telemetry/opentelemetry-auto-http-async
laravel 1.0 open-telemetry/opentelemetry-auto-laravel
mysqli 1.0 open-telemetry/opentelemetry-auto-mysqli
pdo 1.0 open-telemetry/opentelemetry-auto-pdo
postgresql 1.2 open-telemetry/opentelemetry-auto-postgresql
slim 1.0 open-telemetry/opentelemetry-auto-slim

Additional runtime features

  • Automatic root span creation
  • Root span URL grouping
  • Inferred spans
  • Background telemetry sending

Background sending (non-blocking export) works with OTLP http/protobuf (default). If exporter/protocol changes to unsupported transport (for example gRPC), export becomes synchronous.