PHPackages cosmos-observe/laravel-monitor - 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. cosmos-observe/laravel-monitor ActiveLibrary[Logging & Monitoring](/categories/logging) cosmos-observe/laravel-monitor ============================== Production-safe Redis-first monitoring APIs for Laravel applications. v1.0.3(today)12↑2900%[2 PRs](https://github.com/cosmos-observe/laravel-cosmos/pulls)MITPHPPHP ^8.2CI passing Since Jun 19Pushed today1 watchersCompare [ Source](https://github.com/cosmos-observe/laravel-cosmos)[ Packagist](https://packagist.org/packages/cosmos-observe/laravel-monitor)[ RSS](/packages/cosmos-observe-laravel-monitor/feed)WikiDiscussions main Synced today READMEChangelog (2)Dependencies (12)Versions (7)Used By (0) [![Laravel Cosmos logo](docs/assets/laravel-cosmos-logo.png)](docs/assets/laravel-cosmos-logo.png) Cosmos Laravel Monitor ====================== [](#cosmos-laravel-monitor) Production-safe, Redis-first monitoring APIs for Laravel `10`, `11`, `12`, and `13`. Cosmos Monitor gives you Telescope-style operational visibility without shipping a Blade UI and without storing high-volume telemetry in SQL. Recent telemetry lives in Redis with bounded payloads, secondary indexes, rollups, cursor pagination, sampling, redaction, compression, fail-open writes, and scheduled pruning. Durable low-volume settings and exception workflow state live in the host application's database. The official package and dashboard logo is the Laravel Cosmos heartbeat mark shown above. What It Captures ---------------- [](#what-it-captures) - HTTP RPS, status counts, latency, slow requests, and performance events. - Queue depth, processed/failed job counts, job runtime, failed-job summaries, and oldest pending age where the host queue driver supports it. - Sanitized Monolog records through an opt-in Laravel log tap. - Sanitized exceptions with bounded stack traces and stable grouping hashes. - Scheduler start, finish, failure, missed, skipped, and heartbeat telemetry. - Database query latency, slow queries, SQL hashes, and aggregate rollups. - Cache hit, miss, write, and forget events where Laravel emits cache events. - Runtime health: app identity, PHP/Laravel/package versions, Redis ping, DB ping latency, queue config, and memory peak. Install ------- [](#install) ``` composer require cosmos-observe/laravel-monitor php artisan vendor:publish --tag=cosmos-monitor-config php artisan vendor:publish --tag=cosmos-monitor-migrations php artisan migrate ``` If your PHP runtime does not have `ext-redis`, install Predis in the host app: ``` composer require predis/predis ``` Minimal Configuration --------------------- [](#minimal-configuration) ``` COSMOS_MONITOR_ENABLED=true COSMOS_MONITOR_REDIS_CONNECTION=default COSMOS_MONITOR_REDIS_PREFIX=cosmos-monitor COSMOS_MONITOR_ROUTE_PREFIX=api/cosmos-monitor/v1 COSMOS_MONITOR_MIDDLEWARE=api,auth:sanctum COSMOS_MONITOR_API_TOKEN= COSMOS_MONITOR_APP_ID="${APP_NAME}" COSMOS_MONITOR_ENVIRONMENT="${APP_ENV}" COSMOS_MONITOR_RAW_RETENTION_SECONDS=604800 COSMOS_MONITOR_ROLLUP_RETENTION_SECONDS=2592000 ``` Default base path: ``` /api/cosmos-monitor/v1 ``` All responses use a stable API envelope: ``` { "data": {}, "meta": {}, "links": {} } ``` Security Model -------------- [](#security-model) Use your Laravel app middleware as the primary protection layer: ``` 'middleware' => ['api', 'auth:sanctum'], ``` For dashboards, service-to-service calls, or staging E2E apps, you can also set: ``` COSMOS_MONITOR_API_TOKEN=super-secret-token ``` When the token is set, requests must include: ``` Authorization: Bearer super-secret-token ``` Scheduler --------- [](#scheduler) Register these commands in your host app scheduler: ``` $schedule->command('cosmos-monitor:sample-queues')->everyMinute(); $schedule->command('cosmos-monitor:prune')->hourly(); ``` `sample-queues` records queue depth, failed job count, and oldest pending age where supported. `prune` deletes old raw payloads, sorted sets, secondary indexes, and rollup keys in batches. Log Capture ----------- [](#log-capture) Add the tap to any logging channel you want monitored: ``` 'single' => [ 'driver' => 'single', 'path' => storage_path('logs/laravel.log'), 'level' => env('LOG_LEVEL', 'debug'), 'tap' => [ Cosmos\LaravelMonitor\Logging\CosmosMonitorTap::class, ], ], ``` Only levels configured in `cosmos-monitor.logs.levels` are written to Redis. Sensitive keys such as `authorization`, `cookie`, `password`, `token`, `api_key`, and `secret` are redacted. Heavy Data Controls ------------------- [](#heavy-data-controls) The package is designed for production load: ``` 'limits' => [ 'max_payload_bytes' => 8192, 'max_page_size' => 100, 'max_raw_events_per_stream' => 250000, 'query_batch_size' => 250, 'max_filter_scan_size' => 5000, 'prune_batch_size' => 1000, 'max_timeseries_points' => 720, ], 'storage' => [ 'write_fail_open' => true, 'payload_compression' => false, 'index_fields' => ['level', 'status', 'queue', 'job', 'route', 'method', 'hash', 'event', 'connection', 'category'], ], ``` Use cursor pagination for high-volume list screens: ``` GET /requests?method=GET&per_page=50&scan_limit=500&cursor=1781825582602 ``` The response includes: ``` { "meta": { "next_cursor": "1781825581999", "has_more": true, "scan_limit": 500, "indexed": true } } ``` API Catalog ----------- [](#api-catalog) - `GET /health` - `GET /metrics/summary` - `GET /metrics/timeseries` - `GET /requests` - `GET /queues` - `GET /queues/{queue}/jobs` - `GET /logs` - `GET /exceptions` - `PUT /exceptions/{hash}/status` - `GET /schedules` - `GET /database/latency` - `GET /performance` - `GET /cache` - `GET /settings` - `PUT /settings` - `POST /notifications/test` - `POST /diagnostics/logs/test` - `POST /diagnostics/exceptions/test` - `POST /diagnostics/database/test-query` Diagnostic endpoints are blocked unless: ``` COSMOS_MONITOR_ACTIONS_ENABLED=true ``` Dashboard Integration --------------------- [](#dashboard-integration) The companion dashboard can run in mock, hybrid, or live mode: ``` DASHBOARD_MODE=live LARAVEL_MONITOR_BASE_URL=http://127.0.0.1:8012/api/cosmos-monitor/v1 LARAVEL_MONITOR_API_TOKEN=e2e-secret-token ``` The dashboard proxy maps package envelopes into the existing dashboard data shape and keeps mock mode available for demos. Redis Sizing Notes ------------------ [](#redis-sizing-notes) Sizing depends on event rate, payload size, indexed fields, and retention. A practical first pass: - Keep raw retention short enough for active operations: `1d-7d`. - Keep rollups longer: `14d-90d`. - Turn on sampling for very high RPS apps. - Keep `max_payload_bytes` low and rely on hashes/traces for drill-down. - Prefer cursor pagination and indexed filters over deep page numbers. - Run `cosmos-monitor:prune` on a schedule and watch the `monitor` stream for prune stats or storage failures. CI/CD ----- [](#cicd) GitHub Actions runs Composer validation, PHP linting, and PHPUnit on pushes and pull requests. Release tags matching `v*` run the release workflow, create or update a GitHub Release, and can notify Packagist when these repository secrets are configured: ``` PACKAGIST_USERNAME PACKAGIST_TOKEN ``` Create releases with semantic version tags: ``` git tag v1.0.2 git push origin v1.0.2 ``` E2E Test Host ------------- [](#e2e-test-host) This repository was validated against a separate Laravel 12 app with SQLite app data and local Redis telemetry, and its Composer constraints support Laravel 13 applications: ``` /Users/mohammad/Documents/laravel-cosmos-monitor-e2e ``` The E2E app installs this package through a Composer path repository, uses Predis, triggers real HTTP, DB, cache, log, exception, queue, schedule, settings, diagnostics, notification, heavy-data, cursor, and pruning scenarios, and includes a command for 100k mixed telemetry events: ``` php artisan cosmos-e2e:seed-heavy --count=100000 ``` Documentation ------------- [](#documentation) - Full API guide: `docs/api.md` - OpenAPI spec: `docs/openapi.yaml` ### Health Score 42 — FairBetter than 89% of packages Maintenance100 Actively maintained with recent releases Popularity5 Limited adoption so far Community4 Small or concentrated contributor base Maturity50 Maturing project, gaining track record 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 ~0 days Total 4 Last Release 0d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/76784222?v=4)[csbaymohammadi](/maintainers/csbaymohammadi)[@csbaymohammadi](https://github.com/csbaymohammadi) ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/cosmos-observe-laravel-monitor/health.svg) ``` [![Health](https://phpackages.com/badges/cosmos-observe-laravel-monitor/health.svg)](https://phpackages.com/packages/cosmos-observe-laravel-monitor) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3325.1M337](/packages/psalm-plugin-laravel)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k14.1M122](/packages/laravel-pulse)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9732.3M121](/packages/roots-acorn)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 76518.2M115](/packages/laravel-mcp)[pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 45344.0k1](/packages/pressbooks-pressbooks)[flarum/core Delightfully simple forum software. 201.4M2.2k](/packages/flarum-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)