# Trace 日志追踪

# 简介

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

# 创建模块

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

打开 EMQX Dashboard (opens new window),点击左侧的 “模块” 选项卡:

image-202112140001

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

# 追踪指定 ClientID

  1. 点击创建后,选择类型为 ClientID;
  2. 填写需要追踪的 ClientID 信息(必须是精确的ClientID);
  3. 选择起止时间,如果开始时间小于等于当前时间,会默认从当前时间开始。 image-202112140002 image-202112140003

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

# 追踪指定 Topic

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

image-202112140004

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

# 追踪指定 IP

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

image-202112140005

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

image-202112140006

# 注意事项

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