> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# インシデント Webhook インテグレーション

> アラートプラットフォームを接続して、AI 搭載調査でインシデントを自動作成する

CloudThinker は PagerDuty・Datadog・Grafana などのアラート・モニタリングプラットフォームとインテグレーションします。各インテグレーションには、プラットフォーム固有のフィールドマッピング、柔軟な認証、自動 AI 調査トリガーが含まれています。

***

## サポート対象プラットフォーム

### インシデント管理

<CardGroup cols={2}>
  <Card title="PagerDuty" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/pagerduty-icon.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=7e1bb7c9ae2e6aa13608c8d4d48811cf" href="/ja/guide/connections/pagerduty" width="64" height="64" data-path="images/icons/integrations/pagerduty-icon.svg">
    認証：HMAC-SHA256

    トリガー・確認・解決イベントのネイティブマッピングを備えたオンコール管理とインシデント対応。
  </Card>

  <Card title="ServiceNow" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/service-now.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=0732f3ddc9a9af6f7c3325a74c7aa30a" href="/ja/guide/connections/servicenow" width="71" height="64" data-path="images/icons/integrations/service-now.svg">
    認証：API Key

    インフラコンテキスト向けの CMDB CI マッピングを備えたエンタープライズ IT サービス管理。
  </Card>
</CardGroup>

| プラットフォーム     | 備考                                                         |
| ------------ | ---------------------------------------------------------- |
| **Opsgenie** | 認証：API Key。優先度マッピングとチーム割り当てデータを持つ Atlassian のアラート管理。       |
| **BigPanda** | 認証：Bearer Token。インテリジェントなアラートグループ化を持つ AIOps イベント相関・アラート管理。 |

### モニタリング・オブザーバビリティ

<CardGroup cols={2}>
  <Card title="Datadog" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/datadog-icon.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=3548a1b2e3bc616d2d37d439eba151c6" href="/ja/guide/connections/datadog" width="64" height="64" data-path="images/icons/integrations/datadog-icon.svg">
    認証：Bearer Token

    メトリクス・アラート・タグベースのサービス相関を持つフルスタックモニタリング。
  </Card>

  <Card title="Grafana" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/grafana-logo.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=e0a907966b1ad4ff181ef93cb411e373" href="/ja/guide/connections/grafana" width="800" height="800" data-path="images/icons/integrations/grafana-logo.svg">
    認証：Bearer Token

    ダッシュボードリンク・パネルコンテキスト・共通ラベル抽出付きのアラート通知。
  </Card>

  <Card title="Prometheus / Alertmanager" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/prometheus-logo.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=116d0e24c961b3e19e141d98a61ae3b8" href="/ja/guide/connections/prometheus" width="64" height="64" data-path="images/icons/integrations/prometheus-logo.svg">
    認証：Bearer Token

    ラベル抽出・グループ化サポート・Kubernetes メタデータを備えたネイティブ Alertmanager Webhook レシーバー。
  </Card>
</CardGroup>

| プラットフォーム   | 備考                                           |
| ---------- | -------------------------------------------- |
| **Splunk** | 認証：Bearer Token。結果コンテキストと検索リンク付きの保存済み検索アラート。 |

### クラウドプロバイダーアラート

<CardGroup cols={2}>
  <Card title="AWS CloudWatch" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/aws-cloudwatch.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=9539b73889491ac68c768dc601c6276d" href="/ja/guide/incident/webhook-integrations/cloudwatch" width="16" height="16" data-path="images/icons/integrations/aws-cloudwatch.svg">
    認証：API Key

    アラーム状態・メトリクスデータ・ネームスペースコンテキストを持つ EventBridge ベースのアラート。
  </Card>
</CardGroup>

| プラットフォーム           | 備考                                                     |
| ------------------ | ------------------------------------------------------ |
| **Azure Monitor**  | 認証：なし。リソースコンテキストと重要度マッピングを持つ Common Alert Schema サポート。 |
| **GCP Monitoring** | 認証：Bearer Token。ポリシー詳細とリソース表示名を持つインシデント通知。             |

