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 & Monitoring](/categories/logging) 4. / 5. pepperfm/dozor-agent ActiveLibrary[Logging & Monitoring](/categories/logging) pepperfm/dozor-agent ==================== Self-hostable Laravel instrumentation and local agent starter inspired by laravel/nightwatch. 0.0.10(1mo ago)0125↓76%MITPHPPHP ^8.4 Since Mar 3Pushed 1mo 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 1mo ago 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 43 — FairBetter than 90% of packages Maintenance95 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 55d 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)