Skip to content
Bleemeo Bleemeo

CouchDB

Prometheus Metrics

CouchDB is an open-source document-oriented NoSQL database with a focus on ease of use, replication, and HTTP-based access.

Prometheus Metrics

Section titled “Prometheus Metrics”

Service Configuration

Section titled “Service Configuration”

CouchDB 3.2.0+ exposes Prometheus metrics by default at http://localhost:5984/_node/_local/_prometheus. No special configuration is needed, but authentication may be required depending on your setup.

If your CouchDB instance requires authentication, include credentials in the scrape URL:

http://admin:password@localhost:5984/_node/_local/_prometheus

Glouton Configuration

Section titled “Glouton Configuration”
Terminal window
sudo tee /etc/glouton/conf.d/99-couchdb.conf > /dev/null << 'EOF'
metric:
  prometheus:
    targets:
      - url: "http://localhost:5984/_node/_local/_prometheus"
        name: "couchdb"
        allow_metrics:
          - "couchdb_httpd_requests"
          - "couchdb_httpd_request_methods"
          - "couchdb_database_reads"
          - "couchdb_database_writes"
          - "couchdb_open_databases"
          - "couchdb_open_os_files"
          - "couchdb_couch_server_lru_skip"
EOF

Glouton automatically detects configuration changes.

Metric Description
couchdb_httpd_requests Total number of HTTP requests received
couchdb_httpd_request_methods Number of HTTP requests by method (GET, PUT, POST, etc.)
couchdb_database_reads Total number of document read operations
couchdb_database_writes Total number of document write operations
couchdb_open_databases Number of currently open databases
couchdb_open_os_files Number of file descriptors held open by CouchDB
couchdb_couch_server_lru_skip Number of times the LRU cache was skipped for database access