---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from Beanstalkd
url: https://docs.influxdata.com/telegraf/v1/input-plugins/beanstalkd/
estimated_tokens: 1500
product: Telegraf
version: v1
---

-   Telegraf v1.8.0+

# Beanstalkd Input Plugin

This plugin collects server statistics as well as tube statistics from a [Beanstalkd work queue](https://beanstalkd.github.io/) as reported by the `stats` and `stats-tube` server commands.

**Introduced in:** Telegraf v1.8.0 **Tags:** messaging **OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Collects Beanstalkd server and tubes stats
[[inputs.beanstalkd]]
  ## Server to collect data from
  server = "localhost:11300"

  ## List of tubes to gather stats about.
  ## If no tubes specified then data gathered for each tube on server reported by list-tubes command
  tubes = ["notifications"]
```

## Metrics

Please see the [Beanstalk protocol doc](https://github.com/beanstalkd/beanstalkd/blob/master/doc/protocol.txt) for a detailed explanation of `stats` and `stats-tube` server commands output.

`beanstalkd_overview` – statistical information about the system as a whole

-   fields
    -   cmd\_delete
    -   cmd\_pause\_tube
    -   current\_jobs\_buried
    -   current\_jobs\_delayed
    -   current\_jobs\_ready
    -   current\_jobs\_reserved
    -   current\_jobs\_urgent
    -   current\_using
    -   current\_waiting
    -   current\_watching
    -   pause
    -   pause\_time\_left
    -   total\_jobs
-   tags
    -   name
    -   server (address taken from config)

`beanstalkd_tube` – statistical information about the specified tube

-   fields
    -   binlog\_current\_index
    -   binlog\_max\_size
    -   binlog\_oldest\_index
    -   binlog\_records\_migrated
    -   binlog\_records\_written
    -   cmd\_bury
    -   cmd\_delete
    -   cmd\_ignore
    -   cmd\_kick
    -   cmd\_list\_tube\_used
    -   cmd\_list\_tubes
    -   cmd\_list\_tubes\_watched
    -   cmd\_pause\_tube
    -   cmd\_peek
    -   cmd\_peek\_buried
    -   cmd\_peek\_delayed
    -   cmd\_peek\_ready
    -   cmd\_put
    -   cmd\_release
    -   cmd\_reserve
    -   cmd\_reserve\_with\_timeout
    -   cmd\_stats
    -   cmd\_stats\_job
    -   cmd\_stats\_tube
    -   cmd\_touch
    -   cmd\_use
    -   cmd\_watch
    -   current\_connections
    -   current\_jobs\_buried
    -   current\_jobs\_delayed
    -   current\_jobs\_ready
    -   current\_jobs\_reserved
    -   current\_jobs\_urgent
    -   current\_producers
    -   current\_tubes
    -   current\_waiting
    -   current\_workers
    -   job\_timeouts
    -   max\_job\_size
    -   pid
    -   rusage\_stime
    -   rusage\_utime
    -   total\_connections
    -   total\_jobs
    -   uptime
-   tags
    -   hostname
    -   id
    -   server (address taken from config)
    -   version

## Example Output

```text
beanstalkd_overview,host=server.local,hostname=a2ab22ed12e0,id=232485800aa11b24,server=localhost:11300,version=1.10 cmd_stats_tube=29482i,current_jobs_delayed=0i,current_jobs_urgent=6i,cmd_kick=0i,cmd_stats=7378i,cmd_stats_job=0i,current_waiting=0i,max_job_size=65535i,pid=6i,cmd_bury=0i,cmd_reserve_with_timeout=0i,cmd_touch=0i,current_connections=1i,current_jobs_ready=6i,current_producers=0i,cmd_delete=0i,cmd_list_tubes=7369i,cmd_peek_ready=0i,cmd_put=6i,cmd_use=3i,cmd_watch=0i,current_jobs_reserved=0i,rusage_stime=6.07,cmd_list_tubes_watched=0i,cmd_pause_tube=0i,total_jobs=6i,binlog_records_migrated=0i,cmd_list_tube_used=0i,cmd_peek_delayed=0i,cmd_release=0i,current_jobs_buried=0i,job_timeouts=0i,binlog_current_index=0i,binlog_max_size=10485760i,total_connections=7378i,cmd_peek_buried=0i,cmd_reserve=0i,current_tubes=4i,binlog_records_written=0i,cmd_peek=0i,rusage_utime=1.13,uptime=7099i,binlog_oldest_index=0i,current_workers=0i,cmd_ignore=0i 1528801650000000000
beanstalkd_tube,host=server.local,name=notifications,server=localhost:11300 pause_time_left=0i,current_jobs_buried=0i,current_jobs_delayed=0i,current_jobs_reserved=0i,current_using=0i,current_waiting=0i,pause=0i,total_jobs=3i,cmd_delete=0i,cmd_pause_tube=0i,current_jobs_ready=3i,current_jobs_urgent=3i,current_watching=0i 1528801650000000000
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Beanstalkd Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/beanstalkd/README.md)