### APM・エラートラッキング

<CardGroup cols={2}>
  <Card title="New Relic" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/new-relic.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=f302e6dc3976df413a0ebe8fa92da32d" href="/ja/guide/connections/newrelic" width="2500" height="2031" data-path="images/icons/integrations/new-relic.svg">
    認証：API Key

    Issue 優先度とエンティティコンテキストを持つフルスタックオブザーバビリティ。
  </Card>

  <Card title="Dynatrace" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/dynatrace.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=d1c94ab707135fdc0bd47de611b56760" href="/ja/guide/connections/dynatrace" width="64" height="64" data-path="images/icons/integrations/dynatrace.svg">
    認証：API Key

    問題の影響分析と AI 検出の根本原因を持つソフトウェアインテリジェンス。
  </Card>
</CardGroup>

| プラットフォーム   | 備考                                                                 |
| ---------- | ------------------------------------------------------------------ |
| **Sentry** | 認証：HMAC-SHA256。Issue 詳細・スタックトレース・プロジェクトコンテキストを持つアプリケーションエラートラッキング。 |

### カスタムインテグレーション

| プラットフォーム            | 備考                                                                                        |
| ------------------- | ----------------------------------------------------------------------------------------- |
| **Generic Webhook** | 認証：Bearer Token（設定可能）。あらゆるプラットフォームに対応するカスタマイズ可能な Webhook。JSONPath 式で独自のフィールドマッピングを定義できます。 |

> **プラットフォームロードマップ：** お使いのプラットフォームが一覧にない場合は、Generic Webhook で即時インテグレーションするか、サポートに連絡してモニタリングツール向けのネイティブコネクターをリクエストしてください。

***

## Webhook インテグレーションのセットアップ

セットアップウィザードがプラットフォームの選択・Webhook の設定・自動根本原因分析の設定を案内します。

<Frame>
  <img src="https://mintcdn.com/cloudthinker/EgdXomufF-sGaM1E/images/incidents/setup/01-setup-wizard-home.jpg?fit=max&auto=format&n=EgdXomufF-sGaM1E&q=85&s=f0a672ba2519f4bba831fe3a6f6846cc" alt="Deep Response Engine セットアップウィザードのホームページ：AI 搭載根本原因分析の概要" width="3588" height="2004" data-path="images/incidents/setup/01-setup-wizard-home.jpg" />
</Frame>

<p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>セットアップウィザード入口を持つ Deep Response Engine ダッシュボード</p>

