カスタムHTTP配信
最終更新日: 28 年 2024 月 XNUMX 日カスタムHTTPアラート配信方法(つまり、Webhook)を使用すると、HTTPGETまたはPOSTリクエストを介してアラート通知データを外部システムに送信できます。 カスタム電子メールアラート配信と同様に、これは、アラート通知をチケットシステムに送信する場合に有利です。 カスタムHTTPアラート配信を使用すると、トークン(変数)を使用してアラート通知データの正確な形式を定義できるため、受信者のシステムで簡単に解析できます。
通常、カスタムHTTP配信方法はHTTP POSTを作成し、リクエストペイロードでアラート通知データを配信します。 ただし、リクエスト自体のURLにフォームデータが追加されており(https://www.example.com/api?param1=abc&m2=def)、ペイロードを投稿する必要がないため、HTTPGETリクエストで十分な場合もあります。 。
カスタムアラート配信方法を定義するだけで、 その結果、通知はカスタム配信方法を介してルーティングされます。 カスタム配信方法は、受信者の連絡方法として含める必要があります エスカレーションチェーン、およびそのエスカレーションチェーンは、 アラートルール. これらを構成する場合、アラート データがターゲット統合で期待どおりに投稿および更新されるようにするために従うべきいくつかのガイドラインがあります。 詳細については、次を参照してください。 アラートルール.
カスタムHTTPアラート配信
[設定] | [設定] から、既存のカスタム HTTP アラート配信を追加および/または構成できます。 統合。 選択する Add 次に、カスタム HTTP 配信:
お名前
カスタムHTTPアラート配信テンプレートの名前。
Description
カスタムHTTPアラート配信テンプレートの説明。
リクエストは別のURLに送信されますか?
同じURLとデータを使用して、さまざまなアラートアクティビティについて通知します
このオプションは、アラートの確認、クリア、および/またはエスカレーション/エスカレーション解除の HTTP リクエストを、新しいアラートの最初の HTTP リクエストが送信されたのと同じ URL に送信します。
さまざまなアラートアクティビティを通知するために、異なるURLまたはデータ形式を使用します
このオプションは、アラートステータスに基づいて異なるURLにHTTPリクエストを送信します。
どのアラートステータスがHTTPリクエストをトリガーする必要がありますか?
HTTP リクエストをトリガーするアラート ステータスを選択します。 新しいアラートのリクエストが送信されます。さらに、アラートの確認、クリア、およびエスカレーション/エスカレーション解除のために送信することもできます。
- 新しいアラート: この状態は新しい、アクティブなアラートが必要です。
- 認められた: この状態は、以前に生成された、確認済みのアラートを処理することを目的としています。
- クリアされた: アクティブなアラートが、それをトリガーしたアラートのしきい値を満たすと、この状態が作成された HTTP 要求を制御します。
- エスカレーション/デエスカレーション: アラートの重大度が増減するアクティブなアラートを処理するために予約されています。 たとえば、警告からエラー、またはクリティカルからエラーに更新されるアラートは、この定義を使用します。
ご注意: アラート ルールとエスカレーション チェーンは、カスタム HTTP 統合にアラート データを配信するために使用されます。 これらを構成する場合、ターゲット統合で期待どおりに通知が投稿および更新されるようにするために従うべきいくつかのガイドラインがあります。 これらのガイドラインについては、アラート統合の概要で説明しています。
リクエストごとに、HTTP リクエストをトリガーするアラート ステータスを選択できます。 要求は、新しいアラート (ステータス: アクティブ) のために送信され、アラートの確認 (ステータス: 確認済み)、クリア ステータス: クリア済み)、およびエスカレーション/エスカレーション解除/メモの追加 (ステータス: エスカレート済み) のために送信することもできます。
ご注意: エスカレーションされたステータスが選択され、アラートにメモが追加された場合、アラートがアクティブ/クリアされているかどうかにかかわらず、更新要求が送信されます。 エスカレーションされたステータスが選択されておらず、アラートにメモが追加されている場合、リクエストは送信されません。
HTTPメソッド
HTTP 要求に使用される HTTP メソッド。 オプションは POST と GET です。
カスタムヘッダーを使用する
このボックスを選択すると、ヘッダーキーとヘッダー値を追加するための新しい構成フィールドが表示されます。
カスタムヘッダーは、認証資格情報を定義するために使用されます。
コンテンツタイプ ヘッダー キーに、charset 値を null または有効な MIME タイプの charset として追加できます。 無効な文字セットまたは MIME タイプを指定すると、UTF-8 の有効な MIME タイプがデフォルトで追加されます。
URL
必要に応じて、特定の URL への HTTP 要求が送信される URL。
パスワード
指定されたユーザー名に関連付けられたパスワード。
アラートデータ
Raw
HTTP 要求は、生データ形式を使用してカスタム アラート通知メッセージを配信します。 フォーマットするメッセージを選択します: フォーム データ、JSON、プレーン テキスト、URL エンコードされたフォーム データ、または XML。
キー/値のペア
HTTPリクエストは、キーと値のペアを使用してフォーマットされたカスタムアラート通知メッセージを配信します。 このオプションを使用すると、メッセージの形式はJSONに制限されます。 アラート通知メッセージに含めるXNUMXつ以上のJSONキー/値のペアを追加できます。
あなたが使用することができます トークン この分野で。
HTTP応答形式
LogicMonitor が応答で提供された ID を使用する場合は、応答の形式を選択します。JSON、正規表現、解釈なし、および XM から選択します。
利用可能なトークン
次のトークンを使用できます。
- 以下にリストされているLogicModule固有のアラートメッセージトークン LogicModuleアラートメッセージで使用可能なトークン.
- ## ADMIN ##. アラートがエスカレートされたユーザー。
- ## メッセージ##. アラート メッセージのレンダリングされたテキスト。 このトークンは、関連するすべての確認済み情報 (アラートを確認したユーザー、コメントの確認など) も渡します。
- ## ALERTTYPE ##. アラートのタイプ (つまり、アラート、eventAlert、batchJobAlert、hostClusterAlert、websiteAlert、agentDownAlert、agentFailoverAlert、agentFailBackAlert、alertThrottledAlert)。
- ## EXTERNALTICKETID ##. これにより、統合によって作成されているチケットの外部システムの識別子がキャプチャされ、LogicMonitor がそのチケットの今後のアクションでそれを参照できるようになります。
アラートステータスを更新するときに、HTTP応答で提供されるIDを含めます
LogicMonitorで、新しいアラートに関連付けられたHTTPリクエストに応答して返されたID(チケットIDなど)を検索する場合は、このオプションをオンにします。
LogicMonitorは、アラートの確認応答、クリア、およびエスカレーション/デエスカレーションの後続の要求でこのIDを使用します。
アラート配信のテスト
このオプションは、テストアラートを送信して応答を提供し、統合が正しく構成されているかどうかをテストできるようにします。
例
上記の例では、カスタム HTTP 配信方法を使用して LogicMonitor を LogicMonitor 認定プラットフォームと統合し、カスタム データソースがユーザー スコアを監視します。 ユーザーが試験に不合格になると、コース データはリセットされます。 アラートがクリアされると、ユーザーは試験から登録解除され、別の受験を購入する必要があります。