Skip to main content
Webhook を使うと、CloudThinker がリアルタイムで外部システムにイベントをプッシュでき、自動化・連携・カスタムワークフローを実現できます。

Webhook の仕組み

1

設定

送信先 URL と受信するイベントを選択して Webhook エンドポイントを作成する
2

トリガー

購読したイベントが発生すると、CloudThinker が Webhook ペイロードを準備する
3

配信

CloudThinker がイベントデータを含む HTTP POST リクエストをエンドポイントに送信する
4

処理

システムが Webhook を受信・処理し、成功レスポンスを返す

Webhook の作成

コンソールから

  1. 設定 > Webhooks に移動する
  2. Webhook を作成 をクリックする
  3. Webhook を設定する:
    • 名前:識別しやすい名称
    • URL:エンドポイント URL(HTTPS 必須)
    • イベント:購読するイベントを選択
    • シークレット:検証用の署名シークレット(任意)
  4. 保存してテストする

Webhook の設定項目


イベントタイプ

CloudThinker 全体のイベントを購読できます。

推奨事項イベント

インシデントイベント

セキュリティイベント

タスクイベント

エージェントイベント

リソースイベント


Webhook ペイロード

各 Webhook には標準化されたペイロードが含まれます。

ペイロードフィールド


セキュリティ

署名検証

Webhook シークレットを設定すると、CloudThinker が各ペイロードに署名します。
エンドポイントで署名を検証します:

IP 許可リスト

CloudThinker の Webhook は既知の IP アドレス範囲から発信されます。ファイアウォールルールを設定するための最新の IP リストについては、サポートにお問い合わせください。

HTTPS のみ

Webhook URL は HTTPS を使用する必要があります。本番環境では自己署名証明書はサポートされていません。

再試行ロジック

CloudThinker は失敗した Webhook 配信を再試行します。

再試行スケジュール

成功条件

次の場合に配信が成功とみなされます:
  • HTTP 2xx ステータスコード
  • 30秒以内のレスポンス

失敗時の処理

すべての再試行が失敗した場合:
  • イベントは失敗としてマークされる
  • 通知が送信される(設定されている場合)
  • Webhook ログでイベントを確認できる

Webhook の管理

Webhook のテスト

本番稼働前に Webhook 配信をテストします:
  1. 設定で Webhook を選択する
  2. テストイベントを送信 をクリックする
  3. イベントタイプを選択する
  4. 配信ステータスとペイロードを確認する

ログの確認

Webhook のアクティビティを監視します:
  1. 設定 > Webhooks > ログ に移動する
  2. 配信の試行を確認する
  3. リクエスト/レスポンスの詳細を確認する
  4. ステータス、イベントタイプ、日付でフィルタリングする

Webhook の一時停止

Webhook を一時的に無効にします:
  1. Webhook を選択する
  2. 有効 をオフに切り替える
  3. 一時停止中のイベントはキューに蓄積されません

Webhook テンプレート

一般的な連携用のテンプレートを使用します。

Slack

Slack チャンネルにイベントを投稿する:

Jira

CloudThinker イベントから Jira チケットを作成する:

PagerDuty

PagerDuty インシデントをトリガーする:

ベストプラクティス

Webhook シークレットを使用し、リクエストが CloudThinker から発信されたことを確認するために署名を検証してください。
すぐに 2xx レスポンスを返してから、イベントを非同期で処理してください。処理に時間がかかるとタイムアウトが発生します。
Webhook の配信が重複することがあります。イベントの id を使って受信側で重複排除してください。
Webhook の失敗に対するアラートを設定してください。イベントの欠落を防ぐため、問題を迅速に調査して修正してください。
必要なイベントのみ購読してください。ノイズと処理オーバーヘッドを削減できます。

連携例

GitHub Actions

CloudThinker イベントからワークフローをトリガーする:

AWS Lambda

サーバーレス関数で Webhook を処理する:

関連

インシデント Webhook

PagerDuty、Datadog、Prometheus などからの受信 Webhook で RCA を自動トリガーする

タスクとスケジューリング

定期操作のスケジュール設定とイベント駆動ワークフローの作成

通知

推奨事項、インシデント、セキュリティ検出事項のアラートルーティングを設定する

自律エージェント

手動レビューなしに Webhook イベントに基づいてエージェントが自動的に行動する