<Steps>
  <Step title="インテグレーションに移動する">
    **Deep Response Engine** → **Settings** → **Integrations** タブに移動して Webhook 管理にアクセスします。
  </Step>

  <Step title="Webhook を作成する">
    プラットフォームカードの **「Connect」** をクリックします。プラットフォーム固有のデフォルト値が事前設定された作成ウィザードが開きます。

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/EgdXomufF-sGaM1E/images/incidents/setup/02-select-platform-modal.jpg?fit=max&auto=format&n=EgdXomufF-sGaM1E&q=85&s=813d162c00c7cadd5c302b37323070d4" alt="プラットフォーム選択モーダル：PagerDuty・Datadog・Grafana・AWS CloudWatch などのモニタリング・アラートプラットフォームのオプション" width="2094" height="1688" data-path="images/incidents/setup/02-select-platform-modal.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>利用可能なオプションからモニタリングプラットフォームを選択</p>
  </Step>

  <Step title="基本情報を設定する">
    Webhook の名前と任意の説明を入力します。必要に応じてレート制限を設定します（デフォルト：1 時間あたり 100 リクエスト）。
  </Step>

  <Step title="フィールドマッピングを確認する">
    各プラットフォームには、Webhook ペイロードからインシデントフィールドを抽出する事前設定済みの JSONPath マッピングがあります。必要に応じてカスタマイズします。

    | インシデントフィールド | JSONPath の例                 | 説明                            |
    | ----------- | --------------------------- | ----------------------------- |
    | タイトル        | `$.event.data.title`        | インシデントの見出し                    |
    | 説明          | `$.event.data.description`  | 詳細情報                          |
    | 重要度         | `$.event.data.priority`     | Critical・High・Medium・Low・Info |
    | サービス        | `$.event.data.service.name` | 影響を受けたサービス名                   |

    プラットフォームの重要度値（例：`warning` → `medium`、`P1` → `critical`）を CloudThinker の重要度レベルに変換する**重要度マッピング**も設定できます。

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/mbO-yJISTs683mos/images/incidents/setup/03-configure-webhook-fields.jpg?fit=max&auto=format&n=mbO-yJISTs683mos&q=85&s=3e2e78c9906b973c08090898d794a9ed" alt="Webhook 設定フォーム：タイトルパス・重要度パス・説明パス・サービスパスの JSONPath 式によるフィールドマッピング" width="3586" height="2056" data-path="images/incidents/setup/03-configure-webhook-fields.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Webhook ペイロードの JSONPath フィールドマッピングを設定</p>
  </Step>

  <Step title="自動トリガー設定を行う">
    インシデントが[根本原因分析](/ja/guide/incident/root-cause-analysis)をトリガーする方法を制御します。

    * **RCA の自動トリガー：** インシデント作成時に AI 調査を自動的に開始
    * **最低重要度：** この重要度レベル以上のインシデントのみ RCA をトリガー（デフォルト：Medium）
    * **すべてのフィールドをエージェントに送信：** 完全な Webhook ペイロードを RCA エージェントに転送してより詳細な分析を実施

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/mbO-yJISTs683mos/images/incidents/setup/05-configure-rca-settings.jpg?fit=max&auto=format&n=mbO-yJISTs683mos&q=85&s=48fa14186831df2d79a32729005df187" alt="根本原因分析設定パネル：RCA 自動トリガートグル、最低重要度ドロップダウン（Medium に設定）" width="3586" height="2056" data-path="images/incidents/setup/05-configure-rca-settings.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>自動 RCA トリガーと重要度しきい値を設定</p>
  </Step>

  <Step title="Webhook URL と認証情報をコピーする">
    **Setup** タブに Webhook URL と認証詳細が表示されます。これらの認証情報をコピーしてアラートプラットフォームで設定します。

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/mbO-yJISTs683mos/images/incidents/setup/04-webhook-url-code-examples.jpg?fit=max&auto=format&n=mbO-yJISTs683mos&q=85&s=7bfb126e216a2bddff0c6de499e3fdda" alt="Setup タブ：Webhook URL、リクエスト形式、HTTP ヘッダー、Webhook インテグレーション用コード例" width="3586" height="2056" data-path="images/incidents/setup/04-webhook-url-code-examples.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Webhook URL と認証ヘッダーをコピーしてアラートプラットフォームで設定</p>
  </Step>
</Steps>

***

## 認証方法

CloudThinker はプラットフォームの要件に合わせた 4 つの認証方法をサポートします。プラットフォームを選択すると正しい方法が自動選択されますが、カスタムインテグレーションでは変更できます。

| 方法               | 仕組み                                               | 使用プラットフォーム                                                |
| ---------------- | ------------------------------------------------- | --------------------------------------------------------- |
| **Bearer Token** | `Authorization` ヘッダーを使った標準トークンベース認証               | Datadog・Grafana・Prometheus・Splunk・GCP Monitoring・BigPanda |
| **HMAC-SHA256**  | 暗号署名検証 — CloudThinker が共有シークレットを使ってリクエストボディの署名を検証 | PagerDuty・Sentry                                          |
| **API Key**      | オプションのプレフィックス付きカスタムヘッダー（例：`GenieKey`、`Api-Token`） | Opsgenie・New Relic・Dynatrace・ServiceNow・AWS CloudWatch    |
| **認証なし**         | 他のメカニズムでアイデンティティを確認するプラットフォーム向け                   | Azure Monitor                                             |

