日志简介
通过 EMQX 的日志功能,您可查看 客户端访问、操作系统或网络异常等问题,如登录错误,异常访问,性能故障等等,并基于日志信息进行问题排查或系统性能优化。
EMQX 支持两种不同的日志输出方式:
- 控制台输出日志(默认值)
- 文件输出日志。
日志级别:
EMQX 日志包含 8 个等级,默认为 warning 级别,由低到高分别为:
console
debug < info < notice < warning < error < critical < alert < emergency
每一种日志输出的内容如下所示:

EMQX只会输出比配置日志级别高的日志数据。
日志配置
通过EMQX Dashboard 可以方便的修改日志配置。 保存修改后将立即生效,无需重启节点 。点击左侧导航栏的 管理 -> 日志。选择相应的页签配置控制台输出日志或文件输出日志。
控制台日志配置

配置控制台日志处理进程的选项:
- 启用日志处理进程:单击切换开关以启用控制台日志处理进程。
- 日志级别 :从下拉列表中选择要使用的日志级别。可选值为:
debug
,info
,notice
,warning
,error
,critical
,alert
,emergency
。默认值为:warning
。 - 日志格式类型 :从下拉列表中选择日志格式。可选值为:
text
和json
。默认值为text
。 - 时间戳格式 :从下拉列表中选择日志时间戳格式。可选值为:
-
auto
: 根据所使用的日志格式类型自动确定时间戳格式。对于文本格式类型,使用rfc3339
格式;对于 JSON 格式类型,则使用epoch
格式。 -
epoch
: 时间戳以微秒精度的 Unix 纪元时间格式表示。 -
rfc3339
: 时间戳使用符合 RFC3339 标准的日期时间字符串格式,格式示例为2024-03-26T11:52:19.777087+00:00
。 -
时间偏移量 :定义日志中时间相对 UTC 的偏移量,默认情况下跟随系统,默认值为
system
。
-
完成配置后,点击 保存更改。
文件输出日志配置
在日志页面,选择文件日志页签:

配置文件日志处理进程的选项:
- 启用日志处理进程:单击切换开关以启用文件日志处理进程。
- 日志文件名字 :填写日志文件的名称。默认为
/opt/emqx/log/emqx.log
。 - 最大日志文件数 :轮换的最大日志文件数。默认值为
10
。 - 日志文件轮换大小 :设置日志文件大小,达到设定的值时日志文件将进行轮换。如果禁用,则日志文件将无限增长。可在文本框输入设定的值,在下拉列表中选择单位,可选值为:
MB
,GB
,KB
。 - 日志级别 :从下拉列表中选择要使用的日志级别。可选值为:
debug
,info
,notice
,warning
,error
,critical
,alert
,emergency
。默认值为:warning
。 - 日志格式类型 :从下拉列表中选择日志格式。可选值为:
text
和json
。默认值为text
。 - 时间戳格式:从下拉列表中选择日志时间戳格式。可选值为:
auto
: 根据所使用的日志格式类型自动确定时间戳格式。对于文本格式类型,使用rfc3339
格式;对于 JSON 格式类型,则使用epoch
格式。epoch
: 时间戳以微秒精度的 Unix 纪元时间格式表示。rfc3339
: 时间戳使用符合 RFC3339 标准的日期时间字符串格式,格式示例为2024-03-26T11:52:19.777087+00:00
。- 时间偏移量 :定义日志中时间相对 UTC 的偏移量,默认情况下跟随系统,默认值为
system
。
完成配置后,点击保存修改。
在文件日志启用后,日志目录下会有如下几种文件:
- emqx.log.N :以 emqx.log 为前缀的文件为日志文件,包含了 EMQX 的所有日志消息。比如
emqx.log.1
、emqx.log.2
... - emqx.log.siz 和 emqx.log.idx :用于记录日志滚动信息的系统文件,请不要手动修改。