統合のタイプとアクションとは

統合フレームワークにより、Opsgenie のアラート機能を最も人気の IT、運用管理、監視ツールと連携して動作させられます。Opsgenie は、メールと API を通じてこれらのツールと通信し、送信するデータに応じてアラートを処理できます。統合により、強力なアラートと通知システムを使用して、日常の監視サービスを拡張できます。Opsgenie は GitHub、New Relic、ServerGuard24 などのサービスと統合されています。

Opsgenie は堅牢なフレームワークを提供し、Opsgenie をすべての運用管理ツールと統合できます。Opsgenie はメールと API を通じて、ツールと通信できます。

Opsgenie 統合の完全なリストを表示する

統合タイプ

API ベースの統合

アラート目的で、多くの監視ツールから Opsgenie にイベントを転送できます。Opsgenie では、通知 Webhook をキャッチして処理し、通知データに基づいて十分な情報を得たアラートを作成できます。この機能を使用すると、Opsgenie が任意の HTTP リクエストを処理できるほか、監視ツール用に特別に構成された多くの API ベースの統合も使用できます。たとえば、Raygun のお客様の場合は、Opsgenie の Raygun 統合を使用して、Raygun でのイベントに応じて Opsgenie でアラートを自動で作成/クローズできます。

双方向の統合

双方向の統合によって、Opsgenie と他のアプリ間の双方向でデータを送信/処理できます。ServiceNow 統合を具体例として挙げると、ServiceNow はインシデント イベントを詳細情報とともに Opsgenie に送信します。さらに、Opsgenie はアラートをインシデントとして ServiceNow に転送します。

発信インテグレーション

Opsgenie 統合フレームワークには、Opsgenie イベントをチャット アプリに通知できるコールバック機能があります。発信統合の具体例としては、URL エンドポイントを介して情報をプッシュする Webhook 機能があります。

メール ベースの統合

Opsgenie のメール統合によって着信メールを処理し、アラートを管理できます。この統合は、あらゆる種類のメールを受け入れます。また、完全にカスタマイズ可能であるため、ご利用の受信トレイに合わせた堅牢なアラート メカニズムを制御できます。Opsgenie には、Pingdom、Uptime Robot、Zenoss など、いくつかの監視ツール用の特定のメール ベースの統合もあります。たとえば、Pingdom をご利用の場合は、Opsgenie の Pingdom 統合を追加して、Pingdom イベントを Opsgenie アラートに簡単に変換できます。

統合アクション

さまざまなアラート シナリオに対応するように、統合ではより高度な設定を行えます。こうしたシナリオは「アクション」と呼ばれて、アラートの作成、クローズ、承認などの方法とタイミングを指定します。Opsgenie は統合ごとに既定のアクションを提供しますが、カスタマイズや独自のアクションの追加も自由に行えます。たとえば、「アラートを作成」アクションを 3 つ設定することもできます。この場合は、Opsgenie の Webhook データがこれらの 3 つのシナリオに対して順に評価され、そのうちの 1 つのルールに一致すれば、新しいアラートが作成されます。

アクション処理

アクションは特定の順序で評価されます。たとえば「無視」アクションは設計上、最初に評価され、「メモを追加」アクションは最後に評価されます。これは、受信データが「無視」アクションに対して評価され、そのうちの 1 つが一致した場合、それ以上のアクションは評価されずに「無視」アクションのみが処理されることを意味します。

アクションの評価順序は次のとおりです。
「無視」 > 「アラートを作成」 > 「アラートをクローズ」 > 「アラートを承認」 > 「アラートにメモを追加」

アラートを無視する

「無視」アクションとは、Webhook データがアクションのフィルターと一致する場合は完全に無視され、その他のアクションによって評価されないことを意味します。「無視」アクションに既定のルールはありません。これらは、Webhook データが Opsgenie に届いたときに最初に処理されるアクションです。

1. 「統合の設定」ページに移動します。

2. [受信] セクションで [ルールを追加] を選択します。

   1. [アラート ルールを追加] ダイアログで、ルールの名前を入力します。

   2. [ルール タイプ] には「アラートを作成」を選択します。

   3. 必要に応じてフィルターを設定します。

   4. [保存] を選択します。

3. If incoming webhook data matches the condition set of the filter, the ignore action is processed, thus, the data will be ignored. Learn more about action filters.

アラートの作成

「アラートを作成」アクションでは、フィルターの条件セットが受信データと一致する場合、Opsgenie アラートが作成されます。アラートを作成するタイミングに関する条件を指定して、新しいアラートの内容を完全にカスタマイズしましょう。

「統合の設定」ページに移動します。

