Datadog-Gearman Integration

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 packaged with the Agent, so simply install the Agent on your Gearman job servers.

Configuration

Create a file gearmand.yaml in the Agent’s conf.d directory. See the sample gearmand.yaml for all available configuration options:

init_config:

instances:
  - server: localhost
    port: 4730

Restart the Agent to begin sending Gearman metrics to Datadog.

Validation

Run the Agent’s info subcommand and look for gearmand under the Checks section:

  Checks
  ======
    [...]

    gearmand
    -------
      - instance #0 [OK]
      - Collected 26 metrics, 0 events & 1 service check

    [...]

Compatibility

The gearmand check is compatible with all major platforms.

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 event 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.

Further Reading

Learn more about infrastructure monitoring and all our integrations on our blog