cx-observability-setup

可観測性のセットアップスキル

可観測性スタック（保存済みビュー、Webhook 統合、通知チャネル、外部統合）をセットアップまたは構成するときに、このスキルを使用します。新しいサービスのオンボーディングや通知パイプラインの再構成に使う「初日セットアップ」スキルです。

---

CLI コマンド

ビュー

コマンド	目的
cx views list	保存済みのすべてのビューを一覧表示します
cx views get <id>	ビュー定義を取得します
cx views create --from-file	保存済みビューを作成します
cx views update <id> --from-file	保存済みビューを更新します
cx views delete <id>	保存済みビューを削除します
cx views folders list	ビューフォルダーを一覧表示します
cx views folders get <id>	フォルダーを取得します
cx views folders create --from-file	フォルダーを作成します
cx views folders update <id> --from-file	フォルダーを更新します
cx views folders delete <id>	フォルダーを削除します

Webhook

コマンド	目的
cx webhooks list	すべての送信 Webhook を一覧表示します
cx webhooks get <id>	Webhook の詳細を取得します
cx webhooks create --from-file	Webhook を作成します
cx webhooks update <id> --from-file	Webhook を更新します
cx webhooks delete <id>	Webhook を削除します
cx webhooks test <id>	Webhook をテストします
cx webhooks types	利用可能な Webhook の種類を一覧表示します
cx webhooks actions list	自動化アクションを一覧表示します
cx webhooks actions get <id>	アクションの詳細を取得します
cx webhooks actions create --from-file	アクションを作成します
cx webhooks actions update --from-file	アクションを更新します
cx webhooks actions delete <id>	アクションを削除します
cx webhooks actions batch --from-file	アクションを一括実行します
cx webhooks actions reorder --from-file	アクションの順序を変更します

通知

コマンド	目的
cx notifications connectors list	通知コネクターを一覧表示します
cx notifications connectors get <id>	コネクターの詳細を取得します
cx notifications connectors create --from-file	コネクターを作成します
cx notifications connectors update <id> --from-file	コネクターを更新します
cx notifications connectors delete <id>	コネクターを削除します
cx notifications connectors types	コネクターの種類を一覧表示します
cx notifications connectors entity-types	エンティティの種類を一覧表示します
cx notifications connectors entity-subtypes --type <type>	エンティティのサブタイプを一覧表示します
cx notifications routers list	通知ルーターを一覧表示します
cx notifications routers get <id>	ルーターの詳細を取得します
cx notifications routers create --from-file	ルーターを作成します
cx notifications routers update <id> --from-file	ルーターを更新します
cx notifications routers delete <id>	ルーターを削除します
cx notifications routers validate-matcher --from-file	エンティティラベルのマッチャーをテストします
cx notifications presets list	通知プリセットを一覧表示します
cx notifications presets get <id>	プリセットの詳細を取得します
cx notifications presets create --from-file	カスタムプリセットを作成します
cx notifications presets update <id> --from-file	カスタムプリセットを更新します
cx notifications presets delete <id>	カスタムプリセットを削除します
cx notifications presets set-default <id>	デフォルトのプリセットを設定します
cx notifications test connector --from-file	コネクター設定をテストします
cx notifications test destination --from-file	宛先をテストします
cx notifications test preset --from-file	プリセット設定をテストします
cx notifications test routing-condition --from-file	ルーティング条件をテストします
cx notifications test template-render --from-file	テンプレートのレンダリングをテストします

インテグレーション

