カスタムHTTP配信
最終更新日 - 02年2026月XNUMX日
カスタムHTTPアラート配信方法(つまり、Webhook)を使用すると、HTTP GETまたはPOSTリクエストを使用してアラート通知データを外部システムに送信できます。カスタムEメールアラート配信と同様に、チケットシステムにアラート通知を送信する場合に有効です。カスタムHTTPアラート配信では、トークン(変数)を使用してアラート通知データの正確な形式を定義できるため、受信側システムで簡単に解析できます。
カスタム HTTP 配信メソッドでは、HTTP POST を使用してリクエスト ペイロードにアラート通知データを配信します。ただし、リクエスト自体にフォーム データが URL に追加されるため、HTTP GET リクエストで十分な場合もあります (たとえば、 https://www.example.com/api?param1=abc&m2=def)、ペイロードをポストする必要はありません。
カスタムアラート配信方法を定義すると、 通知はカスタム配信方法を使用してルーティングされます。カスタム配信方法は、受信者の連絡方法として含める必要があります。 エスカレーションチェーン、およびそのエスカレーションチェーンは、 アラートルール。 これらを構成する場合、ターゲット統合でアラート データが期待どおりにポストおよび更新されるようにするために、従うべきガイドラインがいくつかあります。 詳細については、「」を参照してください。 アラートルール.
カスタムHTTP配信統合の設定要件
カスタムHTTP配信統合を設定するには、以下のものが必要です。
- LogicMonitorでカスタムHTTP配信統合を設定するための十分な権限が必要です。
- DiagnosticSourceおよびRemediationSourceの出力を外部システムと統合するための、自動診断および修復機能のライセンス。
カスタム HTTP 配信統合の追加
- LogicMonitorで、次の場所に移動します 設定 > 統合。
- 選択する 統合の追加.
- ノーザンダイバー社の 統合の追加 ページ、下 ワークフローの統合選択 カスタムHTTP配信.

- 入力します 名前 and 詳細説明 カスタム HTTP 配信統合の場合。
その 名前 フィールドは必須であり、入力した値は 名前 統合リストにフィールドが表示されます。 - まず アラート通知 必要なオプション:
- 同じ URL とデータを使用してさまざまなアラート アクティビティを通知します アラートアクティビティに関するHTTPリクエストを、新規アラートの最初のHTTPリクエストに使用されたのと同じURLに送信します。
- さまざまなアラートアクティビティを通知するために、異なるURLまたはデータ形式を使用します – アラート アクティビティに基づいて、HTTP リクエストをさまざまな URL に送信します。
- 次のいずれかを選択します アラートステータス 通知を送信したい内容。 デフォルトでは、リクエストは次のように送信されます。 新しいアラート.
- 認められた—この状態では、以前に生成され、承認されたアラートを処理します。
- クリアされた—この状態は、それをトリガーしたアラートしきい値を満たしたアラートに適用されます。
- エスカレーション/デエスカレーション—この状態は、アクティブなアラートの深刻度が増減した場合に適用されます。たとえば、アラートが警告からエラーに更新される場合、またはクリティカルからエラーに更新される場合は、この定義が適用されます。エスカレーションされたステータスが選択され、アラートにメモが追加された場合、アラートがアクティブかクリアされているかに関わらず、更新要求が送信されます。エスカレーションされたステータスが選択されておらず、アラートにメモが追加された場合は、要求は送信されません。
注意: アラート ルールとエスカレーション チェーンは、カスタム HTTP 統合にアラート データを配信するために使用されます。 これらを構成する場合、ターゲット統合で期待どおりに通知が投稿および更新されるようにするために従うべきいくつかのガイドラインがあります。 これらのガイドラインについては、アラート統合の概要で説明しています。
- アクションノート—DiagnosticSourceおよびRemediationSourceの出力レポートをアラート通知データとしてHTTPを使用して外部システムに送信できます。
POSTAPIリクエスト。DiagnosticSourceまたはRemediationSourceの実行が完了すると、アクションノートのステータスがトリガーされ、出力レポートが統合システムに送信されます。単一のアラートに対して複数のDiagnosticSourceまたはRemediationSourceがトリガーされた場合、各DiagnosticSourceおよびRemediationSourceは完了時に個別のアクションノートエントリを生成します。統合システムはこれらのエントリをインシデントチケットのノートセクションに追加します。
推奨事項: DiagnosticSource または RemediationSource の出力をシームレスに配信するには、以下を選択してください。 さまざまなURLまたはデータ形式を使用して、さまざまなアラートアクティビティを通知します 通知の種類。
- カスタムヘッダーを追加する場合は、 カスタムヘッダーを使用する 切り替えて、次の操作を行います。
- 選択する レコードを追加 次に値を入力します キー and 値.
- 選択する Apply.
注意: カスタム ヘッダーは、認証資格情報を定義するために使用されます。 Content-Type ヘッダー キーの場合、null として charset 値を追加するか、有効な MIME タイプの charset 値を追加できます。 無効な文字セットまたは MIME タイプを指定した場合、UTF-8 の有効な MIME タイプがデフォルトで追加されます。
- HTTPメソッド フィールドで、必要な方法を選択します。 選択できます HTTPポスト or HTTP 取得.
- URL このフィールドに、HTTPリクエストのURLを指定します。
- 入力する and パスワード 指定されたユーザー名に関連付けられています。
- 認証するには 基本認証、 入る and パスワード 。 HTTP 基本認証は、ユーザー名とパスワードを HTTP ヘッダー内のフィールドとして渡します。
- OAuth 2.0 を使用して認証するには、次を選択します。 OAuth 2.0、選択 交付金の種類 次の情報を希望し、提供します。
- 選択した場合 助成金の種類 as client_credentials、次のフィールドに情報を入力します。
- アクセストークンURL—認証サーバーエンドポイント。資格情報を検証し、アクセストークンを返します。
clientIdandclientSecret有効です。 - 顧客ID—OAuth アプリケーション クライアント ID
- クライアントシークレット—OAuth アプリケーション クライアント シークレット
- 対象領域—アクセス要求の範囲
- アクセストークンURL—認証サーバーエンドポイント。資格情報を検証し、アクセストークンを返します。
- 選択した場合 助成金の種類 as password、次のフィールドに情報を入力します。
- 顧客ID—OAuth アプリケーション クライアント ID
- クライアントシークレット—OAuth アプリケーション クライアント シークレット
- ユーザー名とパスワード—指定されたユーザー名に関連付けられたユーザー名とパスワード
- 対象領域—アクセス要求の範囲。
- 選択した場合 助成金の種類 as client_credentials、次のフィールドに情報を入力します。
- アラートデータ、キーと値のペアまたは生の形式を選択して、アラート メッセージをカスタマイズします。
- 選択する キー/値 ペア選択 レコードを追加、キーを提供します 名前 and 値、次に選択 Apply.
- 選択する Raw選択 トークンの挿入次に、アラートメッセージに使用したいトークンを追加します。利用可能なトークンは以下のとおりです。
- ## ADMIN ##—アラートがエスカレーションされたユーザー。
- ##管理者の電話番号##—管理者の電話番号。
- ##管理者のメール##—管理者のメールアドレス。
- ##管理者ページャー##—管理者のポケットベル番号。
- ## ALERTTYPE ##—アラートの種類(つまり、alert、eventAlert、batchJobAlert、hostClusterAlert、websiteAlert、agentDownAlert、agentFailoverAlert、agentFailBackAlert、alertThrottledAlert)。
- ##アラートステータス##—アラートの状態。
- ##メッセージ##—アラートメッセージのレンダリングされたテキスト。このトークンには、関連する確認済み情報(アラートを確認したユーザー、確認コメントなど)もすべて渡されます。
- ## ALERTID ##—アラートのID。
- ## EXTERNALTICKETID ##これは、統合によって作成されるチケットの外部システムの識別子を取得し、LogicMonitorがそのチケットに対する今後のアクションでそれを参照できるようにします。
詳細については、を参照してください。 LogicModuleアラートメッセージで使用可能なトークン.
注意:
- キーと値のペアを使用してアラートメッセージをカスタマイズする場合、JSON形式のみが利用可能です。ただし、生データを使用してアラートメッセージをカスタマイズする場合は、フォームデータ、JSON、プレーンテキスト、URLエンコードされたフォームデータ、またはXML形式を使用できます。
- デフォルトでは、例として、いくつかのトークンがアラート データ メッセージ セクションに含まれています。 このセクションを編集するには、「トークンの挿入」ボタンを使用してトークンを追加します。
- ##診断ソース出力##— DiagnosticSource の出力を JSON 形式またはプレーンテキスト形式で含めます。アクション ノートにのみ使用してください。
- ##診断ソースステータス##—診断ソースの実行ステータス(成功または失敗)が含まれます。アクションノートにのみ使用してください。
- ##修復ソース出力##—RemediationSourceの出力をJSON形式またはプレーンテキスト形式で含めます。アクションノートにのみ使用してください。
- ##修復状況##—修復ソースの実行ステータス(成功または失敗)が含まれます。アクションノートにのみ使用してください。
- ##メッセージ##—診断ソースまたは修復ソースの名前と実行ステータスが含まれます。
- トグル アラートステータスを更新するときに、HTTP応答で提供されるIDを含めます 新しいアラートに関連付けられた HTTP リクエストに応答して返された ID (チケット ID など) を LogicMonitor で検索する場合にスイッチします。 応答形式は、JSON、正規表現、または XML にすることができます。 LogicMonitor は、確認、クリア、エスカレーション/エスカレート解除されるアラートに対する後続のリクエストでこの ID を使用します。
- 選択する アラート配信のテスト テストアラートとメッセージを送信して、統合が正しく設定されていることを確認します。
- 選択する インポート 統合の詳細を JSON 形式でインポートする場合。
- 選択する Save カスタム HTTP 統合を保存します。
- 統合をキャンセルしたい場合は、 キャンセル.