PHPackages                             observa/obeserva - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. observa/obeserva

ActiveProject[Logging & Monitoring](/categories/logging)

observa/obeserva
================

Framework-aware observability layer for PHP on Datadog APM

v1.0.0(3mo ago)00Apache-2.0PHPPHP ^8.2CI passing

Since Mar 12Pushed 1mo agoCompare

[ Source](https://github.com/zaeem2396/obeserva)[ Packagist](https://packagist.org/packages/observa/obeserva)[ RSS](/packages/observa-obeserva/feed)WikiDiscussions main Synced 3mo ago

READMEChangelog (2)Dependencies (11)Versions (3)Used By (0)

Observa
=======

[](#observa)

[![Test](https://github.com/zaeem2396/obeserva/actions/workflows/test.yml/badge.svg)](https://github.com/zaeem2396/obeserva/actions/workflows/test.yml) [![PHP](https://camo.githubusercontent.com/819a0dc44ab0c3e57bea736ea17648599900768d96385fc063fdb6cd7a689ee0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e32253230253743253230382e33253230253743253230382e34253230253743253230382e352d3737374242343f6c6f676f3d706870)](https://www.php.net/) [![License](https://camo.githubusercontent.com/b29de0acdfd19013f1f02689b15c933e4a6c145be9efa718288f88ba3280b1c5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d417061636865253230322e302d626c75652e737667)](LICENSE)

**Observa** adds structured spans for **Laravel** and **Symfony** using the [Datadog PHP tracer](https://docs.datadoghq.com/tracing/trace_collection/dd_libraries/php/) by default, or **OpenTelemetry** when you install `open-telemetry/sdk` and set `OBSERVA_TRACER=opentelemetry` (see [docs/USAGE.md](docs/USAGE.md#opentelemetry-backend-optional)). 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
-------

[](#install)

### Laravel

[](#laravel)

```
composer require zaeem2396/obeserva
php artisan observa:install
```

### Symfony

[](#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
-------------

[](#documentation)

TopicLocationConfiguration, Docker, production, optional features[docs/USAGE.md](docs/USAGE.md)Architecture and lifecycle (entry point, span flow)[docs/HOW-IT-WORKS.md](docs/HOW-IT-WORKS.md)Changelog[CHANGELOG.md](CHANGELOG.md)Contributing & CI[docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)Packagist & releases[Packagist](https://packagist.org/packages/zaeem2396/obeserva) · [docs/PACKAGIST.md](docs/PACKAGIST.md)License
-------

[](#license)

Apache-2.0.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance86

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

102d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/31367343?v=4)[Zaeem Ansari](/maintainers/zaeem2396)[@zaeem2396](https://github.com/zaeem2396)

---

Top Contributors

[![zaeem2396](https://avatars.githubusercontent.com/u/31367343?v=4)](https://github.com/zaeem2396 "zaeem2396 (508 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/observa-obeserva/health.svg)

```
[![Health](https://phpackages.com/badges/observa-obeserva/health.svg)](https://phpackages.com/packages/observa-obeserva)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)