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

Opsgenie を ServiceNow と統合する

ServiceNow ロゴ

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

Opsgenie has an application in the ServiceNow Store which allows bi-directional functionality between Opsgenie and ServiceNow. Use the integration to send ServiceNow incident events to Opsgenie with detailed information and to forward Opsgenie alerts as incidents to ServiceNow.

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

統合の機能性

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

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

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

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

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

アクション マッピング

  • If Send Alert Updates Back to ServiceNow selection is enabled, actions are executed in ServiceNow when the chosen action is executed in Opsgenie for alerts which are created by the ServiceNow integration.

  • If Create ServiceNow Incidents for Opsgenie Alerts selection is enabled, actions are executed in ServiceNow when the chosen action is executed in Opsgenie for alerts which have a source other than the ServiceNow integration.

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

Opsgenie ServiceNow 統合の設定

この統合は、Opsgenie の Standard プランと Enterprise プラン、および Jira Service Management の Premium プランと Enterprise プランでのみ利用できます。

統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。

Opsgenie ServiceNow アプリケーションでのコード変更と Opsgenie での設定変更を行わずに、さまざまな Opsgenie チームに複数の ServiceNow インテグレーションを追加することは、サポートされていません。

  1. Go to Settings > Integrations. Search for ServiceNow and select Add.

  2. Specify who is notified of ServiceNow alerts using the Responders field. Specify user(s), group(s), escalations policies, and on-call schedules as the alert recipients. Auto-complete suggestions are provided as you type.

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

  4. Go to the ServiceNow Store, and get the Opsgenie application from there.

  5. After downloading the Opsgenie application from the Store, then go to System Applications>Applications>Downloads to finish the installation of the app.

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

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

ServiceNow Opsgenie 設定

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

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

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

12. Check Use Synchronization option to value, if synchronizing users & groups in ServiceNow with Opsgenie is desired. For more information please check out the "User & Group Synchronization (Optional)" section below.

13. Check Use Acknowledge Action in Opsgenie Instead of Assigning the Alert When the Incident is Assigned to Somebody in ServiceNow option if it is preferred to acknowledge the alert instead of assigning it to a user in Opsgenie when an incident is assigned to someone in ServiceNow. For more information, please check out the "Acknowledging the Alert in Opsgenie When the Incident is Assigned in ServiceNow (Optional)" section below.

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

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

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

Fill the ServiceNow Instance Subdomain field with only the subdomain of the URL of the ServiceNow Instance. For example, fill the field with "sample" for https://sample.service-now.com

ユーザーロール

If you are not seeing the executed actions translate back into ServiceNow and there are no errors in the ServiceNow or Opsgenie logs, we will need to add in an additional two roles for the User. The SOAP and REST roles should also be added to give the User the appropriate access to make these changes.

ServiceNow ユーザー ロール

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

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

ServiceNow 設定プロパティ
ServiceNow 統合

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

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

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

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

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

Opsgenie から ServiceNow へのアラート

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

  • Use this section to map Opsgenie actions to ServiceNow actions when the source of the alert is NOT ServiceNow (i.e When the alert is created by another integration.)

  • For this purpose, use Create ServiceNow Incidents for Opsgenie Alerts section. In order to use this functionality, map one Opsgenie action to "create an incident" ServiceNow action. The Opsgenie action doesn't have to be "alert is created", it can be other actions as well.

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

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

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

ServiceNow タグを追加するカスタム アクション

元のアラート エイリアスと一致しない ServiceNowOpsgenie アラート エイリアス フィールド

In case when an Opsgenie alert creates a new incident in ServiceNow, the og_alert_alias field in incident should be same as the alert alias, if it is not then check the incident create webservice script & business rule scripts in Opsgenie App installed in customer's ServiceNow instance, most probably they have been modified and og_alert_alias field mapping tampered with.

もう 1 つの可能性は、インスタンスにインストールされた OpsGenie アプリで、ユーザーが「OpsGenie Web Svc 作成」Web サービスの [ビジネス ルールの実行] フラグを有効にしていることです。これにより、[og_alert_alias] フィールドを間違った値に変換する場合がある他のビジネス ルールがトリガーされる可能性があります。

アプリがインストールされるときの初期設定では、「OpsGenie Web Svc 作成」の [ビジネス ルールの実行] フラグは無効です。

ServiceNow Web サービス変換マップ

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

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

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

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

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 に作成済みです。

ServiceNow Scripted REST API

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

ServiceNow サンプル スクリプト

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

ServiceNow カスタム アクション

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

ServiceNow 実行済みカスタム アクション
ServiceNow カスタム エンドポイント
ServiceNow アプリ ログ

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

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

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

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

ServiceNow 設定プロパティ

4. In the Opsgenie-ServiceNow integration page, UNCHECK "Restrict Access to Configuration" option, if it is checked.

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

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

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

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

9. Updating group name or group description in ServiceNow will NOT update team name and team description in Opsgenie.

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

ServiceNow 設定

 

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

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