ServiceNowでのインシデント作成

このドキュメントは外部ソースを参照しています。

Nexthink は、サードパーティのドキュメントの正確性や、不整合を引き起こす可能性のある外部の更新を管理していません。

エラーや不整合を発見した場合は、Nexthinkサポート に報告してください。

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

ServiceNowで

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

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

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

   • rest_api_explorer

   • itil

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

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

   • Namespace = now

   • API 名 = Table API

   • API バージョン = latest

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

6. リクエストの準備セクションで、テーブル名にドロップダウンリストからインシデントを選択します。

1. 今後の参照のために、レコード作成情報をコピーして保存してください。 つまり、NexthinkのWebインターフェースでのコネクター資格情報の設定とWebhook設定です。

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

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"
}

ペイロードでのプレースホルダーとしてのデータモデル変数の使用については、Webhookフィールドの構成: メソッド、リソース、およびペイロードを参照してください。

Nexthinkで

NexthinkのWebインターフェースから:

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

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

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

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

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

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

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

   • {tableName}をServiceNowのテーブル名に適切なクエリパラメーターで置き換えることを忘れないでください。 この場合は、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"
}

ペイロードでのプレースホルダーとしてのデータモデル変数の使用については、Webhookフィールドの構成: メソッド、リソース、およびペイロードを参照してください。