サードパーティアプリケーションの IO アラート通知の設定
インスタンスオブサーバー (IO) とサードパーティの統合間の基本的な統合を設定して、IOアラート通知をメールと SMS に加えて外部システムにルーティングします。
始める前に
必要なロール:admin
重要:
サードパーティ統合は、規制市場ではサポートされていません。
このタスクについて
注:
サードパーティ統合は、 Slack、 Microsoft Teams、 AWS、 GCP、 Azure などのプラットフォームをサポートします。
サードパーティ統合の場合、サブスクリプションが更新されない場合、Webhook URL が期限切れになったり、時間の経過とともに API キーが無効になったりする可能性があります。アラートの配信を見逃さないように、統合認証情報を最新の状態に維持してください。
手順
- 移動先 影響 > プラットフォームヘルス > 監視 > Instance Observer に移動.
- インスタンスオブサーバーにログインし、次に移動します: アラート > 通知の設定.
- [ + 統合を作成] を選択します。
-
フォームで、フィールドに入力します。
サードパーティ統合の場合は、次のように入力します。
表 : 1. [統合を作成] フォーム フィールド 説明 統合タイプ サードパーティ。デフォルトでは ServiceNow が選択されています。 統合名 統合を識別する名前。 認証タイプ 統合用のベーシック認証または API キー。 [API キー] には、統合のキーまたはユーザー名とパスワードを入力します。
ユーザー名 統合に関連付けられたユーザー名。 パスワード 統合用のパスワード。 URL を入力 サードパーティ (外部) アプリケーションで構成された Webhook URL。 詳細については、「」を参照してください。
-
[ 統合のテスト ] を選択して構成を検証し、構成されたアプリケーションにペイロードを正常に送信できるかどうかを確認します。
正しい URL の詳細が手元にない場合は、統合を ドラフト として保存し、後で完了するために戻ることができます。
- テストが成功すると、 HTTP 応答「200 が成功」 という応答が返されます。これで、統合の送信に進むことができます。
- テストに失敗した場合は、エラーメッセージが赤色で表示されます。Webhook URL、ユーザー名、パスワードなどの統合の詳細を確認して修正し、もう一度テストしてください。重要:統合を送信する前に、テスト結果が正常である必要があります。テストせずに送信しようとすると、「テスト に成功しました 統合結果 (Successful Test Integration)」という検証メッセージが表示されます。統合を送信するか、有効な URL がない場合はドラフトとして保存してください。
-
統合を送信し、テストが成功したら保存します。
統合は [有効] ステータスで作成されます。
-
統合ステータスを確認します。
[ 統合 ] タブで、統合ステータスが [有効] と表示されていることを確認します。注:[通知ルール] タブには、[有効] ステータスの統合のみが表示され、通知ルールにリンクされます。ドラフト統合は、完了して有効になるまで選択できません。
-
サードパーティ統合の通知ルールを設定し、サードパーティアプリケーションにアラートを送信するには、[ 通知ルール ] タブを選択します。
-
通知ルールの省
を選択し、[ 編集] オプションを選択します。
- [ルールの編集] ポップアップの [ 名前 ] フィールドにルールの名前を入力します。
- 通知ルールの説明を入力します。
- [通知タイプ] として [サードパーティ統合] オプションを選択し、リストから値を選択します。
- [Save (保存)] を選択します。
-
通知ルールの省
-
次に移動して 、アラートコンソール でアラートペイロード配信を確認します アラート > アラートコンソール.
アラートがトリガーされた後に統合が正しく機能していることを確認するには、次の手順を実行します。
- インスタンスを選択し、アラートコンソールで [スナップショットを取得] を選択します。
-
[ テストアラートを生成 ] リストから、構成したアラートを選択します。
構成したテストアラートがリストに表示されます。たとえば、インスタンスの データベース応答時間 アラートなどです。
-
アラートペイロードが、構成された統合エンドポイント (サードパーティインスタンス) に正常に配信されていることを確認します。
Webhook URL が HTTP 呼び出しを受け入れる限り、アラートペイロードはサードパーティインスタンスに到達します。
-
指定されたペイロードのアラートが意図した宛先に到達したかどうかを確認します。
アラートが失敗した場合は、 アラートタイプ が赤色で表示され、これはアラートが失敗したことを意味します。失敗した セルフサービス アラートアイコンを選択すると、「 サードパーティ統合 – 失敗」というメッセージが表示されます。
-
[統合を編集] ポップアップで URL を表示、編集、または削除するには、次に戻ります アラート > 通知の設定 をクリックし、省[ 編集] オプションを選択すると、統合設定を更新できます。統合が少なくとも 1 つの通知ルールに関連付けられている場合、[ 削除] オプションは非アクティブのままです。
-
統合の失敗を特定して解決します。
有効期限が切れている Webhook URL、無効な API キー、または期限切れの認証情報などが原因で統合が失敗した場合、 IO は失敗を検出し、注意を喚起するフラグを立てます。失敗した統合を特定して解決するには:
- アラートコンソールで、[アラートタイプ] 列の下に赤色で表示されているアラートを探します。赤色のインジケーターは、アラートペイロードが通知を配信できなかったことを意味します。
- [ 失敗 ] リンクを選択すると、エラーの詳細をすべて表示できます。たとえば、URL が無効であるか、API キーの有効期限が切れていることを示す 404 エラーなどです。
- [ 統合を更新 ] を選択して、正しい認証情報または Webhook URL で統合を編集し、正常にテストし、再送信して統合を [有効] ステータスに復元します。
- または、 アラート > 通知の設定をクリックし、[ 統合] タブで [失敗] ステータスの統合を選択します。統合構成を編集し、統合をテストし、成功した場合は再送信して統合を [有効] ステータスに復元します。
統合が少なくとも 1 つの通知ルールに関連付けられている場合、[ 削除] オプションは非アクティブのままです。
重要:統合が修正されて再度有効になるまで、アラートペイロードは障害が発生したエンドポイントに配信されません。- IO アラート通知チャネル
-
統合の失敗は、次の 3 か所でアラートとして表示できます。
- の アラートタイプ として アラート > アラートコンソール
- ベル
からの通知として 。[ 通知履歴を表示 ] を選択し、[ 統合に失敗しました] でフィルタリングします。
- 統合名、エラー番号、およびメッセージを含むメール通知として。