Overview
Apache CouchDB is an open-source document-oriented NoSQL database implemented in Erlang. It uses JSON for documents, JavaScript for MapReduce indexes, and HTTP for its API. Xitoring's CouchDB integration provides comprehensive monitoring of database operations, request throughput, cache performance, and replication health.
What Can It Monitor?
Database Operations
- DB Reads — Database read operations per second
- DB Writes — Database write operations per second
- Bulk Requests — Bulk document operation rates
Request Metrics
- Requests — Total request count
- Request Time — Average request processing time
- HTTP 2XX — Successful response count
- HTTP 3XX — Redirect response count
- HTTP 4XX — Client error response count
- HTTP 5XX — Server error response count
Cache & Authentication
- Authentication Cache Hits — Successful auth cache lookups
- Authentication Cache Misses — Auth cache misses requiring re-authentication
System Metrics
- Open Databases — Number of currently open databases
- Open OS Files — Number of open file descriptors
Replication
- Replicator Requests — Replication request rates
- Replicator Connections — Active replication connections
And 100+ additional trigger parameters available.
Prerequisites
None! There are no software prerequisites to enable this integration.
How to Activate the Integration
Run the Xitogent CLI:
xitogent integrate
Select CouchDB from the list. When prompted, provide:
- IP address and port (e.g.,
127.0.0.1:5984) - Username and password
Xitogent tests the connection and sets up the rest automatically. Within a minute, graphs and data appear on your server page.
Setting Up Triggers
Available trigger categories include:
- DB Reads / DB Writes / Bulk Requests
- Request Time / Total Requests
- HTTP 2XX / 3XX / 4XX / 5XX
- Authentication Cache Hits / Misses
- Open Databases / Open OS Files
- Replicator Requests / Connections
Navigate to Triggers on your server page, select CouchDB, choose a metric, set your threshold, and configure notification channels.
Tips
- CouchDB integration requires zero configuration — just provide credentials
- Monitor HTTP 5XX responses to catch server-side errors immediately
- Track DB Reads vs Writes ratio to understand your workload pattern
- Set alerts on Authentication Cache Misses — high miss rates slow down authentication
- Watch Open OS Files to prevent file descriptor exhaustion
- Monitor Replicator Connections in multi-node setups to ensure sync health