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にドロップダウンリストからインシデントを選択します。

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

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

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

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

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

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

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

Nexthinkにおいて

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

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

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

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条件を記入します。 以下のクエリを参照してください。

• 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インテグレーション"
}