API 可观测性

面向接口的可观测体系:请求量、错误率、延迟分位与饱和度四类指标,配合结构化日志与追踪;按消费者与接口维度切片,才能定位影响面。

指标QPS、错误率、P50/P95/P99 延迟、并发饱和度
维度按接口、调用方、状态码切片
日志结构化字段含关联 ID、耗时、上下游标识
  • 流量:QPS 与请求量,按接口与调用方维度拆分
  • 错误:错误率区分客户端错误与服务端错误类别
  • 延迟:P50/P95/P99 与超时占比同时观察
  • 饱和度:连接池、线程池与队列水位设为预警指标
  • 关联:trace ID 贯穿日志、指标与调用链

结构化日志要素(示例)

结构化日志要素(示例)
{"ts":"2026-10-12T10:00:00Z","trace_id":"...","api":"/v1/orders","consumer":"app-a","status":200,"dur_ms":23}
告警绑定用户可感知症状(错误率、延迟超标),避免仅以资源指标触发告警。

易错点

  • 只有平均延迟,长尾问题被掩盖
  • 日志无结构,排查仍需逐台检索

数据来源与参考

  • Google SRE Book:Monitoring Distributed Systems
  • 《Observability Engineering》(Majors 等)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