Skip to main content
APA
Sponsored by CAST AI — Kubernetes cost optimization Better Stack — Uptime monitoring and log management
⚠️

Alert thresholds depend on the nature of your applications. Some queries may have arbitrary tolerance thresholds. Building an efficient monitoring platform takes time. 😉

CouchDB Prometheus Alert Rules

18 Prometheus alerting rules for CouchDB. Exported via gesellix/couchdb-prometheus-exporter. These rules cover critical and warning conditions — copy and paste the YAML into your Prometheus configuration.

2.15. gesellix/couchdb-prometheus-exporter (18 rules) 

wget https://raw.githubusercontent.com/samber/awesome-prometheus-alerts/refs/heads/master/dist/rules/couchdb/gesellix-couchdb-prometheus-exporter.yml
critical

2.15.1. CouchDB node down

CouchDB node is not responding (node_up metric is 0) for more than 2 minutes 

- alert: CouchDBNodeDown
  expr: couchdb_httpd_node_up == 0 or couchdb_httpd_up == 0
  for: 2m
  labels:
    severity: critical
  annotations:
    summary: CouchDB node down (instance {{ $labels.instance }})
    description: "CouchDB node is not responding (node_up metric is 0) for more than 2 minutes\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.2. CouchDB atom memory usage critical

Atom memory usage is above 90% of limit 

- alert: CouchDBAtomMemoryUsageCritical
  expr: couchdb_erlang_memory_atom_used > 0.9 * couchdb_erlang_memory_atom
  for: 5m
  labels:
    severity: critical
  annotations:
    summary: CouchDB atom memory usage critical (instance {{ $labels.instance }})
    description: "Atom memory usage is above 90% of limit\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.3. CouchDB open databases critical

Number of open databases exceeds 90% of node capacity 

  # The default max_dbs_open is 500. Adjust the threshold (currently 0.9 * 1000) to match your max_dbs_open setting.
- alert: CouchDBOpenDatabasesCritical
  expr: couchdb_httpd_open_databases > 0.9 * 1000
  for: 5m
  labels:
    severity: critical
  annotations:
    summary: CouchDB open databases critical (instance {{ $labels.instance }})
    description: "Number of open databases exceeds 90% of node capacity\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.4. CouchDB open OS files critical

CouchDB is using more than 90% of allowed OS file descriptors, may fail to open new files 

  # Adjust 65535 to match your system's file descriptor limit (ulimit -n).
- alert: CouchDBOpenOSFilesCritical
  expr: couchdb_httpd_open_os_files > 0.9 * 65535
  for: 5m
  labels:
    severity: critical
  annotations:
    summary: CouchDB open OS files critical (instance {{ $labels.instance }})
    description: "CouchDB is using more than 90% of allowed OS file descriptors, may fail to open new files\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.5. CouchDB 5xx error ratio high

More than 5% of HTTP requests are returning 5xx errors 

- alert: CouchDB5xxErrorRatioHigh
  expr: rate(couchdb_httpd_status_codes{code=~"5.."}[5m]) / rate(couchdb_httpd_requests[5m]) > 0.05 and rate(couchdb_httpd_requests[5m]) > 0
  for: 5m
  labels:
    severity: critical
  annotations:
    summary: CouchDB 5xx error ratio high (instance {{ $labels.instance }})
    description: "More than 5% of HTTP requests are returning 5xx errors\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.6. CouchDB temporary view read rate critical

Temporary view read rate exceeds 100 reads/sec, high risk of performance degradation 

- alert: CouchDBTemporaryViewReadRateCritical
  expr: rate(couchdb_httpd_temporary_view_reads[5m]) > 100
  for: 5m
  labels:
    severity: critical
  annotations:
    summary: CouchDB temporary view read rate critical (instance {{ $labels.instance }})
    description: "Temporary view read rate exceeds 100 reads/sec, high risk of performance degradation\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
warning

2.15.7. CouchDB Mango queries scanning too many docs

Some Mango queries are scanning too many documents, consider adding indexes 

- alert: CouchDBMangoQueriesScanningTooManyDocs
  expr: rate(couchdb_mango_too_many_docs_scanned[5m]) > 50
  for: 5m
  labels:
    severity: warning
  annotations:
    summary: CouchDB Mango queries scanning too many docs (instance {{ $labels.instance }})
    description: "Some Mango queries are scanning too many documents, consider adding indexes\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
warning

2.15.8. CouchDB Mango queries failed due to invalid index

Some Mango queries failed to execute because the index was missing or invalid 

