MQTT日志管理

日志简介

通过 EMQX 的日志功能，您可查看 客户端访问、操作系统或网络异常等问题，如登录错误，异常访问，性能故障等等，并基于日志信息进行问题排查或系统性能优化。

EMQX 支持两种不同的日志输出方式：

1. 控制台输出日志(默认值)
2. 文件输出日志。

日志级别：

EMQX 日志包含 8 个等级，默认为 warning 级别，由低到高分别为：

debug < info < notice < warning < error < critical < alert < emergency

每一种日志输出的内容如下所示：

EMQX只会输出比配置日志级别高的日志数据。

日志配置

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

控制台日志配置

配置控制台日志处理进程的选项：

1. 启用日志处理进程：单击切换开关以启用控制台日志处理进程。
2. 日志级别：从下拉列表中选择要使用的日志级别。可选值为：debug, info, notice, warning, error, critical, alert, emergency 。默认值为：warning。
3. 日志格式类型：从下拉列表中选择日志格式。可选值为：text 和 json。默认值为 text。
4. 时间戳格式：从下拉列表中选择日志时间戳格式。可选值为：

   • auto: 根据所使用的日志格式类型自动确定时间戳格式。对于文本格式类型，使用 rfc3339 格式；对于 JSON 格式类型，则使用 epoch格式。

   • epoch: 时间戳以微秒精度的 Unix 纪元时间格式表示。

   • rfc3339: 时间戳使用符合 RFC3339 标准的日期时间字符串格式，格式示例为 2024-03-26T11:52:19.777087+00:00。

   • 时间偏移量：定义日志中时间相对 UTC 的偏移量，默认情况下跟随系统，默认值为 system。

完成配置后，点击 保存更改。

文件输出日志配置

在日志页面，选择文件日志页签：

配置文件日志处理进程的选项：

1. 启用日志处理进程：单击切换开关以启用文件日志处理进程。
2. 日志文件名字：填写日志文件的名称。默认为/opt/emqx/log/emqx.log。
3. 最大日志文件数：轮换的最大日志文件数。默认值为10。
4. 日志文件轮换大小：设置日志文件大小，达到设定的值时日志文件将进行轮换。如果禁用，则日志文件将无限增长。可在文本框输入设定的值，在下拉列表中选择单位，可选值为：MB, GB, KB。
5. 日志级别：从下拉列表中选择要使用的日志级别。可选值为：debug, info, notice, warning, error, critical, alert, emergency 。默认值为：warning。
6. 日志格式类型：从下拉列表中选择日志格式。可选值为：text 和 json。默认值为 text。
7. 时间戳格式：从下拉列表中选择日志时间戳格式。可选值为：
   • 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：用于记录日志滚动信息的系统文件，请不要手动修改。