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

==========

* Telegraf v0.10.3+

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

# Apache CouchDB Input Plugin

This plugin gathers metrics from [Apache CouchDB](https://couchdb.apache.org/) instances using the[stats](http://docs.couchdb.org/en/1.6.1/api/server/common.html?highlight=stats#get--_stats) endpoint.

**Introduced in:** Telegraf v0.10.3**Tags:** server**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
# Read CouchDB Stats from one or more servers
[[inputs.couchdb]]
  ## Works with CouchDB stats endpoints out of the box
  ## Multiple Hosts from which to read CouchDB stats:
  hosts = ["http://localhost:8086/_stats"]

  ## Use HTTP Basic Authentication.
  # basic_username = "telegraf"
  # basic_password = "p@ssw0rd"
```

## Metrics

Statistics specific to the internals of CouchDB:

* couchdb\_auth\_cache\_misses
* couchdb\_database\_writes
* couchdb\_open\_databases
* couchdb\_auth\_cache\_hits
* couchdb\_request\_time
* couchdb\_database\_reads
* couchdb\_open\_os\_files

Statistics of HTTP requests by method:

* httpd\_request\_methods\_put
* httpd\_request\_methods\_get
* httpd\_request\_methods\_copy
* httpd\_request\_methods\_delete
* httpd\_request\_methods\_post
* httpd\_request\_methods\_head

Statistics of HTTP requests by response code:

* httpd\_status\_codes\_200
* httpd\_status\_codes\_201
* httpd\_status\_codes\_202
* httpd\_status\_codes\_301
* httpd\_status\_codes\_304
* httpd\_status\_codes\_400
* httpd\_status\_codes\_401
* httpd\_status\_codes\_403
* httpd\_status\_codes\_404
* httpd\_status\_codes\_405
* httpd\_status\_codes\_409
* httpd\_status\_codes\_412
* httpd\_status\_codes\_500

httpd statistics:

* httpd\_clients\_requesting\_changes
* httpd\_temporary\_view\_reads
* httpd\_requests
* httpd\_bulk\_requests
* httpd\_view\_reads

## Tags

* server (url of the couchdb \_stats endpoint)

## Example Output

### Post Couchdb 2.0

```text
couchdb,server=http://couchdb22:5984/_node/_local/_stats couchdb_auth_cache_hits_value=0,httpd_request_methods_delete_value=0,couchdb_auth_cache_misses_value=0,httpd_request_methods_get_value=42,httpd_status_codes_304_value=0,httpd_status_codes_400_value=0,httpd_request_methods_head_value=0,httpd_status_codes_201_value=0,couchdb_database_reads_value=0,httpd_request_methods_copy_value=0,couchdb_request_time_max=0,httpd_status_codes_200_value=42,httpd_status_codes_301_value=0,couchdb_open_os_files_value=2,httpd_request_methods_put_value=0,httpd_request_methods_post_value=0,httpd_status_codes_202_value=0,httpd_status_codes_403_value=0,httpd_status_codes_409_value=0,couchdb_database_writes_value=0,couchdb_request_time_min=0,httpd_status_codes_412_value=0,httpd_status_codes_500_value=0,httpd_status_codes_401_value=0,httpd_status_codes_404_value=0,httpd_status_codes_405_value=0,couchdb_open_databases_value=0 1536707179000000000
```

### Pre Couchdb 2.0

```text
couchdb,server=http://couchdb16:5984/_stats couchdb_request_time_sum=96,httpd_status_codes_200_sum=37,httpd_status_codes_200_min=0,httpd_requests_mean=0.005,httpd_requests_min=0,couchdb_request_time_stddev=3.833,couchdb_request_time_min=1,httpd_request_methods_get_stddev=0.073,httpd_request_methods_get_min=0,httpd_status_codes_200_mean=0.005,httpd_status_codes_200_max=1,httpd_requests_sum=37,couchdb_request_time_current=96,httpd_request_methods_get_sum=37,httpd_request_methods_get_mean=0.005,httpd_request_methods_get_max=1,httpd_status_codes_200_stddev=0.073,couchdb_request_time_mean=2.595,couchdb_request_time_max=25,httpd_request_methods_get_current=37,httpd_status_codes_200_current=37,httpd_requests_current=37,httpd_requests_stddev=0.073,httpd_requests_max=1 1536707179000000000
```