Download the PHP package jobviz/agent without Composer
On this page you can find all versions of the php package jobviz/agent. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package agent
Short Description Lightweight agent SDK for monitoring Laravel Queue, Symfony Messenger, and custom PHP queue jobs with Jobviz
License MIT
Homepage https://jobviz.dev
Informations about the package agent
jobviz-agent
Lightweight SDK for streaming job lifecycle events from your PHP application to Jobviz — real-time monitoring, alerting, and AI-powered debugging for background jobs.
Supports Laravel Queue, Symfony Messenger, and custom providers.
Install
Quick Start
Laravel (zero-config)
Add your API key to .env:
That's it. The service provider auto-discovers via Composer, hooks into Laravel's queue events, and streams them to Jobviz in batches.
Optionally publish the config file:
Symfony Messenger
Register SymfonyMessengerProvider as a service to auto-wire it as an event subscriber.
Multiple queue systems
In-Job Logging
Attach structured log entries to a running job for step-by-step visibility in the Jobviz timeline:
Deployment Tracking
Correlate deployments with job failures in the Jobviz dashboard:
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
apiKey |
string |
required | Your Jobviz project API key |
provider |
QueueProviderInterface |
required | Queue provider instance |
endpoint |
string |
https://app.jobviz.dev |
Jobviz API endpoint |
env |
?string |
null |
Environment tag (e.g. production, staging) |
batchSize |
int |
100 |
Max events per HTTP batch |
flushInterval |
float |
3.0 |
Flush interval in seconds |
maxBufferSize |
int |
10000 |
Max events buffered in memory before dropping oldest |
captureInput |
bool |
true |
Capture job payload data |
captureStackTraces |
bool |
true |
Capture stack traces on failure |
redactKeys |
bool\|string[] |
true |
Redact sensitive keys from job data |
debug |
bool |
false |
Enable verbose logging |
onError |
?Closure |
null |
Called when a batch fails to send |
Laravel config
When using Laravel, all options are configurable via config/jobviz.php and environment variables. See JOBVIZ_API_KEY, JOBVIZ_ENDPOINT, JOBVIZ_ENV, and JOBVIZ_DEBUG.
Internal buffering
The event buffer holds up to maxBufferSize events (default 10 000) in memory. When the buffer is full, the oldest events are dropped to prevent unbounded memory growth.
HTTP transport retries failed requests with exponential backoff (up to 4 attempts) and respects 429 Retry-After headers.
Privacy & Data Sanitization
By default, the agent captures job input data and error stack traces — this powers Jobviz's debugging and AI root-cause analysis features.
If your jobs handle sensitive data, you have several levels of control:
Built-in redacted keys: password, secret, token, apikey, api_key, authorization, creditcard, credit_card, ssn, accesstoken, access_token, refreshtoken, refresh_token.
Key matching is case-insensitive — Authorization, AUTHORIZATION, and authorization are all redacted.
See our Privacy Policy for full details on data handling.
Multi-Instance Usage
The Jobviz::init() / Jobviz::stop() helpers manage a global singleton. For advanced use cases (tests, multi-tenant), instantiate JobvizAgent directly:
Custom Providers
Implement the QueueProviderInterface to monitor any queue system:
Graceful Shutdown
In Laravel, the service provider automatically flushes remaining events when the application terminates.
For standalone usage, call stop() to flush the buffer before your process exits:
Tip:
Jobviz::stop()disconnects providers and flushes the in-memory buffer — typically under 1 second.
Requirements
- PHP >= 8.1
- Guzzle HTTP >= 7.0
- One of: Laravel 10+/11+ or Symfony 6+/7+ (or a custom provider)
Documentation
Full documentation is available at jobviz.dev/docs.
License
MIT