• 使用を開始する
  • 関連ドキュメント

統合フレームワーク

概要

Opsgenie 統合は、Opsgenie アカウントと IT 環境にあるその他のアプリ間の接続です。接続すると、すべてが Opsgenie で一元管理された IT アプリからアラートを受け取り、作成されたアラート バケットにもアクセスできます。統合ごとにカスタム自動化ルールを作成して、データを更新、編集したり、接続したアプリをトリガーすることによってカスタム アクションを実行したりできます。

エクスペリエンスの新機能

Opsgenie の最新バージョンには、統合のインストールと構成が極めて簡単になり、より柔軟な機能を提供する新しい統合フレームワークが導入されています。古い統合エクスペリエンスから新しい統合エクスペリエンスへの変更点を、次の表でご確認ください。

古いエクスペリエンス

新しいエクスペリエンス

接続の設定

初期接続設定とその他の設定ステップは、どちらも最初に完了する必要がありました。

初期設定とルール設定は、2 つのステップに分かれています。ルールの設定に進む前に、接続の設定という主要なステップに集中して完了できます。

ルールを設定するためのガイダンス

統合ルールには十分なヘルプやガイダンスがなく、あまりにも多くの場所に散在していました。

接続を設定したら、次のステップで受信ルールと送信ルールを同時に作成できます。これらのルールによって必ず接続が正しく機能するようになり、状況に応じたガイダンスが得られます。どちらのセクションにも、統合に固有の設定に役立つ [詳細] リンクがあります。

ルールの設定と編集

送信ルールは、指示、認証設定、接続設定でグループ化されている一方、受信ルールは[高度な設定] タブに隠されていました。

高度な受信ルールは、送信ルールとともにメイン設定エリアにあり、すべてシンプルで統一されたデザインで利用できます。ルール編集モーダルは、追加機能をサポートするように改善されました。

認証設定

統合の送信部分の認証設定は、同じページの送信設定、ルール、指示、その他の設定と組み合わされました。

統合と認証の設定は、[Integration settings (統合設定)] セクションでまとめて確認できます。送信ルールが機能するためには認証設定が必要であることを知らせる警告メッセージが表示されます。

ルールは特定の設定ページで設定できます。認証設定のような 1 回限りの設定は、通常 1 回しか実行する必要がないので、[Integration settings (統合設定)] セクションにあります。設定ページは、純粋にルールを設定するためのものです。

設定した統合のリスト

すでに設定されている統合のリストには、十分な情報がありませんでした。たとえば、通知のステータスが明確ではなく、対応者チーム列にチーム情報が繰り返し表示されていました。

新しいバージョンでは、統合のステータスを表示する際にかなりの改善が加えられています。有効/無効の代わりに、オン/オフ ステータス (より包括的な記述) が表示されるようになり、統合のリストを以前よりも多くの方法でフィルタリングできるようになりました。通知のステータスが見やすくなり、対応者チーム列はグローバル統合でのみ表示されるようになりました。

統合を追加する

  1. [設定] > [統合] の順に移動します。

  2. [統合の追加] を選択します。

  3. 検索を実行して、対象のアプリを選択します。

  4. 次の画面で、統合の名前を入力します。

  5. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。

  6. [Continue] を選択します。
    この時点で、統合が保存されます。

  7. 次のページで、[統合を設定する手順] セクションを展開します。

  8. 該当する場合は、指示に従って一方の端 (受信統合または送信統合の場合) または両端 (双方向統合の場合) の統合を設定します。

  9. アラートの作成と処理に関するルールを定義し、アラートに対してアクションを実行するためのアクションを定義します。

  10. [統合をオンにする] を選択します。
    統合のために作成したルールは、統合をオンにした場合にのみ機能します。

統合のルールを定義する

Opsgenie では、次の 2 つのルール セットを提供しています。

  • 統合の受信部分: アラートの作成と処理のルールを定義する

  • 統合の送信部分: 統合されたアプリでアクションを実行するためのルールを定義する

