The Service Map for APM is here!

CouchDB

Agent Check Agent Check

Supported OS: Linux Mac OS Windows

CouchDB dashboard

Overview

Capture CouchDB data in Datadog to:

  • Visualize key CouchDB metrics.
  • Correlate CouchDB performance with the rest of your applications.

For performance reasons, the CouchDB version you’re using is cached, so you cannot monitor CouchDB instances with different versions with the same agent instance.

Setup

Installation

The CouchDB check is included in the Datadog Agent package, so you don’t need to install anything else on your CouchDB servers.

Configuration

Metric Collection

  1. Edit the couch.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your CouchDB performance data. See the sample couch.d/conf.yaml for all available configuration options.

  2. Add this configuration block to your couch.d/conf.yaml file to start gathering your CouchDB Metrics:

      init_config:
    
      instances:
        - server: http://localhost:5984 # or wherever your CouchDB is listening
        #user: <your_username>
        #password: <your_password>
        #name: <A node's Erlang name> # Only for CouchDB 2.x
        #max_nodes_per_check: If no name is specified, the agent will scan all nodes up. As that may be very long, you can limit how many to collect per check. Default: 20
        #max_dbs_per_check. Maximum number of databases to report on. Default: 50
        #tags: A list of tags applied to all metrics collected. Tags may be simple strings or key-value pairs. Default: []

    Optionally, provide a db_whitelist and db_blacklist to control which databases the Agent should and should not collect metrics from.

  3. Restart the Agent to begin sending CouchDB metrics to Datadog.

Log Collection

Available for Agent >6.0

  1. Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml:

    logs_enabled: true
  2. Add this configuration block to your couch.d/conf.yaml file to start collecting your CouchDB Logs:

      logs:
          - type: file
            path: /var/log/couchdb/couch.log
            source: couchdb
            sourcecategory: database
            service: couch

    Change the path and service parameter values and configure them for your environment. See the sample couch.d/conf.yaml for all available configuration options.

  3. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for couch under the Checks section.

Data Collected

Metrics

