3.6. Logging

3.6.1. Logging options

[log]

CouchDB logging configuration.

file

Specifies the location of file for logging output:

[log]
file = /var/log/couchdb/couch.log

This path should be readable and writable for user that runs CouchDB service (couchdb by default).

level

Changed in version 1.3:: Added warning level.

Logging level defines how verbose and detailed logging will be:

[log]
level = info

Available levels:

  • debug: Very informative and detailed debug logging. Includes HTTP headers, external processes communications, authorization information and more;
  • info: Informative logging. Includes HTTP requests headlines, startup of an external processes etc.
  • warning: Warning messages are alerts about edge situations that may lead to errors. For instance, compaction daemon alerts about low or insufficient disk space at this level.
  • error: Error level includes only things that going wrong, crush reports and HTTP error responses (5xx codes).
  • none: Disables logging any messages.
include_sasl

Includes SASL information in logs:

[log]
include_sasl = true

3.6.2. Per module logging

[log_level_by_module]

New in version 1.3.

In this section you can specify log level on a per-module basis:

[log_level_by_module]
couch_httpd = debug
couch_replicator = info
couch_query_servers = error

See src/*/*.erl for available modules.