PHPackages                             pepperfm/dozor-agent - 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 &amp; Monitoring](/categories/logging)
4. /
5. pepperfm/dozor-agent

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

pepperfm/dozor-agent
====================

Self-hostable Laravel instrumentation and local agent starter inspired by laravel/nightwatch.

0.0.10(1w ago)0125↓76%MITPHPPHP ^8.4

Since Mar 3Pushed 1w agoCompare

[ Source](https://github.com/pepperfm/dozor-agent)[ Packagist](https://packagist.org/packages/pepperfm/dozor-agent)[ Docs](https://example.com/dozor)[ RSS](/packages/pepperfm-dozor-agent/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (11)Used By (0)

Dozor Agent Starter
===================

[](#dozor-agent-starter)

A self-hostable Laravel instrumentation and local agent starter, adapted from the public `laravel/nightwatch` package architecture and transport ideas, but renamed and reshaped for **Dozor**.

What this bundle gives you
--------------------------

[](#what-this-bundle-gives-you)

- Laravel package with `dozor:agent` and `dozor:status` commands
- local TCP ingest client/server using a framed payload protocol
- request tracing middleware
- query, queue, and exception watchers
- newline-delimited JSON storage for ingested records
- configuration already renamed from `NIGHTWATCH_*` to `DOZOR_*`

What this is not
----------------

[](#what-this-is-not)

- not a drop-in clone of the hosted Nightwatch backend
- not a full production-ready APM yet
- not a fork that keeps Laravel/Nightwatch branding

It is a **good self-hosted starter**: clean enough to keep, small enough to reshape.

Install
-------

[](#install)

```
composer require pepperfm/dozor-agent
php artisan vendor:publish --tag=dozor-config
```

### Local package smoke install (path repository)

[](#local-package-smoke-install-path-repository)

```
{
  "repositories": [
    {
      "type": "path",
      "url": "../dozor-agent",
      "options": {
        "symlink": true
      }
    }
  ]
}
```

```
composer require pepperfm/dozor-agent:*
php artisan list | grep dozor:
php artisan vendor:publish --tag=dozor-config
```

Install is safe even if the local worker is not running yet. The package does not break `composer install`, deploy hooks, or `package:discover` when `127.0.0.1:4815` is unavailable. You can install first and start the worker later.

Typical env
-----------

[](#typical-env)

```
DOZOR_ENABLED=true
DOZOR_TOKEN=change-me
DOZOR_APP_NAME="My App"
DOZOR_ENV=production
DOZOR_SERVER=app-1
DOZOR_INGEST_URI=127.0.0.1:4815
DOZOR_INGEST_EVENT_BUFFER=500
DOZOR_REQUEST_SAMPLE_RATE=1.0
DOZOR_IGNORE_QUERIES=false
DOZOR_AGENT_STORE_PATH=/var/www/app/storage/app/dozor
DOZOR_AGENT_SHIP_FLUSH_INTERVAL_SECONDS=10
```

Run local agent
---------------

[](#run-local-agent)

```
php artisan dozor:agent
```

Useful options:

```
php artisan dozor:agent --listen-on=127.0.0.1:4815 --store-path=/var/www/app/storage/app/dozor
php artisan dozor:agent --ship-flush-interval-seconds=10
php artisan dozor:status
php artisan dozor:status --json
php artisan dozor:status --strict
```

`dozor:status --strict` is opt-in diagnostics and may fail when the local worker is down. Regular runtime instrumentation stays non-fatal and keeps buffered retry behavior.

Runtime telemetry and status
----------------------------

[](#runtime-telemetry-and-status)

`dozor:status` now reports:

- local agent reachability (`ping`)
- queue depth and failed queue depth
- dropped batches and failed upload counters
- last flush / heartbeat / upload timestamps

Shipping strategy is strict batching by default and cannot be toggled via config flags.

Telemetry state is persisted to:

```
DOZOR_AGENT_STATE_PATH=/var/www/app/storage/app/dozor/runtime-state.json
```

Production packaging examples
-----------------------------

[](#production-packaging-examples)

Example service files are available in:

- `examples/supervisor/dozor-agent.conf.example`
- `examples/systemd/dozor-agent.service.example`

Current record model
--------------------

[](#current-record-model)

The package emits records like:

- `request`
- `query`
- `job`
- `exception`
- `custom`

Each record includes a `trace_id`, timestamps, app/environment/server metadata, and a `payload` block.

Files worth editing first
-------------------------

[](#files-worth-editing-first)

- `src/DozorServiceProvider.php`
- `src/Core.php`
- `src/Http/Middleware/TraceRequest.php`
- `src/Agent/Server.php`
- `config/dozor.php`

Suggested next steps
--------------------

[](#suggested-next-steps)

1. swap NDJSON file storage for ClickHouse / Postgres / Kafka / Redis Streams
2. add outgoing HTTP instrumentation
3. add trace/span hierarchy instead of flat child records
4. add metric rollups (minute buckets, P95/P99)
5. correlate deployments/releases

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance98

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Every ~1 days

Total

10

Last Release

8d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/87b33c1f84ded521a768afdbd204f1a1c2cd7519477a2f8bdb2e8b7cba030d09?d=identicon)[PepperFM](/maintainers/PepperFM)

---

Top Contributors

[![pepperfm](https://avatars.githubusercontent.com/u/36007880?v=4)](https://github.com/pepperfm "pepperfm (20 commits)")

---

Tags

laravelmonitoringapmobservabilityDoZoR

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pepperfm-dozor-agent/health.svg)

```
[![Health](https://phpackages.com/badges/pepperfm-dozor-agent/health.svg)](https://phpackages.com/packages/pepperfm-dozor-agent)
```

###  Alternatives

[tobiasdierich/gauge

An easy to use application performance monitor.

14413.1k](/packages/tobiasdierich-gauge)

PHPackages © 2026

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