visualbox / sentinel
Official Laravel agent for Sentinel. Batched telemetry for the VisualBox observability platform.
v0.1.0
2026-08-08 23:59 UTC
Requires
- php: ^8.3
- ext-json: *
- ext-zlib: *
- guzzlehttp/guzzle: ^7.9
- illuminate/console: ^12.0|^13.0
- illuminate/contracts: ^12.0|^13.0
- illuminate/database: ^12.0|^13.0
- illuminate/http: ^12.0|^13.0
- illuminate/queue: ^12.0|^13.0
- illuminate/support: ^12.0|^13.0
Requires (Dev)
- orchestra/testbench: ^10.0|^11.0
- pestphp/pest: ^4.0
- phpunit/phpunit: ^11.0|^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Official Laravel agent for Sentinel by VisualBox Solutions.
Composer package: visualbox/sentinel
Installation
composer require visualbox/sentinel php artisan sentinel:install
Configure .env:
SENTINEL_ENABLED=true SENTINEL_TOKEN=sent_live_xxxxx SENTINEL_ENDPOINT=https://your-sentinel-host SENTINEL_SAMPLE_RATE=1.0
SENTINEL_ENDPOINT is the URL of your Sentinel instance (for example https://sentinel.example.com).
Features (MVP)
- Collectors: requests, queries, exceptions, queue jobs
- Trace context (
trace_id,span_id,parent_span_id) - Payload redaction (passwords, tokens, headers)
- Sampling with retention of exceptions, failures, and slow requests
- Batched buffer with gzip HTTP transport to
/api/v1/telemetry - Retry/backoff and circuit breaker
- Heartbeat to
/api/v1/heartbeat sentinel:statuscommand
Development
composer install
composer test
License
MIT