Transport Tracer 包含配置

配置项作用 #

transport.tracer.include 配置项用于指定哪些传输层操作应该包含在追踪日志中。

配置项属性 #

• 配置路径: transport.tracer.include
• 数据类型: List<String>（字符串列表）
• 默认值: 空列表（不追踪特定操作）
• 是否可选: 是
• 作用域: NodeScope（节点级别）
• 动态更新: 是（可以动态更新，无需重启）

配置建议 #

默认配置 #

transport:
  tracer:
    include: []  # 空列表，默认值

追踪发现节点故障 #

transport:
  tracer:
    include:
      - "internal:discovery/zen/fd*"

追踪故障检测 #

transport:
  tracer:
    include:
      - "internal:coordination/fault_detection/*"

追踪特定操作 #

transport:
  tracer:
    include:
      - "internal:cluster/monitor/*"
      - "internal:discovery/*"

注意事项 #

1. 动态更新: 此配置可以动态更新，无需重启节点。

2. 功能说明:

   • 设置后，只有匹配列表中模式的操作才会被追踪
   • 允许对传输层调试进行精细控制，避免日志被不必要的追踪信息淹没
   • 支持通配符模式匹配

3. 与 exclude 配合使用:

   • 可以与 transport.tracer.exclude 配合使用，进一步细化追踪输出
   • include 定义要追踪的内容
   • exclude 定义要排除的内容

4. 使用场景:

   • 调试特定的传输层问题
   • 分析节点间通信行为
   • 排查故障检测相关问题

5. 日志影响: 启用追踪会产生额外的日志输出，建议仅在调试时使用，生产环境谨慎开启。

6. 模式示例:

   • internal:discovery/zen/fd* - 追踪 Zen 发现故障检测
   • internal:coordination/fault_detection/* - 追踪协调层故障检测
   • internal:cluster/* - 追踪所有集群相关操作