Download the PHP package codeldev/laravel-job-log without Composer
On this page you can find all versions of the php package codeldev/laravel-job-log. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download codeldev/laravel-job-log
More information about codeldev/laravel-job-log
Files in codeldev/laravel-job-log
Package laravel-job-log
Short Description A simple Laravel package that automatically logs all jobs queued and processed by your application to the database.
License MIT
Homepage https://github.com/codeldev/laravel-job-log
Informations about the package laravel-job-log
Laravel Job Log
A simple Laravel package that automatically logs all jobs queued and processed by your application to the database. It listens to Laravel's built-in Job Events to record information without wrapping or modifying the Queue itself. Ships with configurable table names, a swappable Eloquent model, and a built-in prune command to manage retention.
Requirements
- PHP 8.4+
- Laravel 13+
Installation
You can install the package via composer:
You can publish and run the migrations with:
You can publish the config file with:
This is the contents of the published config file:
Environment Variables
The following env variables are available to configure the package using your env file.
Usage
Once installed, the package automatically logs every job. No additional setup is required.
Pruning Old Records
Add to your routes/console.php file:
Run manually:
Querying the Data
The package provides an Eloquent model you can use directly:
Available Fields
LaravelJobLog
| Field | Type | Description |
|---|---|---|
id |
string |
UUID primary key |
job_uuid |
string\|null |
Laravel's internal job UUID |
job |
string |
Fully qualified job class name |
queue |
string |
Queue name (e.g. default) |
attempt |
int |
Attempt number |
started_at |
CarbonImmutable |
When the job started processing |
completed_at |
CarbonImmutable\|null |
When the job finished |
status |
LaravelJobRunStatusEnum |
RUNNING (1), SUCCEEDED (2), or FAILED (3) |
duration_ms |
int\|null |
Execution time in milliseconds |
failed_job_id |
int\|null |
Foreign key to Laravel's failed_jobs table |
created_at |
CarbonImmutable\|null |
Record creation timestamp |
updated_at |
CarbonImmutable\|null |
Record update timestamp |
LaravelJobFailed (read-only view of Laravel's failed_jobs table)
| Field | Type | Description |
|---|---|---|
id |
int |
Auto-incrementing primary key |
uuid |
string |
Job UUID |
connection |
string |
Queue connection name |
queue |
string |
Queue name |
payload |
string |
Serialized job payload |
exception |
string |
Exception message and stack trace |
failed_at |
CarbonImmutable |
When the job failed |
The LaravelJobLog model has a failedJob() relationship that links to LaravelJobFailed via the failed_job_id column, giving you access to the full exception details for failed jobs.
Using a Custom Model
You can extend the package model to add your own behaviour, scopes, or relationships. Create your custom model, extend the package model, then update the config:
Then in config/job-log.php:
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.