各配列アイテムには エイリアス (メトリクス名) と対応する 値 があります:
{{alert.monitor.thresholds\[n].alias}}
{{alert.monitor.thresholds\[n].values}}
\[n] の値を整数に置き換えます。 モニターで定義されたメトリックしきい値の数に依存します:
• \[0] の値は常に利用可能です。
• \[1] 以上の値はオプションです。
各配列アイテムには エイリアス (メトリクス名) と対応する 値 があります:
{{alert.alert.trigger\_values\[n].alias}}
{{alert.alert.trigger\_values\[n].value}}
\[n] の値を整数に置き換えます: \[0] 、\[1] など。
{{alert.alert.trigger\_reference\_value}}
組み込みモニターのカスタマイズドキュメンテーションのタイプセクションのメトリックの変更アイテムを参照して、参照値計算に関する詳細を学びましょう。
{{alert.alert.context}}
{{alert.alert.context.\
{{alert.alert.context.\
{{alert.alert.context.\
{{alert.alert.context.\
以下の例を参照してください\*:
{{alert.alert.context.binary.name}}
{{alert.alert.context.binary.name.label}}
{{alert.alert.context.binary.name.data\_path}}
{{alert.alert.context.binary.name.data\_type}}
\*contextフィールドは、 モニターNQLクエリと条件で定義されたデータモデルプロパティのみを含みます。
したがって、contextフィールドは、アラートに関連するバイナリ、デバイス、またはユーザーの名前を含む可能性があります。
alert.alert.issue\_view\_link
alert.alert.device\_view\_link
alert.alerts.links
これらのプロパティは現在、NQLデータモデルにはリストされていません。
|alert.alert.issue\_view\_linkは、アラートに関連するトラブルシューティングダッシュボードへのリンクを提供します。 ウェブフックのNQL条件で issue\_view\_link フィールドを リスト 条件に追加する必要があります。
alert.alert.device\_view\_linkは、デバイスビューへのリンクを提供します。 ウェブフックの NQL 条件 で device\_view\_link フィールドを リスト 条件に追加する必要があります。
アラート設定に応じて、プレースホルダー alert.alerts.links は、アラートに関連するDevice view またはトラブルシューティングダッシュボードへのリンクを提供します。
この場合、ウェブフック NQL条件 の リスト 条件に device\_view\_link および issue\_view\_link を追加する必要があります。
{{remote\_action.execution.outputs.\
例えば:
{{remote\_action.execution.outputs.MeteredConnection}}
{{remote\_action.execution.inputs.\
例えば:
{{remote\_action.execution.inputs.InputPath}}
remote\_action.execution.account\_name
このプロパティは現在、NQLデータモデルにはリストされていません。
|{{remote\_action.execution.account\_name}}
このプレースホルダーは、リモートアクションを実行したユーザー/従業員を提供します。
| ## 複数のプロバイダーとツールのメソッド、リソース、およびペイロードの例 {% hint style="info" %} 複数のサードパーティツールのフルウェブフック設定については、[Webhookのユースケースセットアップ](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup.md)ドキュメントを参照してください。 {% endhint %} ### ITSM ツール #### **ServiceNowに対するインシデントの作成** メソッド: `POST` リソース: `api/now/v1/table/incident` ペイロード: ``` { "assignment_group":"アプリケーションチーム", "business_service":"MS Teams", "caller_id":"Nexthinkアラート", "description":"アラートチームから作成されたアラートです。 ","impact":"5", "short_description":"テスト目的のアラート David G {{alert.monitor.name}}", "sys_created_by":"Nexthink統合テスト David G.", "urgency":4 } ``` [こちらのガイドラインを参照](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/creating-an-incident-in-servicenow.md)して、アラートやイベントを検出し、それをServiceNowに送信してインシデントを作成するWebhooksを設定してください。 #### **AmplifyからServiceNowインシデントチケットの更新** メソッド: `PATCH` リソース: `api/now/v1/table/incident/{{remote_action.execution.external_reference}}` ペイロード (メッセージ): ``` {"work_notes": "Amplifyユーザー{{remote_action.execution.account_name}}が{{remote_action.execution.request_time}}にこのチケットのリモートアクション{{remote_action.execution.outputs.as(format = text)}}をトリガーした。"} ``` `"work_notes"` に `as(format = text)` 関数を含めて、リモートアクションの出力を読みやすい形式で表示するようにしてください。 [こちらのガイドラインを参照](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/updating-servicenow-from-amplify.md)して、AmplifyからServiceNow実行アクションログを更新するWebhooksを設定してください。 #### **ServiceNow に問題を作成する** メソッド: `POST` リソース: `api/now/v1/table/problem` ペイロード: ``` { "impact":"1", "urgency":"2", "category":"ハードウェア", "short_description":"アラート: {{alert.monitor.name}} が Nexthink によって発生しました", "description":"アラート {{alert.monitor.name}} は {{alert.monitor.time}} に Nexthink により自動的に発生しました。このアラートを引き起こした NQL クエリは https://tinyurl.com/29k9xy8d です", "assignment_group":"アプリケーションチーム", "business_service":"MS Teams", } ``` #### **BMC にインシデントを作成する** メソッド: `POST` リソース: `api/arsys/v1/entry/HPD:IncidentInterface_Create?fields=values(Incident Number , Request ID, First_Name)` ペイロード: ``` { "values": { "First_Name": "Allen", "Last_Name": "Allbrook", "Description": "REST API: Nexthink アラート {{alert.monitor.name}} がトリガーされました", "Impact": "1-広範な/ゆるやかな", "Urgency": "1-重大", "Status": "割り当て済み", "Reported Source": "直接入力", "Service_Type": "ユーザーサービス復元" } } ``` #### **4me にインシデントを作成する** メソッド: `POST` リソース: `v1/requests` ペイロード: ``` { "category":"incident", "subject":"これはアラート {{alert.monitor.name}} によりトリガーされた結果です", "impact":"低い", "service_instance_id":"147488", "ci":"21819154", "ci_id":"21819154", "note":"アラートは {{alert.alert.trigger_time}} に以下の値でトリガーされました: {{alert.alerts.trigger_values[0].alias}}: {{alert.alerts.trigger_values[0].value}}, {{alert.alerts.trigger_values[1].alias}}: {{alert.alerts.trigger_values[1].value}}" } ``` #### **Jira Service Desk にサービスリクエストを作成する** メソッド: `POST` リソース: `rest/servicedeskapi/request` ペイロード: ``` { "serviceDeskId": "1", "requestTypeId": "5", "requestFieldValues": { "summary": "REST 経由で JSD のヘルプをリクエスト", "description": "Mac 用の新しい *マウス* が必要です" } } ``` ### アラートツール #### **Pager Duty にインシデントを作成する** メソッド: `POST` リソース: `incidents` ペイロード: ``` { "incident": { "type": "incident", "title": "api インシデント nexthink アラート {{alert.monitor.name}}", "service": { "id": "PXZF637", "summary": null, "type": "service_reference", "self": null, "html_url": null }, "priority": { "id": "high", "summary": null, "type": "priority_reference", "self": null, "html_url": null }, "urgency": "高い", "body": { "type": "incident_body", "details": "文字列" }, "incident_key": "incident_{{alert.alert.trigger_time}}", "escalation_policy": { "id": "P14MFQ2", "summary": null, "type": "escalation_policy_reference", "self": null, "html_url": null }, "conference_bridge": { "conference_number": "文字列", "conference_url": "文字列" } } } ``` ### メッセージングツール #### **MS Teams チャンネルにメッセージを投稿する** メソッド: `POST` リソース: `/workflows/XXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=?????&sp=/triggers/manual/run&sv=1.0&sig=XXXXXXXXXXXXXXX` ペイロード: ``` { "type": "message", "attachments": [ { "contentType": "application/vnd.microsoft.card.adaptive", "content": { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.0", "msteams": { "width": "Full" }, "body": [ { "type": "TextBlock", "text": "Nexthink アラート", "id": "Title", "spacing": "Medium", "horizontalAlignment": "Center", "size": "ExtraLarge", "weight": "Bolder", "color": "Accent" }, { "type": "Container", "items": [ { "type": "TextBlock", "text": "{{alert.alert.context.application.name}},{{alert.monitor.name}}", "wrap": true, "color": "Default", "size": "Medium" } ], "style": "emphasis" }, { "type": "FactSet", "facts": [ { "title": "Assigned to", "value": "インフラストラクチャチーム" }, { "title": "トリガー時刻: ", "value": "{{alert.alert.trigger_time}}" }, { "title": "アプリケーション名", "value": "{{alert.alert.context.application.name}}" }, ] }, { "type": "TextBlock", "text": "条件違反:", "wrap": true }, { "type": "Table", "columns": [ { "width": 1 }, { "width": 1 }, { "width": 1 }, { "width": 1 } ], "rows": [ { "type": "TableRow", "cells": [ { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "メトリック名", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "しきい値", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "メトリック値", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "ベースライン値", "wrap": true } ] } ] }, { "type": "TableRow", "cells": [ { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "{{alert.alert.trigger_values[0].alias}}", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "{{alert.monitor.thresholds[0].value}}", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "{{alert.alert.trigger_values[0].value}}", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "{{alert.alert.trigger_reference_value}}", "wrap": true } ] } ] }, { "type": "TableRow", "cells": [ { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "{{alert.alert.trigger_values[1].alias}}", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "{{alert.monitor.thresholds[1].value}}", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "{{alert.alert.trigger_values[1].value}}", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "", "wrap": true } ] } ] }, { "type": "TableRow", "cells": [ { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "", "wrap": true } ] }, { "type": "TableCell", "items": [ { "type": "TextBlock", "text": "", "wrap": true } ] } ] } ], "showGridLines": false }, { "type": "ActionSet", "actions": [ { "type": "Action.OpenUrl", "title": "Nexthink で表示", "URL": "{{alert.alert.issue_view_link}}" } ] } ] } } ] } ``` [このガイドラインに従い](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/posting-a-message-to-an-ms-teams-channel.md#postingamessagetoanmsteamschannel-comment-1085538388) MS Teams での受信リクエストのセットアップを行います。 #### **特定の Slack チャンネルにメッセージを投稿する** メソッド: `POST` リソース: `services/T01S01V0HB3/B02GY9BKZ7G/DIDFWXuCAeFfqkgNntQqJV7e` ペイロード: ``` { "channel":"C01R6KV8CA3", "text":"デジタルエクスペリエンスに影響を与えているアラート {{alert.monitor.name}} があります", "attachments":[ { "text":"誰が見ればよいのでしょうか？", "fallback":"あなたはコンピューターに一生分のチョコレートで何をさせることができるのか伝えることができます。 ", "color":"#3AA3E3", "attachment_type":"default", "callback_id":"select_simple_1234", "actions":[ {"name":"winners_list", "text":"アラートを対応するべきなのは誰ですか？", "type":"select", "data_source":"users" } ] } ] } ``` [このガイドラインに従い](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/sending-data-to-a-slack-channel.md) Slack の受け取りリクエストを設定します。 #### **Zoom にメッセージを投稿する** メソッド: `POST` リソース: `chat/webhooks/incomingwebhook/dSUcla-dQaGYgqGuBk3BsQ`. 上記の URL リソースは、Zoom 内で直接設定されたエンドポイント URL にのみ依存しているため、参考用です。 ペイロード: Zoom に送信するメッセージを追加してください。 下記の例を参照してください。 ``` [ { "text":"入力メッセージ", "img":["file1","file2"] } ] ``` [このガイドラインに従い](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/posting-a-message-in-zoom.md) Zoom の受信リクエストを設定します。 ### プロダクティビティツール #### **特定のプロジェクトに Jira でバグを作成する** メソッド: `POST` リソース: `services/T01S01V0HB3/B02GY9BKZ7G/DIDFWXuCAeFfqkgNntQqJV7e` ペイロード: ``` { "fields": { "project": { "key": "WHKBUG" }, "summary": "ユーザーは音質の悪い通話を経験しています", "description": "Nexthink アラート {{alert.monitor.name}} がトリガーされました", "issuetype": { "name": "バグ" }, "priority":{ "name": "{{alert.alert.priority}}" }, "timetracking": { "originalEstimate": "1d 2h", "remainingEstimate": "3h 25m" } } } ``` ### データプラットフォーム #### **Splunk のイベントコレクターにイベントを送信する** メソッド: `POST` リソース: `services/collector?index=_main` ペイロード: ``` { "event": "メトリック", "source": "メトリクス", "sourcetype":"パフォーマンスログ", "fields": { "event_name":"システムクラッシュ", "event_label":"{{device_performance.system_crash.label}}", "event_error_code":"{{device_performance.system_crash.error_code}}", "event_time":"{{device_performance.system_crash.time}}", "region": "us-west-1", "datacenter": "dc2", "rack": "63", "os": "Ubuntu16.10", "arch": "x64", "team": "LON", "service": "6", "service_version": "0", "service_environment": "テスト", "path": "/dev/sda1", "fstype": "ext3" } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks/configuring-webhook-fields_-method-resource-and-payload.md?ask=