Laravel Packages

Track Job Progress and Status in Laravel with the Laravel Job Status Package

Published
Track Job Progress and Status in Laravel with the Laravel Job Status Package image

The laravel-job-status package provides a simple way to track the status and progress of your queued jobs. The package automatically saves job statuses into the database, allowing you to query and display the current progress, status, and results of any background job in your application.

You can track a queue job's status by adding the Trackable trait provided by this package:

use Imtigger\LaravelJobStatus\Trackable;
 
class MyJob implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels, Trackable;
 
public function __construct(array $params)
{
$this->prepareStatus();
// ...
}
 
public function handle()
{
$this->setProgressNow(10, 100); // Set current progress
$this->setProgressMax(100); // Set max progress
 
// Do some work...
 
$this->setOutput(['message' => 'Job finished!']);
}
}

When a job uses the Trackable trait, it automatically creates a database record when dispatched. You can retrieve the job status using the getJobStatusId() method on your job:

use DispatchesJobs;
 
$job = new TrackableJob([]);
$this->dispatch($job);
 
$jobStatusId = $job->getJobStatusId();
$jobStatus = JobStatus::find($jobStatusId);
 
// Model properties
$jobStatus->job_id
$jobStatus->type
$jobStatus->queue
$jobStatus->status
$jobStatus->attempts
$jobStatus->progress_now
$jobStatus->progress_max
$jobStatus->input
$jobStatus->output
$jobStatus->created_at
$jobStatus->updated_at
$jobStatus->started_at
$jobStatus->finished_at

Main Features

  • Automatic tracking of queued jobs with minimal setup
  • Customizable output, allowing you to store additional metadata
  • Simple database structure, making it easy to extend or query statuses
  • Built-in progress tracking, supporting both simple and complex workflows

You can learn more by visiting the laravel-job-status GitHub repository.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
PayZephyr: One Payment API for Stripe, Paystack, and PayPal image

PayZephyr: One Payment API for Stripe, Paystack, and PayPal

Read article
Bifrost Turns One With AI Builds and New Workflows image

Bifrost Turns One With AI Builds and New Workflows

Read article
Preview Blade Templates in macOS Finder with Quick Blade image

Preview Blade Templates in macOS Finder with Quick Blade

Read article
Artisan Debugging Commands in Laravel Telescope 5.24.0 image

Artisan Debugging Commands in Laravel Telescope 5.24.0

Read article
Queue totalSize() and JobInterrupted Event in Laravel 13.31 image

Queue totalSize() and JobInterrupted Event in Laravel 13.31

Read article
Find Unexpected Test Inputs with Fuzz for Pest image

Find Unexpected Test Inputs with Fuzz for Pest

Read article