3.10. 日志记录

3.10.1. 日志记录选项

[log]

CouchDB 日志记录配置。

writer

当前的写入器包括

  • stderr: 日志发送到 stderr。

  • file: 日志发送到 log file 中设置的文件。

  • syslog: 日志发送到 syslog 守护进程。

  • journald: 日志发送到 stderr，不带时间戳，日志级别与 sd-daemon 兼容。

您也可以在这里指定完整的模块名称，如果您实现了自己的写入器

[log]
writer = stderr
file

指定日志输出文件的路径。仅由 file writer 使用。

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

此路径应可供运行 CouchDB 服务的用户（默认情况下为 couchdb）读取和写入。

write_buffer

指定文件日志写入缓冲区的字节大小，以启用延迟日志写入。仅由 file writer 使用。

[log]
write_buffer = 0
write_delay

指定将日志提交到磁盘之前的等待时间（毫秒），以启用延迟日志写入。仅由 file writer 使用。

[log]
write_delay = 0
level

在版本 1.3 中更改: 添加了 warning 级别。

日志记录级别定义日志记录的详细程度。

[log]
level = info

可用级别

  • debug: 详细的调试日志记录。

  • info: 信息性日志记录。包括 HTTP 请求标题、外部进程启动等。

  • 注意

  • warning 或 warn: 警告消息是关于可能导致错误的边缘情况的警报。例如，压缩守护进程在这个级别上会发出有关磁盘空间不足或不足的警报。

  • error 或 err: 错误级别仅包括出错的事情，例如崩溃报告和 HTTP 错误响应（5xx 代码）。

  • critical 或 crit

  • 警报

  • emergency 或 emerg

  • none: 禁用记录任何消息。

include_sasl

在日志中包含 SASL 信息。

[log]
include_sasl = true
syslog_host

注意

设置 syslog_host 是 syslog 工作的必要条件！

指定要将日志发送到的 syslog 主机。仅由 syslog writer 使用。

[log]
syslog_host = localhost
syslog_port

指定发送日志时要连接到的 syslog 端口。仅由 syslog writer 使用。

[log]
syslog_port = 514
syslog_appid

指定 syslog writer 的应用程序名称。

[log]
syslog_appid = couchdb
syslog_facility

指定与 syslog writer 一起使用的 syslog 设施。

[log]
syslog_facility = local2

注意

CouchDB 的 syslog 仅知道如何使用 UDP 日志记录。请确保您的 syslog 服务器启用了 UDP 日志记录。

对于 rsyslog，您可以在 /etc/rsyslog.conf 中启用 UDP 模块 imudp。

# provides UDP syslog reception
module(load="imudp")
input(type="imudp" port="514")