Opsgenie を ServiceNow と統合する

Opsgenie が ServiceNow ユーザーに提供するもの

Opsgenie は ServiceNow Store に、Opsgenie と ServiceNow の双方向機能を実現するアプリケーションを用意しています。この統合を使用して、 ServiceNow インシデント イベントを詳細情報とともに Opsgenie に送信し、Opsgenie アラートをインシデントとして ServiceNow に転送します。

Opsgenie は、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iOS、Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。

統合の機能性

• ServiceNow でインシデントが作成されると、Opsgenie でアラートが作成されます。

• インシデントが ServiceNow で解決またはクローズされると、Opsgenie でアラートがクローズされます。

• ServiceNow でインシデントがグループに割り当てられると、ServiceNow のグループの名前と Opsgenie のチームの名前が一致する場合は、対応するチームがアラートに追加されます。

• ServiceNow でインシデントがユーザーに割り当てられると、Opsgenie でアラートが対応するユーザーに割り当てられます。

• ユーザーとグループの同期 (オプション)。

アクション マッピング

• [アラートのアップデートを ServiceNow に送信する] の選択が有効な場合、ServiceNow 統合によって作成されるアラートに対して、選択したアクションが Opsgenie で実行されると、ServiceNow でアクションが実行されます。

• [Opsgenie アラートに対して ServiceNow インシデントを作成する] が選択されている場合、ServiceNow 統合以外のソースを持つアラートに対して、選択したアクションが Opsgenie で実行されると、ServiceNow でアクションが実行されます。

このアクション マッピング機能の詳細については、以下の「アクション マッピング機能」セクションで説明します。

Opsgenie ServiceNow 統合の設定

1. [設定] > [統合] の順に移動します。ServiceNow を検索して [追加] を選択します。

2. [応答者] フィールドによって ServiceNow アラートの通知先を指定します。アラート受信者として、ユーザー、グループ、エスカレーション ポリシー、オンコール スケジュールを指定します。入力し始めると、オートコンプリートの候補が表示されます。

3. Opsgenie ServiceNow アプリケーション設定で使用する統合 API キーをコピーします。

4. ServiceNow Store に移動し、そこから Opsgenie アプリケーションを入手します。

5. Opsgenie アプリケーションをストアからダウンロードした後で、[システム アプリケーション>アプリケーション>ダウンロード] に移動し、アプリのインストールを完了します。

6. インスタンス内に x_86994_opsgenie.opsgenie_app_role、import_transformer、および import_set_loader ロールを持つユーザーを作成またはアップデートします。ユーザーにパスワードを割り当てます。永続的または一時的なパスワードにすることができます。

7. Opsgenie アプリケーションをインスタンスに追加すると、ナビゲーターで Opsgenie アプリケーションが使用できるようになります。

9. Opsgenie アプリケーション メニューで、[Opsgenie Configuration (Opsgenie 設定)] を選択します。

10. [Opsgenie API キー] フィールドに、前にコピーした API キーを入力します。

11. Opsgenie サンドボックスを使用しない場合は、[Opsgenie API URL] フィールドはそのままにします。

12. ServiceNow のユーザーおよびグループを Opsgenie と同期する必要がある場合は、[同期を使用する] オプションをチェックします。詳細については、以下の「ユーザーとグループの同期 (オプション)」セクションをご確認ください。

13. ServiceNow でインシデントが誰かに割り当てられたときに、Opsgenie でユーザーにアラートを割り当てる代わりにアラートを承認する場合は、[ServiceNow でインシデントが誰かに割り当てられたときにアラートを割り当てるかわりに Opsgenie で承認するアクションを使用] オプションをチェックします。詳細については、以下の「ServiceNow でインシデントが割り当てられた場合の Opsgenie でのアラートの承認 (オプション)」セクションをご確認ください。

14. ServiceNow で設定を保存します。

15. Opsgenie ServiceNow 統合ページに戻ります。

16. [ServiceNow インスタンス サブドメイン] フィールドに、ServiceNow インスタンスのサブドメインを入力します。

17. [ServiceNow ユーザー ID] および [ServiceNow パスワード] フィールドに、ステップ 7 で作成またはアップデートしたユーザー ID およびパスワードを入力します。

18. [統合を保存] をクリックします。

アクション マッピング機能

• Opsgenie では、Opsgenie と ServiceNow の各アクション間のアクション マッピングを定義できます。

ServiceNow によって作成されたアラートの場合

• このセクションを使用して、アラートのソースが ServiceNow である場合に Opsgenie のアクションを ServiceNow のアクションにマッピングします (アラートが ServiceNow インテグレーションによって作成された場合)。

• さまざまな Opsgenie アクションをさまざまな ServiceNow アクションにマッピングします。たとえば、Opsgenie でアラートが承認されたときに ServiceNow インシデントにメモを追加します。これを行うためには、「アラート アップデートを ServiceNow に送信するセクション」の「Opsgenie でアラートが承認された場合、そのアラートを ServiceNow のインシデントに作業メモとして追加する」マッピングを定義します。*

Opsgenie のその他のアラートの場合

