2. DPDK 日志系统详解：日志级别、日志类型与动态日志开关

DPDK 的日志系统是故障排查的第一道防线。无论是初始化失败、驱动加载异常，还是运行时性能抖动，绝大多数问题都会在日志中留下线索。本章深入剖析 DPDK 日志系统的三大核心要素：日志级别（LOG_LEVEL）、日志类型（LOG_TYPE）以及动态日志开关（dynamic log），帮助你精准定位问题源头。

2.1 日志级别（LOG_LEVEL）

DPDK 日志级别控制日志输出的详细程度，从最严重的错误到最琐碎的调试信息。级别越高，输出越详细。系统默认只输出 INFO 及以上级别的日志，调试信息默认关闭。

2.2 日志类型（LOG_TYPE）

日志类型用于区分日志来源模块。DPDK 预定义了数十种类型，覆盖核心库、驱动、协议栈等。通过类型过滤，可以快速聚焦到特定模块的日志，避免被无关信息淹没。

2.3 动态日志开关（Dynamic Log）

动态日志是 DPDK 18.05 引入的杀手级特性，允许在运行时调整日志级别和类型，无需重启进程。这对于排查偶发性问题或生产环境热修复至关重要。

2.3.1 核心机制

动态日志基于 rte_log_set_level_pattern() 和 rte_log_set_level_regex() 两个 API 实现。系统维护一张全局的日志规则表，每条规则包含匹配模式（支持 glob 通配符或正则表达式）和对应的日志级别。日志输出时，按规则表顺序匹配，命中即应用该级别。

2.3.2 命令行控制

DPDK 提供了 --log-level 和 --log-level-pattern 两个 EAL 参数，以及运行时 rte_log_set_level_pattern() API。以下为常用操作示例：

# 启动时设置全局级别为 DEBUG
./dpdk-app --log-level=debug

# 启动时仅将 PMD 驱动日志设为 DEBUG，其他保持默认
./dpdk-app --log-level=pmd.*:debug

# 运行时通过控制台动态调整（需应用支持交互）
rte_log_set_level_pattern("pmd.*", RTE_LOG_DEBUG);

# 使用正则表达式匹配所有 crypto 相关模块
rte_log_set_level_regex(".*crypto.*", RTE_LOG_INFO);

2.3.3 动态日志 vs 静态编译

2.4 日志输出与格式

DPDK 日志默认输出到 stderr，也可通过 rte_openlog_stream() 重定向到文件或 syslog。标准日志格式如下：

EAL: 2: 2024-01-15 10:30:45.123 [MAIN]  INFO  PMD: eth_ixgbe_dev_init(): 82599ES 万兆网卡初始化成功
│    │      │                  │      │     │
│    │      │                  │      │     └─ 模块内函数名
│    │      │                  │      └─ 日志级别
│    │      │                  └─ 线程/进程标识
│    │      └─ 时间戳
│    └─ 日志类型缩写（EAL/PMD/MALLOC...）
└─ 进程 ID

2.5 实战：日志配置示例

以下是一个典型的故障排查日志配置流程：

1. 启动应用，使用默认 INFO 级别，观察是否有明显错误。
2. 发现 PMD 驱动报错，但信息不足。通过 --log-level=pmd.*:debug 重启应用，获取驱动初始化详细流程。
3. 定位到内存池分配失败，进一步将内存池日志打开：--log-level=mempool.*:debug。
4. 运行时，如果应用已经启动且无法重启，通过控制台 API 动态调整：rte_log_set_level_pattern("mempool.*", RTE_LOG_DEBUG)。
5. 问题修复后，恢复日志级别：rte_log_set_level_pattern("mempool.*", RTE_LOG_INFO)，避免性能损耗。