受信 | アラートの作成と処理のルール

これらのルールは、Opsgenie が統合アプリからデータを受信したときの動作を定義します。つまり、統合アプリで発生したイベントによってトリガーされたときに、Opsgenie の新規または既存のアラートの動作を自動化する方法です。アラートを承認または更新する、アラートにメモを追加する、アラートを閉じる、アラートを作成することができます。

最初に統合を作成すると、既定でいくつかのルール (アラートを作成する、アラートを閉じる、アラートを承認する、アラートにメモを追加) が使用可能になります。これらのルールをオフにしない限り、統合をオンにすると直ちに動作を開始します。

受信ルール タイプ

アラートを作成する: このオプションを選択すると、事前定義されたアクションが統合アプリで発生するたびにアラートが作成されます。たとえば、アプリで発生したインシデントに対するアラートの作成や、インシデントのステータスが変化したときのアラートの作成が可能です。アクションごとに、Opsgenie が作成するアラートをカスタマイズできます。アクション フィルターの詳細をご確認ください

アラートを閉じる: 統合アプリで事前定義されたアクションが発生するたびにアラートを閉じます。

アラートを承認する: 統合アプリで事前定義されたアクションが発生するたびにアラートを承認します。

アラートにメモを追加する: 統合アプリで事前定義されたアクションが発生するたびに、アラートにメモを追加します。

無視: アラートを受信しないアクションには、このオプションを選択します。

これらのルールに基づいて統合を設定し、要件に応じてアラート フィールドを変更できます。アラートのプロパティは、各ルール タイプの機能に応じて異なります。動的フィールドの詳細をご確認ください

受信セクションで既定のルールを編集したり、ルールを追加したりできます。ルールを設定して統合をオンにすると、Opsgenie は設定された順序でルールを上から下に適用します。最初のルールが "無視" アクションで 2 番目のルールが "アラートを作成する" であり、統合アプリから受信したデータがどちらのルールの条件にも一致する場合、Opsgenie は最初に一致する "無視" アクションで停止します。アラートは作成されません。

送信 | 統合アプリでアクションを実行するためのルール

送信セクションのルールは、Opsgenie のアラートが統合アプリに与える影響を定義します。送信セクションでは、次の 2 種類のルールを作成できます。

アラート更新を統合アプリに送り返す

統合アプリのデータを更新するには、このルール タイプを選択します。フローは次のようになります。

  1. 受信セクションのルールによって、統合アプリに発生した何らかのイベントについて Opsgenie でアラートが作成されます。

  2. アラートの一部が Opsgenie で変更されます。

  3. Opsgenie はこの更新を統合アプリに送り返し、関連するエンティティを更新します。

このセクションでは、統合されたアプリで実行されるアラート アクションとそれに対応するアクションを自然言語で示します。「アラートにタグが追加される」などの一部のアクションを正しく実行するには、ユーザー入力が必要な場合があります。入力フィールドを空白のままにすると、ルールはすべての値に適用されます。入力を制限する場合は、値を手動で入力して Enter キーを押します。これはアラートにタグを追加する方法と同様です。

手動で作成したアラート、またはその他の統合によって作成されたアラートのアクションを定義する

Select this rule type to define actions for alerts that are either manually created or by other integrations you have set up in Opsgenie. However, with this option, you’re taking actions in an integrated application against alerts you received from your other integrated tools.

フィルターを作成して、このルールを適用するアラートを選択します。統合が有効になっていても、これらの各ルールはいつでも有効または無効にできます。入力セクションのルールと同様に、Opsgenie はルールを上から下に適用し、ルールと一致すると停止します。したがって、ルールをどのような順番にするかが重要です。受信セクションのルールと同様に、これらのルールはドラッグ & ドロップで並べ替えることができます。

すべてのルールの設定が完了したら、このページから統合をオンにします。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。