Skills · Claude Code · Agent Skills
見えないシステムは運用できない — 交渉の余地なし。
Collector を備えた OpenTelemetry、相関したトレース・メトリクス・ログ、burn-rate を使った SLO、runbook を指すアラート。可観測性はサービスと同時に生まれ、後付けにしない。
schematize-observability · v0.2.1bash
$ schematize install observability譲れない基準
「速くするため」に無効化しない。完全な一覧はスキルに。
OpenTelemetry と Collector
SDK は Collector と OTLP で話し、バックエンドとは直接話さない。サービスコード内のベンダー SDK は禁止。
サービスと同時に作る
構造化ログ・メトリクス・トレースを出し、probe を公開し、バージョン管理されたダッシュボード・アラート・SLO とともに出荷して初めて完成。
全ログで相関
すべての JSON ログに trace_id と span_id を入れ、メッセージは固定でデータは属性に、Resource に deployment.environment.name を付ける。
テレメトリに PII もシークレットも入れない
発生源でマスクし、Collector の redaction も使う。user_id・メール・IP はメトリクスのラベルにしない。
サンプリングでエラーを落とさない
エラーや遅いトレースは tail sampling で 100% 残す。RED メトリクスはサンプリング済みトレースから導かない。
すべてのサービスに SLO
error budget に対するマルチウィンドウの burn-rate を使い、budget を使い切ったら機能追加を止める。
アラートは症状で、runbook 付き
ユーザー症状のアラートに severity・for・runbook_url を付ける。誰も動かないアラートは削除する。
環境を分離
dev と hml のテレメトリは prd のバックエンドへ送らず、hml は誰も叩き起こさない。
コマンド
.claude/commands/ にインストール。いつでも /obs-help を実行。
/obs-alertsアラート（ユーザー症状、severity、for、runbook）を監査または作成し、check-alertas.mjs を実行。/obs-ccContext compact：コンテキストとチェックリストをアーカイブに書き出し、/compact を実行。/obs-claude常時オンの observability 用 CLAUDE.md をルートに作成またはマージ（他スキルのブロックは上書きしない）。/obs-dashboardコードとしてのダッシュボード（SLO、RED、USE、リンク）。/obs-handoffコンパクトせずにコンテキストの handoff を作成 — セッション終了やタスク切り替え。/obs-helpすべてのコマンドを一覧表示。/obs-instrument標準（SDK から Collector、semconv、JSON ログ、ヘルスチェック）でサービスを計装する。言語はロールに従う。/obs-load規範の全文を強制ロードし、適用を開始する。/obs-reviewサービスの可観測性（シグナル、相関、PII、カーディナリティ、probe、SLO）をレビューし、ゲートを実行。/obs-slo/docs/slo.md に SLI・SLO・error budget を定義し、burn-rate ルールを生成。AI エージェント向け
人手を介さずにインストール。メタデータは llms.txt。
- 実行: git clone https://github.com/schematizeme/skill-observability.git && ./skill-observability/install.sh
- またはダウンロード: https://github.com/schematizeme/skill-observability/releases/latest/download/skill-observability.zip を .claude/skills/ に展開
- assets/CLAUDE.md をリポジトリのルートにコピー（常時オンのルール）。
- /obs-help で確認。
ディスカッション
読み込み中…