1. [受信] セクションで [ルールを追加] を選択します。

2. [アラート ルールを追加] ダイアログで、ルールの名前を入力します。

3. [ルール タイプ] には「無視」を選択します。

4. 必要に応じてフィルターを設定します。

5. 必要に応じてアラート プロパティを定義します。

6. [保存] を選択します。

アラート フィルター

If the data that's sent to Opsgenie matches the condition set in this filter, the 'Create alert' action is processed to create an alert. Learn more about action filters.

アラート プロパティ

アラート プロパティは、Opsgenie アラートの内容を定義するデータです。フリー テキストによるアラートの説明の入力や、優先度付けを実行できます。右側のパネルから動的フィールドをドラッグ アンド ドロップすることもできます。既定では、"アラート プロパティ" フィールドが数件のみ表示されます。[さらにプロパティを表示] を選択すると、すべて表示されます。

• アラート メッセージ: アラートのタイトル。130 文字まで入力できます。

• エイリアス: 「オープン」アラートの一意の ID。
  Opsgenie では、同じエイリアスを持つオープン アラートは 1 つしか存在できません。

• 説明: アラートの詳細な説明。"メッセージ" フィールドに収まらないものはすべてここに入力できます。

• アクション: 受信者がアラートに応答するために実行できるアクションのリスト。
  複数のアクションがある場合は、間にコンマを使用します。

• タグ: アラートの識別と分類を容易にするためのラベル。
  複数のタグがある場合は、間にコンマを使用します。

• Details > Extra properties: Additional properties of the alert. Enter the name of a property in the first field and its value in the second.

• エンティティ: アラートが関連付けられているエンティティの名前。
  たとえば、アプリまたはサーバーの名前です。

• 優先度: アラートの優先度。たとえば、P1、P2 などです。

• ユーザー: アラートに追加されるメモの所有者。

• ソース: アラートのソース。

• メモ: アラートに追加されるメモ。

Close Alert (アラートのクローズ)

「アラートをクローズ」アクションは、データがフィルターの条件セットと一致する場合、そのエイリアスに基づいて既存の Opsgenie アラートをクローズします。アクション フィルターの詳細をご確認ください。

アラート プロパティ

エイリアスは、このアクションの必須フィールドです。「アラートをクローズ」アクションが処理されると、Opsgenie は「オープン」アラートを検索してクローズします。そのエイリアスは、このアクションで指定されたエイリアスと同等です。

• エイリアス: 「オープン」アラートの一意の ID。
  Opsgenie では、同じエイリアスを持つオープン アラートは 1 つしか存在できません。

• ユーザー: アラートに追加されるメモの所有者。

• メモ: アラートに追加されるメモ。

Acknowledge Alert (アラートの承認)

「アラートを承認」アクションは、データがフィルターの条件セットと一致する場合、そのエイリアスに基づいて既存のアラートを承認します。アクション フィルターの詳細をご確認ください。

アラート プロパティ

エイリアスは、このアクションの必須フィールドです。「アラートを承認」アクションが処理されると、Opsgenie は「オープン」アラートを検索して承認します。そのエイリアスは、このアクションで指定されたエイリアスと同等です。

• エイリアス: 「オープン」アラートの一意の ID。
  Opsgenie では、同じエイリアスを持つオープン アラートは 1 つしか存在できません。

• ユーザー: アラートに追加されるメモの所有者。

• メモ: アラートに追加されるメモ。

Add Note to Alert (アラートへのメモの追加)

「アラートにメモを追加」アクションは、Opsgenie API が受信するデータに従って、既存のアラートにコメントを追加します。このアクションが処理されると、Opsgenie はこのアクションで指定されたエイリアスと等しいエイリアスのアラートを検索して、それにメモを追加します。このアクションには、"エイリアス" フィールドと "メモ" フィールドの両方が必須です。

• エイリアス: アラートの一意の識別子。

• ユーザー: アラートに追加されるメモの所有者。

• メモ: アラートに追加されるメモ。

アクションの順序を変更する

同じタイプのアクションも順番に評価されますが、その順序は変更できます。たとえば、CreateAlert1、CreateAlert2、CreateAlert3 という順序で、「アラートを作成」アクションが 3 つあるとします。CreateAlert3 をドラッグして上に移動するだけで、CreateAlert3、CreateAlert1、CreateAlert2 の順序に変更できます。ルールを保存すると、CreateAlert3 が他の 2 つよりも先に受信データに対して評価されるようになります。CreateAlert3 のフィルターにデータが一致すると、CreateAlert1 と CreateAlert2 が評価されます。1 つの受信リクエストに対して実行されるアクションは 1 つだけであることにご注意ください。