• このセクションを使用して、アラートのソースが ServiceNow でない場合に Opsgenie のアクションを ServiceNow のアクションにマッピングします (つまり、アラートが別の統合によって作成された場合)。

• このために、[Opsgenie アラート用の ServiceNow インシデントの作成] セクションを使用します。この機能を使用するには、1 つの Opsgenie アクションを「インシデントの作成」ServiceNow アクションにマッピングします。Opsgenie アクションでは、アラートが作成される必要はなく、他のアクションにすることもできます。

• 「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションは、他のアクションと異なります。これらのアクションのいずれかを選択すると、このマッピングが機能するタグまたはカスタム アクションを入力するための追加のフィールドが表示されます。

• タグをカンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、指定されたタグが 1 つ以上アラートにある場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。

• Opsgenie アクションが複数の ServiceNow アクションにマッピングされている場合は、「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションを除いて、エラーが発生します。マッピングが特定のタグとカスタム アクション名によって異なるため、これらのアクションに対する複数のマッピングを保存します。

ServiceNow でインシデントが割り当てられたときの Opsgenie でのアラートの承認 (オプション)

1. 現在、ServiceNow でインシデントがユーザーに割り当てられている場合、Opsgenie でアラートは同じユーザーに割り当てられます。

2. Opsgenie でユーザーにアラートを割り当てても、通知フローは停止しません。

3. 代わりに、ServiceNow でインシデントが誰かに割り当てられると、通知フローは停止します。ServiceNow の最新の Opsgenie アプリケーションでは、この動作のオプションがあります。

4. 初期設定では有効になっていません。Opsgenie でユーザーにアラートを割り当てるのではなく、アラートを承認するには、このオプションをチェックします。

ServiceNow のカスタム Scripted REST API ソース エンドポイントへのペイロードの送信 (オプション)

1. ServiceNow との統合では、アラート アクションから ServiceNow のカスタム エンドポイントへのペイロードの送信がサポートされています。

2. 任意のアラート アクションを「カスタム エンドポイントに送信する」ServiceNow アクションにマッピングします。それらのアラート アクションが実行されると、指定したエンドポイントにペイロードが送信されます。

3. この「カスタム エンドポイントに送信する」ServiceNow アクションで送信するペイロードは、Webhook 統合のペイロードに似ていますが、「integrationName」フィールドと「integrationId」フィールドを含みません。ペイロードの詳細については、このドキュメントをご確認ください。

4. 最新の Opsgenie アプリケーション用の Scripted REST API リソースは、「sample」という名前で既に ServiceNow に作成済みです。

5. この「sample」Scripted REST API リソースの例として、アラート API への HTTP リクエストを作成し、アラート API からアラート データを取得して、アプリケーション ログに記録するスクリプトを開発しました。

6. 「sample」という名前のカスタムの Opsgenie アクションを「カスタム エンドポイントに送信する」ServiceNow アクションにマッピングし、カスタム エンドポイントとして「sample」と入力して、機能をテストします。

7. このように、Opsgenie のアラートに対して「sample」カスタム アクションが実行されると、ServiceNow の「sample」エンドポイントに転送されます。

ユーザーとグループの同期 (オプション)

1. ServiceNow との統合では、ServiceNow と Opsgenie でユーザーおよびグループの同期がサポートされています。

2. 同期機能が有効になった後で ServiceNow に追加されたユーザーとグループに対して同期が実行されることに注意してください。ServiceNow のそのようなユーザーごとに Opsgenie のユーザーを作成し、ServiceNow のそのようなグループごとに Opsgenie のチームを作成します。

3. ServiceNow の [Opsgenie 設定]フォームで [同期を使用] オプションがチェックされている場合、ServiceNow でユーザーが作成、アップデート、または削除されるか、グループが作成または削除されると、変更内容が Opsgenie アカウントに適用されます。

4. Opsgenie-ServiceNow 統合ページで、[設定へのアクセスを制限する] チェックボックスがオンになっている場合はオフにします。

5. ServiceNow からユーザーのメール、フルネーム、業務用電話番号、携帯電話番号、タイムゾーンのフィールドを取得し、ユーザーを作成するときに Opsgenie でそれらのフィールドを使用します。

6.Opsgenie で作成されたユーザーのロールは、ServiceNow でのロールに関係なく「ユーザー」になります。。

7. ServiceNow でユーザーのフルネーム、業務用電話番号、携帯電話電話番号、タイムゾーンの 1 つ以上のフィールドが変更されると、Opsgenie でもそれらのフィールドが変更されます。

8. Opsgenie では、チーム名に特殊文字やスペースを使用できませんが、ServiceNow では使用できます。そのため、ServiceNow で名前にそうした文字が含まれるグループが作成されると、Opsgenie でチームを作成する前に、許容されない文字とスペースが置き換えられます。

9. ServiceNow でグループ名またはグループの説明をアップデートしても、Opsgenie でチーム名およびチームの説明はアップデートされません。

10.ServiceNow でグループに対してユーザーが追加または削除されると、Opsgenie でそのユーザーはチームに対して追加または削除されます。