---
title: ''
description: Telegraf plugin for collecting metrics from Beanstalkd
url: https://docs.influxdata.com/telegraf/v1/input-plugins/beanstalkd/
estimated_tokens: 1058
product: Telegraf Controller
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/beanstalkd/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.8.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.0/plugins/inputs/beanstalkd/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.0/plugins/inputs/beanstalkd/sample.conf)

# 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
```