mcpField
S
service-mesh-observability

service-mesh-observability

github.com/wshobson云与 DevOps41.9k10.4k 次安装2 周前更新
代码仓库

关于 service-mesh-observability

面向 Istio、Linkerd 等服务网格部署的可观测性指南，适用于负责运行和排查服务通信的团队。内容涵盖指标、追踪、日志、告警和依赖关系可视化，并提供 SLO 与故障排查建议。

主要功能

  1. 01指标、追踪与日志指南
  2. 02黄金信号及告警阈值
  3. 03采样与追踪上下文实践
  4. 04指标和追踪关联方法
  5. 05可观测性模板与示例

适用场景

  1. 01设置跨服务分布式追踪
  2. 02构建服务网格仪表板和告警
  3. 03排查延迟与错误问题
  4. 04定义通信 SLO 和依赖关系

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wshobson/agents --skill service-mesh-observability

安装后在 Claude Code 中输入/service-mesh-observability确认已加载。

附带文件references/details.md

详细介绍

服务网格可观测性

Istio、Linkerd 和服务网格部署的可观测性模式完整指南。

何时使用本技能

  • 在服务之间设置分布式追踪
  • 实现服务网格指标和仪表盘
  • 调试延迟和错误问题
  • 为服务通信定义 SLO
  • 可视化服务依赖关系
  • 排查网格连接问题

核心概念

1. 可观测性的三大支柱
┌─────────────────────────────────────────────────────┐
│                  Observability                       │
├─────────────────┬─────────────────┬─────────────────┤
│     Metrics     │     Traces      │      Logs       │
│                 │                 │                 │
│ • Request rate  │ • Span context  │ • Access logs   │
│ • Error rate    │ • Latency       │ • Error details │
│ • Latency P50   │ • Dependencies  │ • Debug info    │
│ • Saturation    │ • Bottlenecks   │ • Audit trail   │
└─────────────────┴─────────────────┴─────────────────┘
2. 网格的黄金信号
信号描述告警阈值
延迟请求持续时间 P50、P99P99 > 500ms
流量每秒请求数异常检测
错误5xx 错误率> 1%
饱和度资源利用率> 80%

模板和详细示例

完整的模板库和详细示例位于 references/details.md。当你需要具体模板时，请阅读该文件。

最佳实践

推荐做法
  • 合理采样 - 开发环境 100%，生产环境 1-10%
  • 使用追踪上下文 - 一致地传播标头
  • 设置告警 - 针对黄金信号
  • 关联指标/追踪 - 使用 exemplars
  • 策略性保留 - 热/冷存储分层
不推荐做法
  • 不要过度采样 - 存储成本会累积
  • 不要忽视基数 - 限制标签值
  • 不要跳过仪表盘 - 可视化依赖关系
  • 不要忘记成本 - 监控可观测性成本

评论

支持 Markdown