---
title: "Transport Tracer 包含配置"
date: 2026-01-17
lastmod: 2026-01-17
description: "transport.tracer.include 配置项用于指定需要包含在追踪日志中的传输层操作。"
tags: ["Transport", "Tracer", "追踪", "调试"]
summary: "配置项作用 #  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/*" 注意事项 #    动态更新: 此配置可以动态更新，无需重启节点。
  功能说明:"
---


## 配置项作用

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

## 配置项属性

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

## 配置建议

## 默认配置

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

## 追踪发现节点故障

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

## 追踪故障检测

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

## 追踪特定操作

```yaml
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/*` - 追踪所有集群相关操作