zaeem2396 / obeserva
Framework-aware observability for PHP (Datadog APM and optional OpenTelemetry)
Maintainers
Requires
- php: ^8.2
- illuminate/support: ^10.0|^11.0|^12.0|^13.0
- symfony/config: ^6.4|^7.0
- symfony/dependency-injection: ^6.4|^7.0
- symfony/event-dispatcher: ^6.4|^7.0
- symfony/http-kernel: ^6.4|^7.0
- symfony/messenger: ^6.4|^7.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.0
- illuminate/http: ^10.0|^11.0|^12.0|^13.0
- illuminate/queue: ^10.0|^11.0|^12.0|^13.0
- phpstan/phpstan: ^2.0
- phpunit/phpunit: ^10.0
Suggests
- datadog/php-tracer: For Datadog APM spans (or use the ddtrace extension)
This package is auto-updated.
Last update: 2026-05-01 15:08:55 UTC
README
Observa adds structured spans for Laravel and Symfony using the Datadog PHP tracer by default, or OpenTelemetry when you install open-telemetry/sdk and set OBSERVA_TRACER=opentelemetry (see docs/USAGE.md). Instrumentation covers HTTP traffic (Laravel web and api middleware groups), controllers, queue jobs / Messenger, events, listeners, middleware, and policy checks. Exceptions are tagged on the active span (error.type, error.message). Without a configured backend, instrumentation is a no-op and your app behaves normally.
Requirements: PHP 8.2+; Laravel 10–13 (Laravel 13 needs PHP 8.3+) or Symfony 6.4 / 7; Datadog (tracer + Agent) and/or OpenTelemetry (SDK + TracerProvider / OTLP) depending on observa.tracer.
Install
Laravel
composer require zaeem2396/obeserva php artisan observa:install
Symfony
composer require zaeem2396/obeserva
Register Observa\Symfony\ObservaBundle in config/bundles.php and set observa.enabled and other options in your bundle config.
Documentation
| Topic | Location |
|---|---|
| Configuration, Docker, production, optional features | docs/USAGE.md |
| Architecture and lifecycle (entry point, span flow) | docs/HOW-IT-WORKS.md |
| Changelog | CHANGELOG.md |
| Contributing & CI | docs/CONTRIBUTING.md |
| Packagist & releases | Packagist · docs/PACKAGIST.md |
License
Apache-2.0.