3.10. Logging

    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.

      • journald: Logs are sent to stderr without timestamp and log levels compatible with sd-daemon.

      You can also specify a full module name here if implement your own writer:

    • file

      Specifies the location of file for logging output. Only used by the file :

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

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

    • write_buffer

      1. [log]

    • write_delay

      Specifies the wait in milliseconds before committing logs to disk, to enable delayed log writes. Only used by the file writer:

    • Changed in version 1.3: Added warning level.

      Logging level defines how verbose and detailed logging will be:

      1. [log]
      2. 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

      • : Disables logging any messages.

    • include_sasl

      Includes information in logs:

      1. [log]
      2. include_sasl = true

    • syslog_host

      Specifies the syslog host to send logs to. Only used by the syslog writer:

    • syslog_port

      Specifies the syslog port to connect to when sending logs. Only used by the syslog :

      1. [log]
      2. syslog_port = 514

    • syslog_appid

      Specifies application name to the syslog writer:

      1. [log]
      2. syslog_appid = couchdb