mcpField
O
observability

observability

github.com/thebeardedbearsasクラウド・DevOps108113 回インストール2 日前に更新
リポジトリ

observability について

OpenTelemetryによる計装、メトリクス、トレース、構造化ログ、SLI/SLOの概念を扱う、エンジニア向けのオブザーバビリティスキルです。技術スタック別の計装ガイダンスには `@observability-engineer` を呼び出します。

主な機能

  1. 01OpenTelemetryの計装パターン
  2. 02メトリクス、トレース、構造化ログ
  3. 03Golden SignalsとRED/USE指標
  4. 04SLI、SLO、SLAの概念

活用シーン

  1. 01サービス計装の計画
  2. 02ログと分散トレースの関連付け
  3. 03サービスレベル指標と目標の定義

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thebeardedbearsas/claude-craft --skill observability

インストール後、Claude Code で/observabilityを入力して読み込まれたか確認します。

詳細

オブザーバビリティ — OpenTelemetry と分散トレーシング

メトリクス、トレース、構造化ログに対応した、OpenTelemetry による最新のインストルメンテーションです。

オブザーバビリティの柱

柱テクノロジー主なメトリクス
メトリクスPrometheus, Grafana, DatadogRED（レート、エラー、継続時間）、USE（使用率、飽和度、エラー）
トレースOpenTelemetry, Jaeger, TempoP95 レイテンシ、スパンの継続時間、エラー率
ログLoki, ElasticSearch, Datadog構造化 JSON、相関 ID

OpenTelemetry（OTel）スタック

// Node.js — Auto-instrumentation
const { NodeSDK } = require('@opentelemetry/sdk-node');
const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');

const sdk = new NodeSDK({
  traceExporter: new OTLPTraceExporter(),
  instrumentations: [getNodeAutoInstrumentations()],
});

sdk.start();

ゴールデンシグナル（Google SRE）

シグナル説明典型的な閾値
レイテンシP50、P95、P99 の応答時間P95 < 200ms
トラフィック1 秒あたりのリクエスト数ベースライン + アラート
エラーエラー率（5xx、例外）< 0.1%
飽和度CPU、メモリ、ディスク継続的に < 80%

構造化ログ（JSON）

{
  "timestamp": "2026-04-17T10:30:00Z",
  "level": "error",
  "message": "Payment processing failed",
  "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
  "span_id": "00f067aa0ba902b7",
  "service.name": "payment-api",
  "error.type": "PaymentGatewayTimeout"
}

SLI / SLO / SLA

概念例
SLI（インジケーター）99.5% のリクエストが 200ms 未満
SLO（目標）月間稼働率 99.9%
SLA（合意）稼働率 99.95% + ペナルティ

スタックごとの詳細なインストルメンテーションについては、@observability-engineer を呼び出してください。

コメント

Markdown 対応