コマンド	目的
cx integrations list	すべてのインテグレーションを一覧表示
cx integrations get <id>	インテグレーションの詳細を取得
cx integrations create --from-file	インテグレーションを作成
cx integrations update <id> --from-file	インテグレーションを更新
cx integrations delete <id>	インテグレーションを削除
cx integrations test --from-file	インテグレーションの設定をテスト
cx integrations template	インテグレーションのテンプレートを取得
cx integrations definition <id>	インテグレーションの定義を取得
cx integrations deployed <id>	デプロイ済みインテグレーションを取得
cx integrations extensions list	利用可能な拡張機能を一覧表示
cx integrations extensions get <id>	拡張機能の詳細を取得
cx integrations extensions deployed	デプロイ済みの拡張機能を一覧表示
cx integrations extensions deploy --from-file	拡張機能をデプロイ
cx integrations extensions update --from-file	デプロイ済みの拡張機能を更新
cx integrations extensions undeploy --from-file	拡張機能のデプロイを解除
cx integrations contextual-data list	コンテキストデータのインテグレーションを一覧表示
cx integrations contextual-data get <id>	コンテキストデータの詳細を取得
cx integrations contextual-data create --from-file	コンテキストデータのインテグレーションを作成
cx integrations contextual-data update <id> --from-file	コンテキストデータのインテグレーションを更新
cx integrations contextual-data delete <id>	コンテキストデータのインテグレーションを削除
cx integrations contextual-data definition <id>	コンテキストデータの定義を取得
cx integrations contextual-data test <id>	コンテキストデータのインテグレーションをテスト

すべてのコマンドで、構造化出力には -o json、プロファイルの選択には -p <profile> を使用できます。

---

新しいサービスのセットアップワークフロー

新しいサービスをオンボーディングする際は、次のチェックリストに従ってください。

1. 保存済みビューを作成する

サービスの主要なログクエリ用にビューを設定します。

cx views folders create --from-file folder.json
cx views create --from-file view.json

2. 通知コネクターを設定する

チャネル（Slack、PagerDuty、メール）を設定します。

cx notifications connectors types -o json
cx notifications connectors create --from-file slack-connector.json

3. 通知ルーティングを設定する

アラートを適切なチャネルにルーティングします。

cx notifications routers create --from-file router.json

4. Webhook を設定する

外部インテグレーション用の送信 Webhook を設定します。

cx webhooks types -o json
cx webhooks create --from-file webhook.json
cx webhooks test <webhook-id>

5. インテグレーションをインストールする

関連するインテグレーションと拡張機能をデプロイします。

cx integrations list -o json
cx integrations create --from-file integration.json
cx integrations extensions deploy --from-file extension.json

6. ダッシュボードを作成する

ダッシュボード作成のワークフロー全体については、cx-dashboards スキルを使用してください。

7. SLO を作成する

SLO の作成と監視には、cx-slos スキルを使用してください。

---

通知セットアップワークフロー

通知チャネルの詳細な設定手順です。

1. 利用可能なコネクタータイプを一覧表示する

cx notifications connectors types -o json

2. コネクターを作成する

cx notifications connectors create --from-file connector.json

3. ルーターを作成する

cx notifications routers create --from-file router.json

4. プリセットを割り当てる、または作成する

cx notifications presets list -o json
cx notifications presets create --from-file preset.json
cx notifications presets set-default <preset-id>

5. エンドツーエンドでテストする

cx notifications test connector --from-file test-connector.json
cx notifications test destination --from-file test-destination.json
cx notifications test routing-condition --from-file test-condition.json

---

Webhook のセットアップ

1. Webhook タイプを一覧表示する

cx webhooks types -o json

2. Webhook を作成する

可能であれば、既存の Webhook をテンプレートとして使用します。

cx webhooks get <existing-id> -o json > webhook-template.json
cx webhooks create --from-file webhook.json

3. Webhook をテストする

cx webhooks test <webhook-id>

4. オートメーションアクションを作成する（任意）

cx webhooks actions create --from-file action.json
cx webhooks actions reorder --from-file order.json

---

重要な原則

• セットアップ後は必ずテストする - cx notifications test、cx webhooks test、cx integrations test を使用します
• 複雑な JSON ペイロードには --from-file を使用する - 標準入力からパイプするか、ファイルを使用します
• 既存のものをテンプレートとして使用する - 作成前に cx <command> get <id> -o json > template.json を実行します
• まずコネクタータイプを確認する - 作成前に cx notifications connectors types と cx webhooks types を実行します

---

関連スキル

• cx-dashboards - ダッシュボードの作成および置き換えのワークフロー
• cx-slos - SLO の作成とエラーバジェットの監視
• cx-cases - アラート発生時に作成されたケースのトリアージ
• cx-alerts - 通知をトリガーするアラート定義
• cx-telemetry-querying - セットアップ後にデータフローを検証