# 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`: 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.
    - `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.
  `include_sasl`

    Includes SASL information in logs:

        [log]
        include_sasl = true

  `syslog_host`

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

        [log]
        syslog_host = localhost

  `syslog_port`

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

        [log]
        syslog_port = 514

  `syslog_appid`

    Specifies application name to the `syslog` `writer`:

        [log]
        syslog_appid = couchdb

  `syslog_facility`

    Specifies the syslog facility to use with the `syslog` `writer`:

        [log]
        syslog_facility = local2