3.8. Logging¶
3.8.1. Logging options¶
- [log]¶
CouchDB logging configuration.
- writer¶
Current writers include:
- stderr: Logs are sent to stderr.
- file: Logs are sent to the file set in log file.
- syslog: Logs are sent to the syslog daemon.
You can also specify a full module name here if implement your own writer:
[log] writer = stderr
- file¶
Specifies the location of file for logging output. Only used by the file writer:
[log] file = /var/log/couchdb/couch.log
This path should be readable and writable for user that runs CouchDB service (couchdb by default).
- write_buffer¶
Specifies the size of the file log write buffer in bytes, to enable delayed log writes. Only used by the file writer:
[log] write_buffer = 0
- write_delay¶
Specifies the wait in milliseconds before committing logs to disk, to enable delayed log writes. Only used by the file writer:
[log] write_delay = 0
- 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: Detailed debug logging.
- info: Informative logging. Includes HTTP requests headlines, startup of an external processes etc.
- notice
- warning or warn: 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 or err: Error level includes only things that go wrong, like crash reports and HTTP error responses (5xx codes).
- critical or crit
- alert
- emergency or emerg
- none: Disables logging any messages.
- syslog_host¶
Specifies the syslog host to send logs to. Only used by the syslog writer:
[log] syslog_host = localhost