服务目录基础：构成要素与SRE价值
服务目录（Service Catalog）是SRE体系中的核心元数据底座。它并非简单的服务列表，而是将每个服务的身份、归属、依赖、关键指标结构化记录的统一视图。在SLO驱动调优的语境下，服务目录是连接“业务目标”与“运维动作”的桥梁。
2.1 服务目录的构成要素
一个成熟的服务目录至少包含以下四个核心维度。每个维度都直接服务于后续的SLO计算与变更风险分析。
| 维度 | 字段示例 | 在SRE中的用途 |
|---|---|---|
| 服务标识 | 服务名称、唯一ID、版本号 | 作为所有监控、告警、变更记录的锚点 |
| 所有者 | 团队名称、值班组、Oncall联系人 | 明确SLO归属，确定变更审批与故障响应责任人 |
| 依赖关系 | 上游依赖、下游消费者、基础设施层 | 评估变更影响范围，构建错误预算传播链 |
| 关键指标 | SLO目标、部署频率、变更失败率 | 作为调优的输入与输出，驱动持续改进 |
关键原则：服务目录中的每个字段都应具备“可编程性”。即能够被自动化工具读取、校验和更新，而非仅停留在文档中。
2.2 服务目录在SRE中的核心价值
服务目录的价值体现在三个层面：可见性、可追溯性、可调优性。下面这张图展示了服务目录如何作为SRE数据模型的中枢。
2.3 依赖关系：变更影响分析的基石
在部署频率与变更失败率调优中，依赖关系是最容易被忽视但影响最大的要素。一个服务的变更失败，往往通过依赖链级联放大。
实践建议：在服务目录中为每个服务标注“关键依赖等级”（Critical / High / Medium / Low）。当上游服务变更失败率升高时，自动触发下游服务的SLO告警阈值调整。
依赖关系的记录应包含以下三类：
- 运行时依赖：数据库、缓存、消息队列、外部API。
- 编译/部署依赖：基础镜像、公共库、配置中心。
- 数据依赖：数据管道、事件流、共享存储。
2.4 服务目录与部署频率、变更失败率的关联
服务目录为这两个核心指标提供了上下文。没有服务目录，部署频率只是一个孤立的数字；有了服务目录，我们可以回答：
- 哪个团队的部署频率最高？其SLO是否因此受益？
- 变更失败率高的服务，是否依赖了不稳定的基础设施？
- 当某个服务的变更失败率超过阈值时，应该通知哪些下游团队？
| 指标 | 无服务目录时的状态 | 有服务目录时的能力 |
|---|---|---|
| 部署频率 | 仅知道“每天部署10次” | 按团队、服务等级、依赖深度分解，识别瓶颈 |
| 变更失败率 | 仅知道“失败率2%” | 关联依赖变更记录，定位根因是自身还是上游 |
常见陷阱：服务目录一旦建立，必须保持“活文档”状态。如果依赖关系超过30天未更新，其参考价值将急剧下降。建议通过部署流水线自动触发服务目录的依赖扫描与更新。