ServiceNow でのインシデント作成

このドキュメントでは、Nexthink Webhook を設定してアラートやイベントを検出し、それらをServiceNowに送信してインシデントを作成する方法を示します。

ServiceNowにおいて

Nexthinkで資格情報を定義するために、ユーザーに適切なロールが設定されていることを確認します。

  1. ユーザー管理に移動し、ユーザーを選択します。

  2. ユーザーに以下のロールが割り当てられていることを確認します。

  • rest_api_explorer

  • itil

  1. ユーザーがServiceNowにセットアップされた後、システムウェブサービス > REST に入り、Rest API Explorerを選択します。

  2. 次の値を選択していることを確認します。

  • 名前空間 = now

  • API 名 = テーブル API

  • API バージョン = 最新

  1. レコードを作成 (POST) のオプションをクリックします。

  2. リクエストを準備するセクションで、tableNameにドロップダウンリストからインシデントを選択します。

Prepare request
  1. 将来参照用にレコード作成情報をコピーして保存します。 つまり、Nexthinkウェブインターフェースでのコネクター資格情報およびWebhook構成のため。

  1. リクエストボディセクションに移動し、ページ下部にあるビルダータブを選択します。

Builder tab
  1. リクエストボディを構成するためにフィールドを追加し、将来の参照用に保存します。 つまり、NexthinkウェブインターフェースでのWebhook構成のため。

  • インシデントを作成するには、例えば、callerimpacturgencybusiness serviceconfiguration itemshort description、およびdescriptionのフィールドを使用し、ServiceNowのドロップダウンメニューから適切なフィールドを選択し、それらに値を割り当てるテキストを入力します。

  • オプションで、プラスボタンを使用して、ServiceNowでリクエストに新しい行を必要なだけ追加できます。

Assign values to fields

以下は、ServiceNowでのリクエストボディの例です:

{
 "short_description":"Nexthinkアラートによって作成された問題です",
 "description":"Nexthinkアラート{{alert.monitor.name}}がトリガーされました",
 "impact":"2",
 "urgency":"2",
 "cmdb_ci":"{{device.device.name}}",
 "caller_id":"Nexthinkインテグレーション"
 }

ペイロードに使用できるプレースホルダーの詳細については、Webhookフィールドの設定: メソッド、リソース、ペイロードを参照してください。

Nexthinkにおいて

Nexthinkウェブインターフェースから:

ServiceNowインシデント作成のためのコネクター資格情報の設定

コネクター資格情報の設定ページから、ServiceNowで作成した接続情報を使ってフィールドに入力します。

  1. プロトコルドロップダウンからHTTPSオプションを選択します。

  2. ServiceNowからレコード作成URLhttps://venXXXXX.service-now.com/URLアドレスフィールドに貼り付けます。

  3. 認証ドロップダウンから基本オプションを選択します。

  4. サードパーティツールに接続するためのユーザー名パスワードを入力します。

  5. 資格情報を保存します。

ServiceNowインシデント作成のためのWebhookの設定

Webhook設定ページから、ServiceNow REST API Explorer設定の情報を使ってフィールドに入力します。

  1. Webhook NQL条件の設定 ドキュメントに従ってNQL条件を記入します。 以下のクエリを参照してください。

alert.alerts
| list alert.monitor.name, alert.status, monitor.tags, alert.context, trigger_time, recovery_time, alert.monitor.thresholds, monitor.priority, alert.trigger_values, alert.trigger_reference_value, alert.recovery_values, alert.context, device_view_link, issue_view_link, device.name
  1. 資格情報ドロップダウンから、ServiceNow用に作成したコネクター資格情報を選択します。

  2. メソッドドロップダウンからPOSTを選択します。

  3. リソースフィールドにServiceNowからのレコード作成URLをURLアドレスなしでコピーアンドペーストします。 例: api/now/table/incident

  • この場合、ServiceNowのtableNameに対して、選択したクエリパラメータ{tableName}を置き換えてください。 この場合、incident.

  1. ServiceNowで作成されたリクエストボディペイロードフィールドに貼り付けます。 フォーマットは不要です。 以下の例を参照してください。

{
  "short_description":"Nexthinkアラートによって作成された問題です",
  "description":"Nexthinkアラート{{alert.monitor.name}}がトリガーされました",
  "impact":"2",
  "urgency":"2",
  "cmdb_ci":"{{device.device.name}}",
  "caller_id":"Nexthinkインテグレーション"
}

ペイロードに使用できるプレースホルダーの詳細については、Webhookフィールドの設定: メソッド、リソース、ペイロードを参照してください。

Last updated

Was this helpful?