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

-   Telegraf v0.1.3+

# RethinkDB Input Plugin

This plugin collects metrics from [RethinkDB](https://www.rethinkdb.com/) servers.

**Introduced in:** Telegraf v0.1.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 metrics from one or many RethinkDB servers
[[inputs.rethinkdb]]
  ## An array of URI to gather stats about. Specify an ip or hostname
  ## with optional port add password. ie,
  ##   rethinkdb://user:auth_key@10.10.3.30:28105,
  ##   rethinkdb://10.10.3.33:18832,
  ## For rethinkdb v2.3.0+ with username/password authorization you should use
  ##   rethinkdb2://username:password@127.0.0.1:28015"
  servers = ["127.0.0.1:28015"]
```

## Metrics

-   rethinkdb
    
    -   tags:
        -   type
        -   ns
        -   rethinkdb\_host
        -   rethinkdb\_hostname
    -   fields:
        -   cache\_bytes\_in\_use (integer, bytes)
        -   disk\_read\_bytes\_per\_sec (integer, reads)
        -   disk\_read\_bytes\_total (integer, bytes)
        -   disk\_written\_bytes\_per\_sec (integer, bytes)
        -   disk\_written\_bytes\_total (integer, bytes)
        -   disk\_usage\_data\_bytes (integer, bytes)
        -   disk\_usage\_garbage\_bytes (integer, bytes)
        -   disk\_usage\_metadata\_bytes (integer, bytes)
        -   disk\_usage\_preallocated\_bytes (integer, bytes)
-   rethinkdb\_engine
    
    -   tags:
        -   type
        -   ns
        -   rethinkdb\_host
        -   rethinkdb\_hostname
    -   fields:
        -   active\_clients (integer, clients)
        -   clients (integer, clients)
        -   queries\_per\_sec (integer, queries)
        -   total\_queries (integer, queries)
        -   read\_docs\_per\_sec (integer, reads)
        -   total\_reads (integer, reads)
        -   written\_docs\_per\_sec (integer, writes)
        -   total\_writes (integer, writes)

## Example Output

#### Related

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