RethinkDB

Exporter Metrics

RethinkDB is an open-source distributed document database designed for real-time applications with built-in change feeds.

Exporter Metrics

Detailed RethinkDB metrics are available through the third-party oliver006/rethinkdb_exporter.

Prerequisites

• RethinkDB installed and running
• Glouton agent installed on the same host
• Access to the RethinkDB admin port (default 28015)

Installing the Exporter

No special configuration is required on the RethinkDB side. The exporter connects directly to the RethinkDB admin port.

Download the latest release from the rethinkdb_exporter releases page, or install with Go:

go install github.com/oliver006/rethinkdb_exporter@latest

Start the exporter:

rethinkdb_exporter --rethinkdb.addr=localhost:28015

The exporter listens on port 9123 by default. Verify it is working:

curl http://localhost:9123/metrics

For production use, create a systemd service unit to manage the exporter process.

Glouton Configuration

Linux

sudo tee /etc/glouton/conf.d/99-rethinkdb.conf > /dev/null << 'EOF'
metric:
  prometheus:
    targets:
      - url: "http://localhost:9123/metrics"
        name: "rethinkdb"
        allow_metrics:
          - "rethinkdb_cluster_servers_total"
          - "rethinkdb_cluster_client_connections"
          - "rethinkdb_table_docs_per_second_read"
          - "rethinkdb_table_docs_per_second_written"
          - "rethinkdb_server_query_engine_queries_per_sec"
EOF

Windows

Create or edit C:\ProgramData\glouton\conf.d\99-rethinkdb.conf:

metric:
  prometheus:
    targets:
      - url: "http://localhost:9123/metrics"
        name: "rethinkdb"
        allow_metrics:
          - "rethinkdb_cluster_servers_total"
          - "rethinkdb_cluster_client_connections"
          - "rethinkdb_table_docs_per_second_read"
          - "rethinkdb_table_docs_per_second_written"
          - "rethinkdb_server_query_engine_queries_per_sec"

Glouton automatically detects configuration changes.

Customize collected metrics

The metrics below are our recommended defaults. You can adjust the allow_metrics list to include any metric from the rethinkdb_exporter GitHub repository, or use deny_metrics to exclude specific ones. See Metrics Filtering for details.

Metric	Description
rethinkdb_cluster_servers_total	Total number of servers in the RethinkDB cluster
rethinkdb_cluster_client_connections	Number of active client connections across the cluster
rethinkdb_table_docs_per_second_read	Number of document reads per second per table
rethinkdb_table_docs_per_second_written	Number of document writes per second per table
rethinkdb_server_query_engine_queries_per_sec	Number of queries executed per second on the server