- alert: CouchDBMangoQueriesFailedDueToInvalidIndex
  expr: rate(couchdb_mango_query_invalid_index[5m]) > 5
  for: 5m
  labels:
    severity: warning
  annotations:
    summary: CouchDB Mango queries failed due to invalid index (instance {{ $labels.instance }})
    description: "Some Mango queries failed to execute because the index was missing or invalid\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
warning

2.15.9. CouchDB Mango docs examined high

High number of documents examined per Mango queries, consider indexing 

- alert: CouchDBMangoDocsExaminedHigh
  expr: rate(couchdb_mango_docs_examined[5m]) > 1000
  for: 5m
  labels:
    severity: warning
  annotations:
    summary: CouchDB Mango docs examined high (instance {{ $labels.instance }})
    description: "High number of documents examined per Mango queries, consider indexing\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.10. CouchDB Replicator manager died

Replication manager process has crashed 

- alert: CouchDBReplicatorManagerDied
  expr: increase(couchdb_replicator_changes_manager_deaths[5m]) > 0
  for: 1m
  labels:
    severity: critical
  annotations:
    summary: CouchDB Replicator manager died (instance {{ $labels.instance }})
    description: "Replication manager process has crashed\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.11. CouchDB Replicator queue process died

Replication queue process has crashed 

- alert: CouchDBReplicatorQueueProcessDied
  expr: increase(couchdb_replicator_changes_queue_deaths[5m]) > 0
  for: 1m
  labels:
    severity: critical
  annotations:
    summary: CouchDB Replicator queue process died (instance {{ $labels.instance }})
    description: "Replication queue process has crashed\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.12. CouchDB Replicator reader process died

Replication reader process has crashed 

- alert: CouchDBReplicatorReaderProcessDied
  expr: increase(couchdb_replicator_changes_reader_deaths[5m]) > 0
  for: 1m
  labels:
    severity: critical
  annotations:
    summary: CouchDB Replicator reader process died (instance {{ $labels.instance }})
    description: "Replication reader process has crashed\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.13. CouchDB Replicator failed to start

One or more replication tasks failed to start 

- alert: CouchDBReplicatorFailedToStart
  expr: increase(couchdb_replicator_failed_starts[5m]) > 0
  for: 1m
  labels:
    severity: critical
  annotations:
    summary: CouchDB Replicator failed to start (instance {{ $labels.instance }})
    description: "One or more replication tasks failed to start\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.14. CouchDB replication cluster unstable

The replication cluster is unstable, replication may be interrupted 

- alert: CouchDBReplicationClusterUnstable
  expr: couchdb_replicator_cluster_is_stable == 0
  for: 2m
  labels:
    severity: critical
  annotations:
    summary: CouchDB replication cluster unstable (instance {{ $labels.instance }})
    description: "The replication cluster is unstable, replication may be interrupted\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
warning

2.15.15. CouchDB replication read failures

Replication changes feed has failed reads more than 5 times in 5 minutes 

- alert: CouchDBReplicationReadFailures
  expr: increase(couchdb_replicator_changes_read_failures[5m]) > 5
  for: 5m
  labels:
    severity: warning
  annotations:
    summary: CouchDB replication read failures (instance {{ $labels.instance }})
    description: "Replication changes feed has failed reads more than 5 times in 5 minutes\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
warning

2.15.16. CouchDB file descriptors high

Process is using more than 85% of allowed file descriptors 

- alert: CouchDBFileDescriptorsHigh
  expr: process_open_fds / process_max_fds > 0.85 and process_max_fds > 0
  for: 5m
  labels:
    severity: warning
  annotations:
    summary: CouchDB file descriptors high (instance {{ $labels.instance }})
    description: "Process is using more than 85% of allowed file descriptors\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
info

2.15.17. CouchDB process restarted

CouchDB process has restarted recently 

- alert: CouchDBProcessRestarted
  expr: changes(process_start_time_seconds[1h]) > 0
  for: 1m
  labels:
    severity: info
  annotations:
    summary: CouchDB process restarted (instance {{ $labels.instance }})
    description: "CouchDB process has restarted recently\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"
critical

2.15.18. CouchDB critical log entries

Critical or error log entries detected in the last 5 minutes 

- alert: CouchDBCriticalLogEntries
  expr: increase(couchdb_server_couch_log{level=~"error|critical"}[5m]) > 5
  for: 1m
  labels:
    severity: critical
  annotations:
    summary: CouchDB critical log entries (instance {{ $labels.instance }})
    description: "Critical or error log entries detected in the last 5 minutes\n  VALUE = {{ $value }}\n  LABELS = {{ $labels }}"

More in Databases

MySQL PostgreSQL SQL Server Oracle Database Patroni PGBouncer Redis Memcached MongoDB Elasticsearch OpenSearch Meilisearch Cassandra Clickhouse Solr