🧭 Agent可观测性·调试实战
30章 · 从入门到生产
📘 友好色系
01
Agent可观测性概述
可观测性
三大支柱 · 为什么Agent需要
02
日志系统基础
logging
级别 · 格式 · 处理器
03
结构化日志
JSON
字段设计 · 上下文 · 聚合
04
OpenTelemetry入门
架构 · SDK/API · 自动/手动埋点
05
Trace与Span
生命周期 · 属性 · 父子关系
06
分布式追踪实战
调用链 · 跨服务 · 采样策略
07
指标与度量
Prometheus
Counter/Gauge/Histogram
08
Agent性能指标
响应时间 · 吞吐量 · 错误率 · 资源
09
可视化与监控看板
Grafana
仪表盘 · 告警规则
10
Agent调试基础
print · 日志 · 断点 · 远程调试
11
Python调试器
pdb
ipdb · IDE调试功能
12
异常与错误处理
try-except · 异常链 · 自定义异常
13
Agent状态检查
健康检查 · 就绪/存活 · 自定义
14
配置管理调试
环境变量 · 配置中心 · 热加载
15
依赖与版本调试
依赖冲突 · 容器化 · 虚拟环境
16
网络调试
重试 · 超时 · DNS · TLS/SSL
17
API调试
REST · gRPC · WebSocket · 版本兼容
18
数据流调试
输入输出 · 数据丢失 · 一致性
19
并发与异步调试
多线程/进程 · asyncio · 死锁
20
内存与性能调试
内存泄漏 · CPU Profiling · GC
21
Agent安全调试
认证授权 · 密钥 · 安全审计
22
集成测试与调试
Mock · 测试容器 · 端到端
23
CI/CD中的调试
流水线 · 环境差异 · 回滚
24
生产环境调试
动态日志 · 流量回放 · 蓝绿
25
告警与通知
规则设计 · 沉默 · 升级 · 渠道
26
可观测性平台搭建
ELK · Grafana+Loki+Tempo · Prometheus
27
Agent自监控
健康监控 · 心跳 · 降级策略
28
调试工具链
curl · jq · grpcurl · tcpdump
29
案例实战一:超时排查
Agent调用外部API超时问题
30
案例实战二:OOM定位
内存泄漏导致OOM · 定位与修复