カスタムペイロードからのイベント収集

MID Web サービスイベントコレクタ―を使用すると、JSON、XML、またはプレーンテキストの形式で、カスタムペイロードからイベント情報を収集できるようになります。

始める前に

イベント管理 Connectors (sn_em_connector) プラグインが Now Platform インスタンスにインストールされていることを確認します。

必要なロール：evt_mgmt_admin

このタスクについて

MID サーバー は、収集されたイベントメッセージを変換して、インスタンス内のイベント (em_table) テーブルのフィールドに入力します。この手順では、ベーシック認証を使用した、形式化されたイベントメッセージの収集について説明しています。サポートされている認証方法については、「MID Web サーバー 拡張の設定」を参照してください。

必要な MID サーバー URL の形式は、http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Transform_script_name} です。MID サーバー スクリプトインクルードの名前は、デフォルトの TransformEvents_ プリフィックスにサフィックスを追加することで構成されます。JSON v2 イベントメッセージの収集については、「MID Web サービスイベントコレクターコンテキストの設定」を参照してください。

注:

http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name} 形式の URL もサポートされています。

手順

1. MID Web サービスイベントコネクターを設定します。「MID Web サービスイベントコレクターコンテキストの設定」を参照してください。
2. MID Web サービスイベントコレクタ―を開始します。

例

カスタムペイロード URL を使用した XML 形式のイベントメッセージの変換

XML 形式のイベントメッセージが MID サーバー に送信されるものとします。この例に従って、収集されたイベントメッセージからイベントオブジェクトのアレイを返します。MID サーバー スクリプトインクルードの名前は、デフォルトの TransformEvents_ プリフィックスにサフィックスを追加することで構成されます。この例のために、ユーザーが xmlSample スクリプトインクルードを指定しています。こうした詳細に従って、 MID サーバー スクリプトインクルードの名前は TransformEvents_xmlSample となります。MID サーバー は、収集したイベントメッセージを変換するために、スクリプトインクルードを使用してメッセージを解析した後、それをインスタンスに送信します。

表 : 1. XML のデータの例

フィールド	値
MID_Server_IP	10.218.64.27
MID_Web_Server_Extension_Port	8097
transform_script_suffix _name	xmlSample

URL 内の変数を上のテーブルの値に置き換えると、http://10.218.64.27:8097/api/mid/em/xmlSample になります。

注:

以下のテキストをコピーして貼り付けると、隠し文字もコピーされることがあり、予期しない結果を招くおそれがあります。

XML 形式のイベントメッセージを示す例：

<records>
    <event>
    <source>My Source</source>
    <node>host1</node>
    <type>type1</type>
    <severity>3</severity>
    <description>Virtual memory usage exceeds 98%</description>
    </event>
    <event>
    <source>My Source</source>
    <node>host2</node>
    <type>type2</type>
    <severity>2</severity>
    <description>Virtual memory usage exceeds 90%</description>
    </event>
    </records>

関連タスク

• MID Web サーバー 拡張の設定
• MID Web サービスイベントコレクターコンテキストの設定