crazybooot/jobs-stats

There is no license information available for the latest version (dev-master) of this package.

Laravel 5.5 package to collect queue statistics

Installs: 22

Dependents: 0

Suggesters: 0

Security: 0

Stars: 6

Watchers: 2

Forks: 5

Open Issues: 13

Language:JavaScript

Type:package

dev-master 2017-11-13 21:07 UTC

This package is auto-updated.

Last update: 2024-10-20 04:12:41 UTC


README

Laravel package for queued job statistics collecting

Install

  • Install composer package to your laravel project
$ composer require crazybooot/queue-stats
  • Add service provider to config/app.php
    'providers' => [
        ...
        Crazybooot\QueueStats\Providers\QueueStatsServiceProvider::class,
    ],
  • Publish migrations
$ php artisan vendor:publish --provider="Crazybooot\QueueStats\Providers\QueueStatsServiceProvider" --tag="migrations"
  • Run migrations
$ php artisn migrate
  • Use QueueStatsTrait and QueueStatsInterface on jobs models you want to collect statistics
...
use Crazybooot\QueueStats\Traits\QueueStatsTrait;
use Crazybooot\QueueStats\Interfaces\QueueStatsInterface;

class ExampleJob implementes QueueStatsInterface, ShouldQueue
{
    use QueueStatsTrait;
}
  • As well you can use extended artisan command to generate job with QueueStatsTrait and QueueStatsInterface. Just add StatJobMakeCommand command to the app/Console/Kernel.php. php artisan make:job would be override by this command.
    protected $commands = [
        ...
        Crazybooot\QueueStats\Make\StatJobMakeCommand::class
    ];

Using

Get statistics about jobs:

...
use Crazybooot\QueueStats\Models\Job;

...
// get failed jobs
Job::failed()->get();

// get success jobs
Job::success()->get();

// get not handled jobs
Job::notHandled()->get();

// get jobs handled on specified queue
Job::queue('default')->get();

// get jobs on specified connection
Job::connection('redis')->get();

// get jobs with specified class
Job::class(ExampleJob::class)->get();

// get jobs with specified number of attempts
Job::attemptsCount(3)->get();

// get jobs which has result
Job::withResult()->get();

// get jobs which have no result
Job::withoutResult()->get();

// get jobs with specified type
Job::type('custom_type')->get();

// get jobs without type
Job::withoutType()->get();

You can get statistics about one job by using getUuid() method on job instance before dispatching job:

...
use Crazybooot\QueueStats\Models\Job;
use App\Job\ExampleJob;

...

$job = new ExampleJob();
$uuid = $job->getUuid();

...

dispath($job);

...

$jobStats = Job::where('uuid', $uuid)->first();

// returns total job atempts waiting on queue duration in seconds
$waitingDuration = $jobStats->getAttribute('waiting_duration');

// returns total job atempts handling duration in seconds
$handlingDuration = $jobStats->getAttribute('handling_duration);

// return job attempts count
$attemptsCount = $jobStats->getAttribute('attempts_count');

You can add some job results to statistics passing array of data you want to save $this->saveResult(). Result will be stored in database in json format what allows to query more complex data with Eloquent or Query Builder.

use Crazybooot\QueueStats\Traits\QueueStatsTrait;

class ExampleJob implementes ShouldQueue
{
    use QueueStatsTrait;
    
    ...
    
    public function handle()
    {
    
    ...
    
    $this->saveResult([
        'some_key' => [
            'some_key' => 'some_payload'
        ]
    ]);
    }
}

Requirements

  • PHP: 7.0+
  • Laravel: 5.5
  • Supported queue drivers: database, beanstalkd, redis