第十八章 EMQX日志管理

系列文章目录

第一章 总体概述
第二章 在实体机上安装ubuntu
第三章 Windows远程连接ubuntu
第四章 使用Docker安装和运行EMQX
第五章 Docker卸载EMQX
第六章 EMQX客户端MQTTX Desktop的安装与使用
第七章 EMQX客户端MQTTX CLI的安装与使用
第八章 Wireshark工具的安装与使用
第九章 MQTT报文
第十章 MQTT消息质量等级QoS
第十一章 MQTT主题
第十二章 MQTT会话
第十三章 MQTT消息
第十四章 MQTT订阅
第十五章 EMQX访问控制
第十六章 EMQX黑名单与连接抖动检测
第十七章 EMQX数据集成
第十八章 EMQX日志管理

---

前言

---

1 日志简介

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

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

1、控制台输出日志(默认值)

2、文件输出日志。

日志级别：

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

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

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

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

2 日志配置

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

2.1 控制台日志配置

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

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。

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

2.2 文件输出日志配置

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

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

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: 用于记录日志滚动信息的系统文件，请不要手动修改。

---

总结

以上，就是日志介绍。