monitorhub / client
Reports exceptions and access logs from a Laravel app into the central MonitorHub app.
Requires
- php: ^7.2.5 || ^8.0
- illuminate/bus: >=7.0 <15.0
- illuminate/contracts: >=7.0 <15.0
- illuminate/http: >=7.0 <15.0
- illuminate/queue: >=7.0 <15.0
- illuminate/support: >=7.0 <15.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Composer package for sending reportable Laravel exceptions and HTTP access logs to a central MonitorHub installation. The package supports Laravel 7 through 14 and PHP 7.2.5 through PHP 8.x. It is registered through Laravel package discovery.
Install
Install the latest stable release from Packagist:
composer require monitorhub/client
Configure
Create a project in MonitorHub and add its generated settings to the consumer
application's .env:
MONITOR_URL=https://monitor.example.com MONITOR_PROJECT_KEY=generated-project-api-key MONITOR_ENABLED=true
Laravel discovers CsnMonitor\MonitorClientServiceProvider automatically. No
manual provider, exception handler, or middleware registration is required.
Publish the configuration only when the defaults need to be customized:
php artisan vendor:publish --tag=monitor-config
Queue
Exception and access-log payloads are queued so telemetry does not add latency to the monitored request. Run a queue worker in production:
php artisan queue:work
Use QUEUE_CONNECTION=sync only for local testing when no worker is running.
Captured Data
- Reportable exceptions, stack frames, request URL, method, and sanitized input
- Request IP, method, sanitized URL/input, response status/body, and duration
- Client-side timestamps with timezone offsets
Sensitive fields listed in monitor.except_fields are recursively redacted.
Binary responses are not captured, and text responses are truncated to the
configured maximum length.
Updating
composer update monitorhub/client