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. 可観測性の 3 本柱
┌─────────────────────────────────────────────────────┐
│                  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
トラフィック1 秒あたりのリクエスト数異常検知
エラー5xx エラー率> 1%
飽和度リソース使用率> 80%

テンプレートと詳細な実例

完全なテンプレートライブラリと詳細な実例は references/details.md にあります。具体的なテンプレートが必要な場合は、そのファイルを参照してください。

ベストプラクティス

推奨事項
  • 適切にサンプリングする - 開発環境では 100%、本番環境では 1〜10%
  • トレースコンテキストを使用する - ヘッダーを一貫して伝播させる
  • アラートを設定する - ゴールデンシグナルに対して
  • メトリクスとトレースを関連付ける - エグザンプラーを使用する
  • 戦略的に保持する - ホット/コールドストレージ階層
非推奨事項
  • 過剰にサンプリングしない - ストレージコストがかさむ
  • カーディナリティを無視しない - ラベルの値を制限する
  • ダッシュボードを省略しない - 依存関係を可視化する
  • コストを忘れない - 可観測性のコストを監視する

コメント