Ops Manager での Webhook との統合

必要なアクセス権

Ops Manager を Webhook と統合するには、プロジェクトへのProject Monitoring Admin アクセス権が必要です。

Webhook 統合の構成

Webhook にアラートを送信するには、アラート通知を構成します。詳細については、「 Ops Manager でのアラート設定の構成 」を参照してください。

リクエストヘッダー

MongoDB Ops Manager には、 Webhookリクエストごとに次のHTTPヘッダーが含まれています。

MongoDB Ops Manager は、さまざまなアラート状態を区別するためにX-MMS-Eventというリクエスト ヘッダーを追加します。 このヘッダーに指定できる値は次のとおりです。

Webhook Secretフィールドにキーを指定すると、 MongoDB Ops Manager はX-MMS-Signatureリクエストヘッダーを追加します。このヘッダーには、リクエスト本文の base64 エンコードされた HMAC -SHA-1 署名が含まれています。 MongoDB Ops Manager は、提供されたシークレットを使用して署名を作成します。

リクエスト本文

リクエストボディには、 Ops Manager APIアラートリソースと同じ形式を使用するJSONドキュメントが含まれています。ペイロードには、次のようなキー フィールドが含まれます。

• id: アラートの一意の識別子です。

• eventTypeName: アラートをトリガーするイベントの種類。

• created: アラートが作成されたタイムスタンプ。

• status:アラートの現在のステータス（例: 、OPEN、CLOSED）。

• humanReadable:アラートの人間が判読可能な説明 。

フィールドの完全なリストについては、 Get One Alert エンドポイントのドキュメント を参照してください。

{
  "id": "5d1b6f8e8c2e4e2d3c4a5b6c",
  "groupId": "5d1b6f8e8c2e4e2d3c4a5b6d",
  "eventTypeName": "OUTSIDE_METRIC_THRESHOLD",
  "status": "OPEN",
  "created": "2024-01-15T10:30:00Z",
  "updated": "2024-01-15T10:30:00Z",
  "lastNotified": "2024-01-15T10:30:00Z",
  "humanReadable": "Disk space used on data partition is
    95.2%.",
  "metricName": "DISK_PARTITION_SPACE_USED_DATA",
  "currentValue": {
    "number": 95.2,
    "units": "RAW"
  }
}

Webhook テンプレートをカスタマイズする

Free テンプレートを使用して、リクエストヘッダーとボディ コンテンツをカスタマイズできます。使用可能なテンプレート変数、正規表現ヘルパー、例など、Webhook テンプレートの詳細については、「 Webhook テンプレートの構成 」を参照してください。

Webhook リクエストの認証

Webhook Secretフィールドには、 MongoDB Ops Manager がリクエスト検証用の X-MMS-Signature ヘッダーを生成するためにのみ使用するシークレットが保存されます。 MongoDB Ops Manager は、認証ヘッダーまたはベアラー トークンとしてシークレットを直接送信しません。

ウェブフックエンドポイントで認証が必要な場合は、次のいずれかの方法を使用して独自に取り扱う必要があります。

• クエリパラメータ: Webhook URLにクエリパラメータとして認証情報を含めます。例: https://example.com/webhook?token=your-auth-token

• IPアクセス リスト: MongoDB Ops Manager インスタンスのIPアドレスからのリクエストのみを受け入れるように Webhook エンドポイントを設定します。

• 逆プロキシまたはAPIゲートウェイ: Webhook エンドポイントにリクエストを転送する前に認証を処理するリバース プロキシまたはAPIゲートウェイを使用します。

制限

ウェブフック統合を使用する場合は、次の制約事項を考慮してください。

ファイアウォール構成

Ops Manager はセルフホスト型であるため、Ops Managerサーバーから Webhook エンドポイントへのアウトバウンドHTTPリクエストがネットワークで許可されていることを確認してください。 Webhook エンドポイントがファイアウォール の背後にある場合は、Ops Manager サーバーのIPアドレスをエンドポイントのIP アクセス リストに追加します。

Webhook配信の問題のトラブルシューティング

ウェブフックがアラートを受信しない場合: