MID Web サービスイベントコレクターコンテキストの設定
MID Web サービスイベントコレクターコンテキストを設定して、URL メソッドで外部ソースからのイベントメッセージを MID サーバー にプッシュできるようにします。
始める前に
イベント管理 Connectors (sn_em_connector) プラグインが Now Platform インスタンスにインストールされていることを確認します。
必要なロール：evt_mgmt_admin
このタスクについて
http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2 です。この URL は良好なパフォーマンスで動作します。 外部ソースからの jsonv2 形式以外のイベントメッセージをプッシュするための URL 形式は http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Name_of_Transform_Script} です。ここで、{Name_of_Transform_Script} 変数は、スクリプトのフルネームで、常にテキスト「TransformEvents_」で始まります。
- {MID_Server_IP}：10.118.69.27
- {MID_Web_Server_Port}：8097
- 変換スクリプト名：EventsToProcess
http://10.118.69.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name}形式の URL もサポートされています。- イベントの日付形式は、yyyy-M-d h:mm:ss です。
日付形式が異なるイベントを受信した場合は、受信イベントの日付形式に適した
{transform_script_name}を使用する必要があります。そうしないと、イベントは正しく処理されません。たとえば、2019/06/27/ 11:25:00 a という日付が記載されたイベントが 2019 年 6 月 27 日、午前 11:25 に到達した場合は、受信したイベントの形式に合わせて、yyyy/MM/dd/ HH:mm:ss a の日付形式で
{transform_script_name}を使用します。
手順
例
JSON v2 形式のイベントメッセージを変換するための URL の使用方法の説明
JSON v2 形式のイベントメッセージが MID サーバー に送信されるものとします。jsonv2 URL を使用する場合、スクリプトインクルードを使用する必要はありません。
| フィールド | 値 |
|---|---|
| MID_Server_IP | 10.218.64.27 |
| MID_Web_Server_Extension_Port | 8097 |
| イベントメッセージ形式 | jsonv2 |
デフォルト形式の URL http://<my-instance>.service-now.com/api/global/em/jsonv2 の変数は、前出のテーブルからの値「http://10.218.64.27:8097/api/global/em/jsonv2」に置き換えられます。
jsonv2 形式以外のメッセージをプッシュするための URL を示す例
外部ソースからの jsonv2 形式以外のイベントメッセージをプッシュするための URL の形式は、http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event/Transform={Name_of_Transform_Script} です。ここで、{Name_of_Transform_Script} 変数は、スクリプトのフルネームで、常にテキスト「TransformEvents_」で始まります。スクリプト名は、Transform ヘッダーパラメーターとして指定する必要があり、常にプリフィックス「TransformEvents_」で始まる必要があります。
この例では、スクリプト名を EventsToProcess と仮定しているため、URL は http://10.138.64.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess となります。
curl -v -H "Accept: application/json" -H "Content-Type: application/json" -X POST --data "{
"records":
[ {
\"source\" : \"Simulated\",
\"node\" : \"nameofnode\",
\"type\" : \"High Virtual Memory\",
\"resource\" : \"C:\",
\"severity\" : \"5\",
\"description\" : \"Virtual memory usage exceeds 98%\",
\"ci_type\":\"cmdb_ci_app_server_tomcat\",
\"additional_info\":\"{\\\"name\\\":\\\"My Airlines\\\"}\"
},
{
\"source\" : \"Simulated\",
\"node\" : \"01.myairlines.com\",
\"type\" : \"High CPU Utilization\",
\"resource\" : \"D:\",
\"severity\" : \"5\",
\"description\" : \"CPU on 01.my.com at 60%\"
}
]
}" -u UserName:Password http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2