📚 课程目录第2章 ODT基础架构

ODT 基础架构：核心模块与配置项深度解析

咱们聊ODT配置优化，光知道参数怎么改可不够。你得先搞清楚ODT这玩意儿里面到底长什么样。嗯，我刚开始接触ODT时，也以为就是个简单的开关配置。后来在项目中踩过坑才发现，不懂架构就去调参，跟闭着眼开车没什么区别。

ODT 的三大核心模块

我个人喜欢把ODT拆成三个部分来看：引擎层、策略层、接口层。这三层各司其职，又互相牵制。

引擎层（Engine Layer）：负责底层的信号处理与逻辑运算。说白了，它是ODT的大脑。所有的时序计算、状态追踪都在这儿完成。
策略层（Policy Layer）：决定了ODT怎么去适应当前的网络环境。你配置的那些参数，最后都映射到这一层。
接口层（Interface Layer）：它连接了策略层和外部系统，比如日志输出、告警上报、北向API等。

画重点：你在调试ODT时，如果发现参数改了但现象没变，大概率是策略层和引擎层的交互没对齐。我遇到过好几次，折腾半天，最后发现是引擎层的缓存没刷新。

这三层的关系，我画了一张图，你可以感受一下它们是怎么串起来的。

配置项解析：记住这几组关键参数

ODT的配置项看着多，但常用的就那几组。我习惯把它们分成四类。你想想看，只要把这四类理清楚，万变不离其宗。

配置类别	典型参数	作用
全局参数	`odt_enable`, `global_timeout`	控制ODT的启停和全局超时
拓扑参数	`topology_type`, `hop_limit`	定义网络拓扑类型和最大跳数
调优参数	`threshold_low`, `threshold_high`	设置触发调优的高低阈值
日志参数	`log_level`, `log_output`	控制日志的详细程度和输出方式

小经验：我个人经验，全局参数和拓扑参数是“地基”，调优参数是“墙”。地基没打好，墙砌得再漂亮也容易塌。你在项目里，可以优先把 global_timeout 和 topology_type 确定下来，再折腾阈值之类的。

配置文件结构：YAML vs JSON

ODT配置文件主流是两种格式：YAML和JSON。我记得第一次看ODT的YAML文件时，差点被缩进搞疯。后来习惯了也就觉得还好。这里我直接贴两个例子，你一看就明白。

YAML 风格（我个人更推荐）：

odt:
  engine:
    cache_size: 1024
    timeout: 5000
  policy:
    topology: "mesh"
    threshold:
      low: 10
      high: 90
  interface:
    log_level: "debug"
    output: "file"

JSON 风格（别笑，真有项目用这个）：

{
  "odt": {
    "engine": {"cache_size": 1024, "timeout": 5000},
    "policy": {
      "topology": "mesh",
      "threshold": {"low": 10, "high": 90}
    },
    "interface": {"log_level": "debug", "output": "file"}
  }
}

注意：YAML对缩进敏感，一个空格不对，整个配置就废了。我建议你项目里统一用4个空格缩进，别用Tab。我在项目里见过有人混用Tab和空格，结果ODT直接起不来，排查了半天。

日志系统：你的第一排查工具

为什么要花这么多功夫讲日志？因为一个配置错误的ODT，你找原因时，日志就是你的救命稻草。我习惯一上来先看日志级别，再根据关键字筛选。

ODT日志等级（从低到高）：

ERROR：致命错误，ODT可能无法工作。比如配置解析失败。
WARNING：异常情况，但不影响运行。比如某个阈值超限。
INFO：关键状态变更。比如ODT启动、拓扑切换。
DEBUG：详细调试信息。比如每次信号处理的过程。

嗯，这里有个小技巧：线上环境用 INFO 级别就够了。DEBUG 级别日志太密集，容易把磁盘写满。我在生产环境里遇到过，有人开了DEBUG没关，两天后磁盘报警，ODT直接挂了。

避坑指南：我曾经排查一个ODT调优不生效的问题，看INFO日志啥也没有。后来切到DEBUG才发现，原来是阈值和拓扑类型的组合冲突了，引擎层直接跳过了策略层的配置。你记住，DEBUG日志是最后的手段，但也最管用。

最后给你一个日志配置的推荐模板。这个模板我在多个项目里验证过，稳得很。

logging:
  level: "info"
  file: "/var/log/odt/odt.log"
  max_size: 100MB
  backups: 5
  format: "%(asctime)s [%(levelname)s] %(message)s"

看，这就是ODT的基础架构全貌。核心模块、配置项、文件结构、日志系统，每一块都环环相扣。你把这几样理顺了，后面的优化思路才能落地。