<Note>
  既存の Webhook で認証方法を変更すると、以前の方法を使用している既存のインテグレーションはすぐに動作しなくなります。認証方法を変更した後は認証情報を再生成してください。
</Note>

***

## アラートの相関付け

短時間に複数のアラートが届いた場合、CloudThinker は重複するインシデントを作成せずに自動的に 1 件のインシデントに相関付けできます。カスケード障害によるアラート疲弊を軽減します。

### 時間ウィンドウ相関

設定可能なウィンドウ内（デフォルト：5 分）に受信したアラートをグループ化します。新しいアラートが既存のオープンインシデントと一致する場合、新しいインシデントを作成する代わりに相関アラートとして添付されます。

### ルールベース相関

共有属性に基づいて着信アラートを既存インシデントと照合するカスタムルールを定義します。ルールは Webhook カードメニューの **「相関ルール」** から設定します。

各ルールで指定する内容：

* **条件**：照合のための AND/OR ロジック
* **優先度**（0〜1000）：評価順序の制御
* **重み**（0.0〜1.0）：照合の信頼度を示す
* **最低照合重み**：相関を受け入れるしきい値

**利用可能なオペレーター：**

| オペレーター                      | 説明                  |
| --------------------------- | ------------------- |
| `equals` / `not_equals`     | 完全一致または不一致          |
| `contains` / `not_contains` | 部分文字列の一致            |
| `starts_with` / `ends_with` | プレフィックスまたはサフィックスの一致 |
| `regex`                     | 正規表現による一致           |
| `in` / `not_in`             | 値がリスト内または外          |
| `intersects`                | 配列の重複（例：共有タグ）       |
| `exists`                    | フィールドが存在する          |

***

## セキュリティと制限

### ペイロード制限

| 制限             | 値         |
| -------------- | --------- |
| 最大 HTTP ボディサイズ | 1 MB      |
| 最大保存ペイロードサイズ   | 100 KB    |
| 最大フィールド長       | 10,000 文字 |
| 最大配列アイテム数      | 100 要素    |
| 最大ネスト深度        | 10 レベル    |

### レート制限

| 制限         | 値                             |
| ---------- | ----------------------------- |
| デフォルトレート制限 | Webhook ごとに 1 時間あたり 100 リクエスト |
| 認証失敗制限     | 15 分ウィンドウあたり 10 回の失敗          |
| 超過時のレスポンス  | HTTP 429                      |

レート制限は Webhook ごとに設定可能です。無制限にするには 0 を設定します。

### セキュリティ機能

* **タイミングセーフな署名検証**：HMAC 検証に対するタイミング攻撃を防止
* **暗号化されたシークレットストレージ**：Webhook シークレットは保存時に暗号化
* **認証情報のローテーション**：Webhook を再作成せずにトークンとシークレットを再生成
* **ペイロードのサニタイズ**：サイズ超過フィールドは自動的に切り捨て
* **センシティブヘッダーフィルタリング**：認証ヘッダーは監査ログから除外

***

## 関連

<CardGroup cols={2}>
  <Card title="AWS CloudWatch" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/aws-cloudwatch.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=9539b73889491ac68c768dc601c6276d" href="/ja/guide/incident/webhook-integrations/cloudwatch" width="16" height="16" data-path="images/icons/integrations/aws-cloudwatch.svg">
    Amazon EventBridge 経由で CloudWatch アラームをルーティングするステップバイステップガイド。
  </Card>

  <Card title="根本原因分析" icon="magnifying-glass" href="/ja/guide/incident/root-cause-analysis">
    着信 Webhook でトリガーされる自動 AI 搭載調査を設定。
  </Card>
</CardGroup>
