The Service Map for APM is here!

Gearman

Agent Check Agent Check

Supported OS: Linux Mac OS

Overview

Collect Gearman metrics to:

  • Visualize Gearman performance.
  • Know how many tasks are queued or running.
  • Correlate Gearman performance with the rest of your applications.

Setup

Installation

The Gearman check is included in the Datadog Agent package, so you don’t need to install anything else on your Gearman job servers.

Configuration

  1. Edit the gearmand.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Gearman performance data. See the sample gearmand.d/conf.yaml for all available configuration options.

    init_config:
    
    instances:
        - server: localhost
          port: 4730
  2. Restart the Agent

Validation

Run the Agent’s status subcommand and look for gearmand under the Checks section.

Data Collected

Metrics

gearman.unique_tasks
(gauge)
The number of all functions registered with Gearman.
shown as task
gearman.running
(gauge)
The total number of running Gearman jobs.
shown as task
gearman.queued
(gauge)
The total number of jobs in the queue.
shown as task
gearman.workers
(gauge)
The total number of capable Gearman workers.
shown as process
gearman.running_by_task
(gauge)
The number of running Gearman jobs by task.
shown as task
gearman.queued_by_task
(gauge)
The number of jobs in the queue by task.
shown as task
gearman.workers_by_task
(gauge)
The number of capable Gearman workers by task.
shown as process

Events

The Gearmand check does not include any events at this time.

Service Checks

gearman.can_connect:

Returns Critical if the Agent cannot connect to Gearman to collect metrics.

Troubleshooting

Need help? Contact Datadog Support.


Mistake in the docs? Feel free to contribute!