• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

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

Opsgenie の統合フレームワークによって、Opsgenie のアラート機能は最も一般的な監視ツールと連携して動作できます。Opsgenie は、メールと API を通じて、これらのツールと通信し、送信するデータに従ってアラートを処理できます。Opsgenie の統合により、強力なアラートと通知システムを使用して、日常の監視サービスを拡張できます。Opsgenie が統合するサービスには、Rackspace、New Relic、Circonus などが含まれます。

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

Opsgenie 統合の完全な一覧を表示します。

Opsgenie アカウントの所有者がメールをまだ確認していない場合、組織内のユーザーは API インテグレーションを使用できるようになりません。

統合タイプ

Opsgenie 統合フレームワークは、さまざまなタイプの統合を操作できます。

API ベースの統合:

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

Opsgenie アカウントの所有者がメールをまだ確認していない場合、組織内のユーザーは API インテグレーションを使用できるようになりません。


双方向の統合

Opsgenie の双方向の統合によって、Opsgenie と他のアプリケーション間の双方向でデータを送信して処理できます。良い例として、ServiceNow インテグレーションがあります。ServiceNow はこの統合を使用して、インシデント イベントを詳細情報と併せて Opsgenie に送信して、Opsgenie はアラートをインシデントとして ServiceNow に転送します。

発信インテグレーション

Opsgenie 統合フレームワークには、Opsgenie イベントについてチャット アプリケーションに通知できるコールバック機能があります。優れた発信インテグレーションの例として、URL エンドポイントを介して情報をプッシュする Webhook 機能があります。この情報はカスタマイズできないことにご注意ください。

メール ベースの統合

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

統合の詳細設定

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

アクション処理

最初に評価されるアクションのタイプには、特定の順序があります。たとえば、設計上、無視アクションが最初に評価され、メモの追加アクションは最後に評価されます。つまり、受信データが無視アクションに対して評価され、そのうちの 1 つが一致すると、メモの追加アクションと他のアクションもまったく評価されず、その無視アクションのみが処理されます。

アクション タイプが評価を表す順序は次のとおりです。

  • ignore

  • アラートの作成

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

  • Acknowledge Alert (アラートの承認)

  • メモの追加

統合のそれぞれに最大 255 のアクションを設定できます。

新しい統合フレームワークを使用している場合は、最大 250 の着信自動化ルールと最大 50 の送信自動化ルールを設定できます。

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

アクション順序で行った変更はすべて、[Save All Changes (すべての変更を保存)] をクリックした後にのみ有効になります。

利用可能なアクションについては、以下で詳しく説明します。

無視アクション

無視アクションとは、Webhook データがアクションのフィルターと一致する場合は完全に無視され、その他のアクションによって評価されないということです。無視アクションは、Opsgenie が Webhook データを取得する際に最初に処理されるアクションです。

統合の詳細設定ページから、右側の [アクション] で、[Ignore (無視)] の横にあるプラス記号をクリックします。これにより、新しい無視アクションが開きます。無視アクションには、[フィルター] というタブが 1 つあることがわかります。Webhook データがこのフィルターの条件セットと一致する場合、無視アクションが処理され、データは無視されます。フィルターについての詳細は、アクション フィルターをご確認ください。

[Save Integration (統合を保存)] をクリックしないと、このアクションと行ったカスタマイズは保存されません。


アラートの作成

アラートの作成アクションでは、フィルターの条件セットがデータと一致する場合に新しい Opsgenie アラートが作成されます。アラートが作成されるタイミングの条件を指定できるだけでなく、アラートの情報の種類、場所、そのフォーマットなどを完全にカスタマイズすることもできます。

これを詳細に表示するには、[Actions (アクション)] の [Create Alert (アラートの作成)] の横にあるプラス記号をクリックします。これにより、空の [アラートの作成] アクションが開きます。[アラートの作成] アクションには、3 つのタブがあります ([フィルター] と 2 つの [アラート フィールド] タブ)。

フィルター

Opsgenie に送信されるデータがこのフィルターの条件セットと一致する場合、この「アラートの作成」アクションが処理され、Opsgenie アラートが作成されます。フィルターについての詳細は、アクション フィルターをご確認ください。

アラート フィールド

アラート フィールドは、Opsgenie アラートが構成されるデータを構成しています。設定できるフィールドについては、以下で説明します。テキストを記述したり、右から動的フィールドをドラッグして使用したりできます。ドラッグ可能なフィールドの詳細については、動的フィールドを参照してください。



統合設定でのドラッグ可能なフィールドを示す画像。
  • メッセージ: 130 文字までのアラート テキスト。

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

  • 受信者: 通知する相手を決定するために使用する必要がある、ユーザー、グループ、エスカレーション、スケジュールの名前。注: [アラートの作成] アクションでは、[メッセージ] および [受信者] フィールドは必須です。

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

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

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

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

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

  • 追加プロパティ: 追加のアラートのプロパティ。最初のフィールドにプロパティの名前を入力し、2 番目のフィールドに値を入力します。

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

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

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

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

アラート フィールド

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

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

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

Acknowledge Alert (アラートの承認)

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

アラート フィールド

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

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

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

メモの追加

[メモの追加] アクションは、Opsgenie API が受信するデータに従って、既存のアラートにコメントを追加するために使用します。[メモの追加] アクションが処理されると、Opsgenie は [メモの追加] アクションで指定されたエイリアスと同等のエイリアスを使用して、メモを追加するアラートを検索します。

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

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

その他のヘルプ