Trace 日志追踪

简介

针对指定 ClientID 或 Topic 或 IP 实时过滤日志，用于调试和排查错误。

创建模块

Trace 日志追踪模块默认关闭，可以通过dashboard页面进行开启和停止。

打开 EMQX Dashboard，点击左侧的 “模块” 选项卡：

可以创建追踪指定 ClientID 或 Topic 或 IP 客户端的日志。

追踪指定 ClientID

1. 点击创建后，选择类型为 ClientID；
2. 填写需要追踪的 ClientID 信息（必须是精确的ClientID）；
3. 选择起止时间，如果开始时间小于等于当前时间，会默认从当前时间开始。

创建成功后，可以在列表中看到当前的Trace记录，可以查看，或下载日志。 日志内容包含了当前 ClientID 与 EMQX 连接所有交互信息。

追踪指定 Topic

1. 点击创建后，选择类型为 Topic；
2. 填写需要追踪的 Topic 信息（支持通配符）；
3. 选择起止时间，如果开始时间小于等于当前时间，会默认从当前时间开始。

创建成功后，可以在列表中看到当前的Trace记录，可以查看，或下载日志。 日志内容包含了当前主题在 EMQX 上的 Publish/Subscribe/UnSubscribe 信息。

追踪指定 IP

1. 点击创建后，选择类型为 IP Address；
2. 填写需要追踪的 IP 地址信息（必须是精确的IP）；
3. 选择起止时间，如果开始时间小于等于当前时间，会默认从当前时间开始。

创建成功后，可以在列表中看到当前的Trace记录，可以查看，或下载日志。 日志内容包含了当前 IP 与 EMQX 连接所有交互信息。

注意事项

1. 最多可保存30个追踪日志。
2. 追踪日志在每个节点产生的日志最大为 512M。如果产生的日志文件达到最大值，则会停止追加日志，并在主日志文件中给出提示。
3. 可以选择手动停止记录，或等到结束时间时自动停止。
4. 列表中查看到的日志文件大小为未压缩过的文件大小总和。
5. EMQX 集群重启后，会继续未完成的追踪。

为日志追踪设置参数

点击日志追踪模块的参数设置标签页，您可以在该页面中为日志追踪配置以下参数：

• 行最大长度：追踪日志中每行的最大字符长度。若非零，最小可设置为 40。设置为 0 表示不限制长度。
• 文件最大长度：日志文件的最大长度。设置为 0 表示不限制长度。
• 客户端进程最大堆内存: 若日志追踪的类型为 ClientID，此配置决定日志追踪启动后，客户端进程的最大堆内存大小，若进程的堆超过该值将会被 EMQX 杀死，导致客户端连接断开。若非零，最小可设置为 1MB。设置为 0 表示不限制大小。