service-mesh-observability について
Istio、Linkerd などのサービスメッシュ運用に向けた可観測性ガイドです。メトリクス、トレース、ログ、アラート、依存関係の可視化を扱い、SLO の設定や障害調査の指針も示します。
主な機能
- 01メトリクス、トレース、ログの指針
- 02ゴールデンシグナルとアラート閾値
- 03サンプリングとトレースコンテキストの実践
- 04メトリクスとトレースの相関
- 05可観測性テンプレートと例
活用シーン
- 01サービス間の分散トレーシング設定
- 02サービスメッシュのダッシュボードとアラート作成
- 03レイテンシやエラーの調査
- 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、P99 | P99 > 500ms |
| トラフィック | 1 秒あたりのリクエスト数 | 異常検知 |
| エラー | 5xx エラー率 | > 1% |
| 飽和度 | リソース使用率 | > 80% |
テンプレートと詳細な実例
完全なテンプレートライブラリと詳細な実例は references/details.md にあります。具体的なテンプレートが必要な場合は、そのファイルを参照してください。
ベストプラクティス
推奨事項
- 適切にサンプリングする - 開発環境では 100%、本番環境では 1〜10%
- トレースコンテキストを使用する - ヘッダーを一貫して伝播させる
- アラートを設定する - ゴールデンシグナルに対して
- メトリクスとトレースを関連付ける - エグザンプラーを使用する
- 戦略的に保持する - ホット/コールドストレージ階層
非推奨事項
- 過剰にサンプリングしない - ストレージコストがかさむ
- カーディナリティを無視しない - ラベルの値を制限する
- ダッシュボードを省略しない - 依存関係を可視化する
- コストを忘れない - 可観測性のコストを監視する
コメント
Markdown 対応