监控与运维
所属：阶段七 · 工程化部署与运维 目标：掌握三大监控支柱（Logs / Metrics / Traces）、黄金四指标、告警分级、上线迭代闭环。
📌 学习目的
掌握三大监控支柱（Logs / Metrics / Traces）、黄金四指标、告警分级、上线迭代闭环。
✅ 学习要求（前置条件）
已完成「01_agent_engineering_best_practices」。
📚 主要学习内容
- 三大支柱：Logs（明细） / Metrics（聚合数值） / Traces（跨节点路径）
- 黄金四指标：P95 延迟 / QPS / LLM 调用失败率 / token 消耗速率
- Agent 特有的第五维度：成本指标
- 告警分级：P0 / P1 / P2 + SLO 反推阈值
- 上线迭代闭环：Bad-case 收集 → 归类 → 修复 → 回归
📖 对应 docs
- 目录：
docs/07-阶段七-工程化部署与运维/（按目录名里的第 X 篇对应） - 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
🛠️ 建议练习
- 用 loguru + OpenTelemetry 打全链路 trace_id
- 为 Agent 服务暴露 Prometheus 指标
- 搭一个 Bad-case 队列并跑通归类 → 修复 → 回归闭环
🏁 完成后达成标准
- 能搭起 Logs / Metrics / Traces 三大支柱
- 能用 P95 / QPS / 失败率 / token 消耗四项指标定告警阈值
- 能跑通 Bad-case 闭环
🚀 运行提示
# 激活根目录的虚拟环境
cd /Users/jack/source/Demo/py/demo_python_agent
source .venv/bin/activate # 或直接用 uv run ...
# 进入本章目录
cd code/007_phase7_engineering/03_observability_and_ops
# 跑你的练习文件
uv run python your_exercise.py