IT サービス管理に ServiceNow を使用している場合は、ドットコム モニター アラート通知機能を構成して、ServiceNow アカウント内から監視インシデントを管理できます。

ドットコムモニターとServiceNowの統合のセットアップには、HTTPウェブフックを介した統合の構成とServiceNow®イベント管理アプリケーションの使用の2つの方法があります。

最初のアプローチでは、HTTP Webhook アラート配信方法を利用して、Webhook 要求を介してドットコム モニター アカウントと ServiceNow アカウントを接続します。 この方法では、 アラート テンプレート を手動でカスタマイズして、ドットコム モニター メッセージ変数を ServiceNow イベント フィールドにマップします。 専用のウェブフック URL にアラート メッセージを送信する方法については、 HTTP ウェブフック統合 に関する記事を参照してください。

または、アクティブなイベント管理プラグインがある場合は、アラートイベントをServiceNowインスタンスに直接プッシュするようにドットコムモニターアラートシステムを構成できます。 この場合、ドットコムモニターはペイロードにアラートの詳細を含むJSONリクエストを https://< instancename.service-now.com/api/global/em/jsonv2> エンドポイントに送信し、 [em_events] テーブルは、ドットコムモニターで新しい監視アラートが生成されるたびに表示されます。

ServiceNow Web サービス API への要求は、 ServiceNow Web サービス API の要件に従って自動的に構成されます。 アラートメッセージ変数を [em_events] 以下のフィールド。

イベント フィールドとドットコム モニター変数
サービスナウのイベントフィールド ドットコムモニターメッセージ変数/値
メッセージキー @DeviceEventHistory_SeqID

Dotcom-Monitor がデバイスの状態の変化 (監視エラーなど) を検出し、監視アラートを生成すると、アラート システムは 一意の識別番号 @DeviceEventHistory_SeqID を持つ新しいイベントを作成します 。 イベントに割り当てられると、@DeviceEventHistory_SeqIDはデバイスのステータスが変わるまで変わりません。 この ID は、ServiceNow でのインシデント管理のセットアップに使用できます。
源 ドットコムモニター
ソースインスタンス @Location

イベントが作成された監視場所の名前。
ノード @DeviceName

ドットコムモニターがイベントを作成した監視デバイスの名前。
資源 @TaskName

監視タスクの名前。 フィールドはUVに対して空のままです。
メトリック名 @TaskType

監視タスクの種別。 可能な値:

  • ユーザービュー
  • ブラウザビュー
  • ウェブビュー
  • サーバービュー
  • メトリックビュー
過酷 デバイスの状態。 可能な値:

  • OK – デバイスがアラート状態を離れたときの 稼働時間アラート イベント 。
  • 重大 – アラート システムをトリガーし、デバイスの状態をアラートに変更した エラー イベント 。
形容 インシデントの説明。 可能な値:

  • 重大度:OK

“OK- View Alert – @(Model.DMUserLink)OnlineReporting.aspx?CUID=@Model.OnlineReportCUID”

  • 重大度: 重大

“@Model.FirstErrorResponse.AllErrors[0]。ErrorType – @Model.FirstErrorResponse.AllErrors[0]。理由 – @Model.StartMonitorDowntime – View Alert – @(Model.DMUserLink)OnlineReporting.aspx?CUID=@Model.OnlineReportCUID”

ドットコムモニターオブジェクトモデル変数の説明については、「 アラートテンプレートへの動的変数の追加」を参照してください。

イベント管理プラグインを使用したドットコムモニターからServiceNowへのイベントのプッシュ

まず、ServiceNowアカウントにログインし、アクティブなイベント管理プラグインがあることを確認します。 製品ドキュメントに記載されている推奨事項を使用して、ServiceNow インスタンスにイベントをプッシュするためのウェブサービスインターフェイスを設定します。

次に、ドットコムモニターアカウントにログインし、アラートグループ設定で、 ServiceNow アドレスタイプを選択します。 ドットコムモニターは、事前に構成された要求と通知メッセージテンプレートをユーザーに提供します。 必要なのは、ServiceNow アカウントに表示されるインスタンス名を次の形式で指定することだけです。

https://<instancename>.service-now.com/api/global/em/jsonv2

次に、要求認証パラメータを設定すれば、準備は完了です。 他のすべての要求設定は既定のままにしておくことをお勧めします。

認証

[ 認証 ] セクションにログイン資格情報を入力して、ServiceNow Web サービス API へのすべての受信要求を承認します。 注: ServiceNow ユーザーは、次の要件に準拠する必要があります。

必要な役割: evt_mgmt_integration

動的な資格情報と静的なログインとパスワードのペアを渡すことができることに注意してください。 認証資格情報をカスタマイズするには、対応する入力フィールドの先頭にあるドロップダウンメニューアイコンをクリックし、追加するコンテンツの種類を選択します。 カスタム認証パラメーターの構成の詳細については、この記事の「 要求パラメーターをカスタマイズする方法 」セクションを参照してください。

要求パラメーターをカスタマイズする方法

ドットコムモニターは、通知要求のカスタマイズをサポートするためのさまざまなオプションをユーザーに提供します。 目標と Web アプリケーション・サーバーの要件に応じて、提供されているデータ・タイプの 1 つを使用して、通知メッセージおよびその他の要求パラメーターを柔軟にパーソナライズできます。

アラート テンプレート

アラート テンプレートには、アラート メッセージの内容だけでなく、要求パラメーターで使用する任意の種類のコンテンツを格納できます。 新しい再利用可能なテンプレートを作成する必要がある場合は、このウィキの アラートテンプレート:セットアップと設定(テキスト&HTML&JSON) の記事の説明に従って作成してください。

事前構成済みのテンプレートを選択するには、入力フィールドをクリックし、リストからテンプレートを選択します。

静的コンテンツ

要求パラメーターと共に静的データを渡す必要がある場合は、[ 静的 ] オプションを選択します。 入力フィールドに内容を入力できます。

動的コンテンツ

アラート・メッセージおよびその他の要求パラメーター値は、動的変数を使用してパーソナライズできます。 ドットコムモニターは、アラート通知を送信すると、現在のシステム値を関連する変数に渡します。 ドットコムモニターの動的テンプレートは、 マイクロソフトのRazor解析エンジン で実装され、メッセージ入力フィールド内から作成できます。 動的変数の操作方法については、「 警告テンプレートへの動的変数の追加」ナ レッジベースの記事を参照してください。

以前に作成したアラート テンプレートを活用する場合、または定義済みの HTML スニペットを使用する場合は、ナレッジ ベースの 「アラート テンプレート: セットアップと構成 (テキストと HTML & JSON)」 の記事の説明に従って、メッセージ入力フィールドを展開し、メッセージ エディターを使用します。