Skip to content

An Opentelemetry implementation for Laravel Horizon and queues

License

Notifications You must be signed in to change notification settings

worksome/horizon-telemetry

Repository files navigation

OpenTelemetry for Laravel Horizon and queues

Latest Version on Packagist GitHub Tests Action Status GitHub Static Analysis Action Status Total Downloads

This package adds support for creating various matrices on your queues with the usage of Horizon.

This package requires that the scheduler is running, as it is adding new scheduled commands.

Installation

You can install the package via composer:

composer require worksome/horizon-telemetry

Usage

Metrics

The CurrentMasterSupervisorsMetric will register the current number of master supervisors.
The metric will be registered under the name horizon_current_master_supervisors.

The default schedule for this is every 10 minutes (*/10 * * * *), to configure this, add MeterName::CurrentMasterSupervisors->value under a horizon key in your telemetry.php config file.

The CurrentProcessesMetric will register the current number of processes in each queue.
The metrics will be registered under the name horizon_current_processes.<queue_name>.

The default schedule for this is every 10 minutes (*/10 * * * *), to configure this, add MeterName::CurrentProcesses->value under a horizon key in your telemetry.php config file.

The CurrentJobsMetric will register the current number of jobs in each queue.
The metrics will be registered under the name horizon_current_jobs.<queue_name>.

The default schedule for this is every 10 minutes (*/10 * * * *), to configure this, add MeterName::CurrentJobs->value under a horizon key in your telemetry.php config file.

Event Listeners

The FailedJobsListener listener will create an observable counter that will increment each time a job fails. This metric will be registered under the name horizon_failed_jobs.

The default schedule for this is true, to disable this event listener, add MeterName::FailedJobs->value => false under a horizon key in your telemetry.php config file.

The ProcessedJobsListener listener will create an observable counter that will increment each time a job is processed. This metric will be registered under the name horizon_processed_jobs.

The default schedule for this is true, to disable this event listener, add MeterName::ProcessedJobs->value => false under a horizon key in your telemetry.php config file.

The ProcessedJobsPeakMemoryUsageListener listener will create a histogram over peak memory usage each time a job is processed. This metric will be registered under the name horizon_processed_jobs_peak_memory_usage.

Two listeners are actually registered here, the secondary listener is ProcessedJobsPeakMemoryUsagePreparationListener which will take care of clearing the peak memory usage before a job starts, so for long-running queue workers, we get the correct number.

The default schedule for this is true, to disable this event listener, add MeterName::ProcessedJobsPeakMemoryUsage->value => false under a horizon key in your telemetry.php config file.

Testing

composer test

About

An Opentelemetry implementation for Laravel Horizon and queues

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages