ServiceNow でのインシデント作成

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

ServiceNow内

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

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

2. ユーザーに以下の役割が割り当てられていることを確認してください。

   • rest_api_explorer

   • itil

3. ユーザーがServiceNowに設定されたら、システムWebサービス > RESTに入り、REST API Explorerを選択します。

4. 次の値を選択したことを確認してください。

   • Namespace = now

   • API Name = Table API

   • API Version = latest

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

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

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

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

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

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

   • オプションとして、プラスボタンを使用して必要な行数だけ新しい行を作成して、ServiceNowのリクエストにさらに多くのフィールドを追加します。

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

{
 "short_description":"これはNexthink Alertによって作成された問題です",
 "description":"Nexthink Alert {{alert.monitor.name}} が発動されました",
 "impact":"2",
 "urgency":"2",
 "cmdb_ci":"{{device.device.name}}",
 "caller_id":"Nexthink Integration"
 }

Nexthink内

Nexthink webインターフェースから:

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

• ServiceNowインシデント作成用のwebhookを設定する

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

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

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

2. ServiceNow からのレコード作成URL https://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です。

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

{
  "short_description":"これはNexthink Alertにより作成された問題です",
  "description":"Nexthink Alert {{alert.monitor.name}} が発動されました",
  "impact":"2",
  "urgency":"2",
  "cmdb_ci":"{{device.device.name}}",
  "caller_id":"Nexthink Integration"
}