couchdb.couchdb.request_time
(gauge)
Length of a request inside CouchDB without MochiWeb
shown as second
couchdb.by_db.disk_size
(gauge)
Disk size per database (available for CouchDB v1 only)
shown as byte
couchdb.couch_replicator.changes_read_failures
(gauge)
number of failed replicator changes read failures
shown as error
couchdb.couch_replicator.changes_reader_deaths
(gauge)
number of failed replicator changes readers
shown as resource
couchdb.couch_replicator.changes_manager_deaths
(gauge)
number of failed replicator changes managers
shown as resource
couchdb.couch_replicator.changes_queue_deaths
(gauge)
number of failed replicator changes work queues
shown as resource
couchdb.couch_replicator.checkpoints.success
(gauge)
number of checkpoints successfully saved
shown as record
couchdb.couch_replicator.checkpoints.failure
(gauge)
number of failed checkpoint saves
shown as record
couchdb.couch_replicator.failed_starts
(gauge)
number of replications that have failed to start
shown as resource
couchdb.couch_replicator.requests
(gauge)
number of HTTP requests made by the replicator
shown as request
couchdb.couch_replicator.responses.failure
(gauge)
number of failed HTTP responses received by the replicator
shown as response
couchdb.couch_replicator.responses.success
(gauge)
number of successful HTTP responses received by the replicator
shown as response
couchdb.couch_replicator.stream_responses.failure
(gauge)
number of failed streaming HTTP responses received by the replicator
shown as response
couchdb.couch_replicator.stream_responses.success
(gauge)
number of successful streaming HTTP responses received by the replicator
shown as response
couchdb.couch_replicator.worker_deaths
(gauge)
number of failed replicator workers
shown as resource
couchdb.couch_replicator.workers_started
(gauge)
number of replicator workers started
shown as resource
couchdb.rexi.buffered
(gauge)
number of rexi messages buffered
shown as message
couchdb.rexi.down
(gauge)
number of rexi_DOWN messages handled
shown as message
couchdb.rexi.dropped
(gauge)
number of rexi messages dropped from buffers
shown as message
couchdb.rexi.streams.timeout.init_stream
(gauge)
number of rexi stream initialization timeouts
shown as timeout
couchdb.rexi.streams.timeout.stream
(gauge)
number of rexi stream timeouts
shown as timeout
couchdb.rexi.streams.timeout.wait_for_ack
(gauge)
number of rexi stream timeouts while waiting for acks
shown as timeout
couchdb.couchdb.httpd.aborted_requests
(gauge)
number of aborted requests
shown as request
couchdb.couchdb.httpd.bulk_docs.min
(gauge)
Min of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.max
(gauge)
Max of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.arithmetic_mean
(gauge)
Arithmetic_mean of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.geometric_mean
(gauge)
Geometric_mean of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.harmonic_mean
(gauge)
Harmonic_mean of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.median
(gauge)
Median of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.variance
(gauge)
Variance of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.standard_deviation
(gauge)
Standard_deviation of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.skewness
(gauge)
Skewness of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.kurtosis
(gauge)
Kurtosis of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.percentile.50
(gauge)
Percentile 50 of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.percentile.75
(gauge)
Percentile 75 of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.percentile.90
(gauge)
Percentile 90 of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.percentile.95
(gauge)
Percentile 95 of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.percentile.99
(gauge)
Percentile 99 of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.percentile.999
(gauge)
Percentile 999 of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_docs.n
(gauge)
N of the distribution of the number of docs in _bulk_docs requests
shown as document
couchdb.couchdb.httpd.bulk_requests
(gauge)
number of bulk requests
shown as request
couchdb.couchdb.httpd.requests
(gauge)
number of HTTP requests
shown as request
couchdb.couchdb.httpd.temporary_view_reads
(gauge)
number of temporary view reads
shown as read
couchdb.couchdb.httpd.view_reads
(gauge)
number of view reads
shown as read
couchdb.couchdb.httpd.clients_requesting_changes
(gauge)
number of clients for continuous _changes
shown as connection
couchdb.couchdb.dbinfo.min
(gauge)
Min of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.max
(gauge)
Max of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.arithmetic_mean
(gauge)
Arithmetic_mean of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.geometric_mean
(gauge)
Geometric_mean of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.harmonic_mean
(gauge)
Harmonic_mean of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.median
(gauge)
Median of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.variance
(gauge)
Variance of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.standard_deviation
(gauge)
Standard_deviation of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.skewness
(gauge)
Skewness of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.kurtosis
(gauge)
Kurtosis of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.percentile.50
(gauge)
Percentile 50 of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.percentile.75
(gauge)
Percentile 75 of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.percentile.90
(gauge)
Percentile 90 of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.percentile.95
(gauge)
Percentile 95 of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.percentile.99
(gauge)
Percentile 99 of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.percentile.999
(gauge)
Percentile 999 of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.dbinfo.n
(gauge)
N of the distribution of latencies for calls to retrieve DB info
shown as millisecond
couchdb.couchdb.mrview.map_doc
(gauge)
number of documents mapped in the view server
shown as document
couchdb.couchdb.mrview.emits
(gauge)
number of invocations of `emit' in map functions in the view server
shown as document
couchdb.couchdb.auth_cache_hits
(gauge)
number of authentication cache hits
shown as hit
couchdb.couchdb.auth_cache_misses
(gauge)
number of authentication cache misses
shown as miss
couchdb.couchdb.collect_results_time.min
(gauge)
Min of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.max
(gauge)
Max of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.arithmetic_mean
(gauge)
Arithmetic_mean of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.geometric_mean
(gauge)
Geometric_mean of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.harmonic_mean
(gauge)
Harmonic_mean of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.median
(gauge)
Median of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.variance
(gauge)
Variance of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.standard_deviation
(gauge)
Standard_deviation of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.skewness
(gauge)
Skewness of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.kurtosis
(gauge)
Kurtosis of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.percentile.50
(gauge)
Percentile 50 of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.percentile.75
(gauge)
Percentile 75 of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.percentile.90
(gauge)
Percentile 90 of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.percentile.95
(gauge)
Percentile 95 of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.percentile.99
(gauge)
Percentile 99 of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.percentile.999
(gauge)
Percentile 999 of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.collect_results_time.n
(gauge)
N of the microsecond latency for calls to couch_db:collect_results/3
shown as microsecond
couchdb.couchdb.database_writes
(gauge)
number of times a database was changed
shown as write
couchdb.couchdb.database_reads
(gauge)
number of times a document was read from a database
shown as read
couchdb.couchdb.db_open_time.min
(gauge)
Min of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.max
(gauge)
Max of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.arithmetic_mean
(gauge)
Arithmetic_mean of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.geometric_mean
(gauge)
Geometric_mean of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.harmonic_mean
(gauge)
Harmonic_mean of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.median
(gauge)
Median of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.variance
(gauge)
Variance of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.standard_deviation
(gauge)
Standard_deviation of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.skewness
(gauge)
Skewness of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.kurtosis
(gauge)
Kurtosis of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.percentile.50
(gauge)
Percentile 50 of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.percentile.75
(gauge)
Percentile 75 of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.percentile.90
(gauge)
Percentile 90 of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.percentile.95
(gauge)
Percentile 95 of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.percentile.99
(gauge)
Percentile 99 of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.percentile.999
(gauge)
Percentile 999 of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.db_open_time.n
(gauge)
N of the milliseconds required to open a database
shown as millisecond
couchdb.couchdb.document_inserts
(gauge)
number of documents inserted
shown as document
couchdb.couchdb.document_writes
(gauge)
number of document write operations
shown as write
couchdb.couchdb.local_document_writes
(gauge)
number of _local document write operations
shown as write
couchdb.couchdb.httpd_request_methods.COPY
(gauge)
number of HTTP COPY requests
shown as request
couchdb.couchdb.httpd_request_methods.DELETE
(gauge)
number of HTTP DELETE requests
shown as request
couchdb.couchdb.httpd_request_methods.GET
(gauge)
number of HTTP GET requests
shown as request
couchdb.couchdb.httpd_request_methods.HEAD
(gauge)
number of HTTP HEAD requests
shown as request
couchdb.couchdb.httpd_request_methods.OPTIONS
(gauge)
number of HTTP OPTIONS requests
shown as request
couchdb.couchdb.httpd_request_methods.POST
(gauge)
number of HTTP POST requests
shown as request
couchdb.couchdb.httpd_request_methods.PUT
(gauge)
number of HTTP PUT requests
shown as request
couchdb.couchdb.httpd_status_codes.200
(gauge)
number of HTTP 200 OK responses
shown as request
couchdb.couchdb.httpd_status_codes.201
(gauge)
number of HTTP 201 Created responses
shown as request
couchdb.couchdb.httpd_status_codes.202
(gauge)
number of HTTP 202 Accepted responses
shown as request
couchdb.couchdb.httpd_status_codes.204
(gauge)
number of HTTP 204 No Content responses
shown as request
couchdb.couchdb.httpd_status_codes.206
(gauge)
number of HTTP 206 Partial Content
shown as request
couchdb.couchdb.httpd_status_codes.301
(gauge)
number of HTTP 301 Moved Permanently responses
shown as request
couchdb.couchdb.httpd_status_codes.302
(gauge)
number of HTTP 302 Found responses
shown as request
couchdb.couchdb.httpd_status_codes.304
(gauge)
number of HTTP 304 Not Modified responses
shown as request
couchdb.couchdb.httpd_status_codes.400
(gauge)
number of HTTP 400 Bad Request responses
shown as request
couchdb.couchdb.httpd_status_codes.401
(gauge)
number of HTTP 401 Unauthorized responses
shown as request
couchdb.couchdb.httpd_status_codes.403
(gauge)
number of HTTP 403 Forbidden responses
shown as request
couchdb.couchdb.httpd_status_codes.404
(gauge)
number of HTTP 404 Not Found responses
shown as request
couchdb.couchdb.httpd_status_codes.405
(gauge)
number of HTTP 405 Method Not Allowed responses
shown as request
couchdb.couchdb.httpd_status_codes.406
(gauge)
number of HTTP 406 Not Acceptable responses
shown as request
couchdb.couchdb.httpd_status_codes.409
(gauge)
number of HTTP 409 Conflict responses
shown as request
couchdb.couchdb.httpd_status_codes.412
(gauge)
number of HTTP 412 Precondition Failed responses
shown as request
couchdb.couchdb.httpd_status_codes.413
(gauge)
number of HTTP 413 Request Entity Too Long responses
shown as request
couchdb.couchdb.httpd_status_codes.414
(gauge)
number of HTTP 414 Request URI Too Long responses
shown as request
couchdb.couchdb.httpd_status_codes.415
(gauge)
number of HTTP 415 Unsupported Media Type responses
shown as request
couchdb.couchdb.httpd_status_codes.416
(gauge)
number of HTTP 416 Requested Range Not Satisfiable responses
shown as request
couchdb.couchdb.httpd_status_codes.417
(gauge)
number of HTTP 417 Expectation Failed responses
shown as request
couchdb.couchdb.httpd_status_codes.500
(gauge)
number of HTTP 500 Internal Server Error responses
shown as request
couchdb.couchdb.httpd_status_codes.501
(gauge)
number of HTTP 501 Not Implemented responses
shown as request
couchdb.couchdb.open_databases
(gauge)
number of open databases
shown as resource
couchdb.couchdb.open_os_files
(gauge)
number of file descriptors CouchDB has open
shown as file
couchdb.couchdb.request_time.min
(gauge)
Min of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.max
(gauge)
Max of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.arithmetic_mean
(gauge)
Arithmetic_mean of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.geometric_mean
(gauge)
Geometric_mean of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.harmonic_mean
(gauge)
Harmonic_mean of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.median
(gauge)
Median of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.variance
(gauge)
Variance of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.standard_deviation
(gauge)
Standard_deviation of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.skewness
(gauge)
Skewness of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.kurtosis
(gauge)
Kurtosis of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.percentile.50
(gauge)
Percentile 50 of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.percentile.75
(gauge)
Percentile 75 of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.percentile.90
(gauge)
Percentile 90 of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.percentile.95
(gauge)
Percentile 95 of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.percentile.99
(gauge)
Percentile 99 of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.percentile.999
(gauge)
Percentile 999 of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.request_time.n
(gauge)
N of the length of a request inside CouchDB without MochiWeb (available for CouchDB v1 only)
shown as millisecond
couchdb.couchdb.couch_server.lru_skip
(gauge)
number of couch_server LRU operations skipped
shown as operation
couchdb.couchdb.query_server.vdu_rejects
(gauge)
number of rejections by validate_doc_update function
shown as event
couchdb.couchdb.query_server.vdu_process_time.min
(gauge)
Min of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.max
(gauge)
Max of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.arithmetic_mean
(gauge)
Arithmetic_mean of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.geometric_mean
(gauge)
Geometric_mean of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.harmonic_mean
(gauge)
Harmonic_mean of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.median
(gauge)
Median of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.variance
(gauge)
Variance of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.standard_deviation
(gaugemillisecond)
Standard_deviation of the duration of validate_doc_update function calls
couchdb.couchdb.query_server.vdu_process_time.skewness
(gauge)
Skewness of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.kurtosis
(gauge)
Kurtosis of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.percentile.50
(gauge)
Percentile 50 of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.percentile.75
(gauge)
Percentile 75 of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.percentile.90
(gauge)
Percentile 90 of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.percentile.95
(gauge)
Percentile 95 of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.percentile.99
(gauge)
Percentile 99 of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.percentile.999
(gauge)
Percentile 999 of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couchdb.query_server.vdu_process_time.n
(gauge)
N of the duration of validate_doc_update function calls
shown as millisecond
couchdb.couch_log.level.alert
(gauge)
number of logged alert messages
shown as message
couchdb.couch_log.level.critical
(gauge)
number of logged critical messages
shown as message
couchdb.couch_log.level.debug
(gauge)
number of logged debug messages
shown as message
couchdb.couch_log.level.emergency
(gauge)
number of logged emergency messages
shown as message
couchdb.couch_log.level.error
(gauge)
number of logged error messages
shown as message
couchdb.couch_log.level.info
(gauge)
number of logged info messages
shown as message
couchdb.couch_log.level.notice
(gauge)
number of logged notice messages
shown as message
couchdb.couch_log.level.warning
(gauge)
number of logged warning messages
shown as message
couchdb.pread.exceed_eof
(gauge)
number of the attempts to read beyond end of db file
shown as read
couchdb.pread.exceed_limit
(gauge)
number of the attempts to read beyond set limit
shown as read
couchdb.ddoc_cache.hit
(gauge)
number of design doc cache hits
shown as hit
couchdb.ddoc_cache.miss
(gauge)
number of design doc cache misses
shown as miss
couchdb.ddoc_cache.recovery
(gauge)
number of design doc cache recoveries
shown as read
couchdb.global_changes.db_writes
(gauge)
number of db writes performed by global changes
shown as write
couchdb.global_changes.event_doc_conflict
(gauge)
number of conflicted event docs encountered by global changes
shown as event
couchdb.global_changes.listener_pending_updates
(gauge)
number of global changes updates pending writes in global_changes_listener
shown as write
couchdb.global_changes.rpcs
(gauge)
number of rpc operations performed by global_changes
shown as operation
couchdb.global_changes.server_pending_updates
(gauge)
number of global changes updates pending writes in global_changes_server
shown as write
couchdb.mem3.shard_cache.eviction
(gauge)
number of shard cache evictions
shown as eviction
couchdb.mem3.shard_cache.hit
(gauge)
number of shard cache hits
shown as hit
couchdb.mem3.shard_cache.miss
(gauge)
number of shard cache misses
shown as miss
couchdb.fabric.worker.timeouts
(gauge)
number of worker timeouts
shown as timeout
couchdb.fabric.read_repairs.success
(gauge)
number of successful read repair operations
shown as operation
couchdb.fabric.read_repairs.failure
(gauge)
number of failed read repair operations
shown as operation
couchdb.fabric.doc_update.errors
(gauge)
number of document update errors
shown as error
couchdb.fabric.doc_update.mismatched_errors
(gauge)
number of document update errors with multiple error types
shown as error
couchdb.fabric.doc_update.write_quorum_errors
(gauge)
number of write quorum errors
shown as error
couchdb.by_db.file_size
(gauge)
size of the database file on disk
shown as byte
couchdb.by_db.external_size
(gauge)
size of the database uncompressed
shown as byte
couchdb.by_db.active_size
(gauge)
size of live data
shown as byte
couchdb.by_db.purge_seq
(gauge)
number of purge operations on the databse
shown as operation
couchdb.by_db.doc_del_count
(gauge)
number of deleted documents
shown as document
couchdb.by_db.doc_count
(gauge)
number of documents
shown as document
couchdb.erlang.message_queues.size
(gauge)
couchdb.erlang.stale_proc_count
(gauge)
couchdb.erlang.uptime
(gauge)
couchdb.erlang.io_input
(gauge)
couchdb.erlang.reductions
(gauge)
couchdb.erlang.context_switches
(gauge)
couchdb.erlang.process_limit
(gauge)
couchdb.erlang.words_reclaimed
(gauge)
couchdb.erlang.run_queue
(gauge)
couchdb.erlang.memory.processes_used
(gauge)

shown as byte
couchdb.erlang.memory.ets
(gauge)

shown as byte
couchdb.erlang.memory.atom_used
(gauge)

shown as byte
couchdb.erlang.memory.other
(gauge)

shown as byte
couchdb.erlang.memory.code
(gauge)

shown as byte
couchdb.erlang.memory.binary
(gauge)

shown as byte
couchdb.erlang.memory.atom
(gauge)

shown as byte
couchdb.erlang.memory.processes
(gauge)

shown as byte
couchdb.erlang.internal_replication_jobs
(gauge)
couchdb.erlang.distribution.recv_cnt
(gauge)
couchdb.erlang.distribution.send_pend
(gauge)
couchdb.erlang.distribution.recv_avg
(gauge)
couchdb.erlang.distribution.send_avg
(gauge)
couchdb.erlang.distribution.recv_dvi
(gauge)
couchdb.erlang.distribution.send_cnt
(gauge)
couchdb.erlang.distribution.send_max
(gauge)
couchdb.erlang.distribution.recv_max
(gauge)
couchdb.erlang.distribution.send_oct
(gauge)
couchdb.erlang.distribution.recv_oct
(gauge)
couchdb.erlang.ets_table_count
(gauge)
couchdb.erlang.io_output
(gauge)
couchdb.erlang.os_proc_count
(gauge)
couchdb.erlang.garbage_collection_count
(gauge)
couchdb.erlang.process_count
(gauge)
couchdb.active_tasks.replication.doc_write_failures
(gauge)
Failed docs written while replicating
shown as error
couchdb.active_tasks.replication.docs_read
(gauge)
Docs read while replicating
shown as document
couchdb.active_tasks.replication.docs_written
(gauge)
Docs written while replicating
shown as document
couchdb.active_tasks.replication.missing_revisions_found
(gauge)
Missing revisions
couchdb.active_tasks.replication.revisions_checked
(gauge)
Successfully checked revisions
shown as operation
couchdb.active_tasks.replication.changes_pending
(gauge)
Changes yet to be processed
shown as document
couchdb.active_tasks.replication.count
(gauge)
Number of replications
shown as resource
couchdb.active_tasks.db_compaction.changes_done
(gauge)
Changes currently compacted
shown as document
couchdb.active_tasks.db_compaction.progress
(gauge)
Progress of the compaction process
shown as percent
couchdb.active_tasks.db_compaction.total_changes
(gauge)
Number of changes this compaction will process
shown as document
couchdb.active_tasks.db_compaction.count
(gauge)
Number of running compactions
shown as resource
couchdb.active_tasks.indexer.total_changes
(gauge)
Number of changes to be indexed
shown as document
couchdb.active_tasks.indexer.changes_done
(gauge)
Number of already indexed changes
shown as document
couchdb.active_tasks.indexer.progress
(gauge)
Progress of the indexing process
shown as percent
couchdb.active_tasks.indexer.count
(gauge)
Number of indexing processes
shown as resource
couchdb.active_tasks.view_compaction.progress
(gauge)
Progress of the view compaction
shown as percent
couchdb.active_tasks.view_compaction.count
(gauge)
Number of running view compactions
shown as resource
couchdb.by_ddoc.active_size
(gauge)
Actual size in bytes of the view
shown as byte
couchdb.by_ddoc.file_size
(gauge)
Size in bytes as stored on disk
shown as byte
couchdb.by_ddoc.external_size
(gauge)
Size in bytes of the view uncompressed
shown as byte
couchdb.by_ddoc.minimum_updates_pending
(gauge)

shown as update
couchdb.by_ddoc.preferred_updates_pending
(gauge)

shown as update
couchdb.by_ddoc.total_updates_pending
(gauge)

shown as update
couchdb.by_ddoc.waiting_clients
(gauge)
Number of clients waiting on views from this Design Doc
shown as resource

Events

The Couch check does not include any events at this time.

Service Checks

couchdb.can_connect: Returns Critical if the Agent cannot connect to CouchDB to collect metrics.

Troubleshooting

Need help? Contact Datadog Support.

Further Reading


Mistake in the docs? Feel free to contribute!