REST Web サービスへのイベントの転送

特定のイベントを REST Web サービスに転送するように Lenovo XClarity Orchestrator を構成できます。

始める前に

重要

データをこのサービスに転送するとき、セキュアな接続は確立されません。データは、平文プロトコルを使用して送信されます。

このタスクについて

リソース・ベース・アクセス制御が有効になっている場合、データはアクセス制御リストを使用してアクセスできるリソースのみ転送されます。事前定義のスーパーバイザー役割が割り当てられているグループのメンバーではない場合、作成するフォワーダーに 1 つ以上のアクセス制御リストを割り当てる必要があります。アクセスできるすべてのリソースのデータを送信する場合は、関連付けられている使用可能なアクセス制御リストをすべて選択します。事前定義のスーパーバイザー役割が割り当てられているグループのメンバーである場合は、すべてのリソースのデータを送信するか、またはアクセス制御リストを割り当ててリソースを制限することを選択できます。

共通のデータ転送フィルターは、イベント・コード、イベント・クラス、イベント重大度、サービス・タイプ、およびイベントを生成したリソースに基づいて、転送するイベントの範囲を定義するために使用されます。このフォワーダーに使用するイベント・フィルターおよびリソース・フィルターが既に作成されていることを確認します (データ転送フィルターの作成を参照)。

次の例は、REST Web サービスに転送されるデータのデフォルトの形式を示しています。二重角かっこ内の単語は属性であり、データの転送時に実際の値に置き換えられます。

{\"msg\":\"[[EventMessage]]\",\"eventID\":\"[[EventID]]\",\"serialnum\":
\"[[EventSerialNumber]]\",\"senderUUID\":\"[[EventSenderUUID]]\",\"flags\":
\"[[EventFlags]]\",\"userid\":\"[[EventUserName]]\",\"localLogID\":
\"[[EventLocalLogID]]\",\"systemName\":\"[[DeviceFullPathName]]\",\"action\":
[[EventActionNumber]],\"failFRUNumbers\":\"[[EventFailFRUs]]\",\"severity\":
[[EventSeverityNumber]],\"sourceID\":\"[[EventSourceUUID]]\",
\"sourceLogSequence\":[[EventSourceLogSequenceNumber]],\"failFRUSNs\":
\"[[EventFailSerialNumbers]]\",\"failFRUUUIDs\":\"[[EventFailFRUUUIDs]]\",
\"eventClass\":[[EventClassNumber]],\"componentID\":\"[[EventComponentUUID]]\",
\"mtm\":\"[[EventMachineTypeModel]]\",\"msgID\":\"[[EventMessageID]]\",
"sequenceNumber\":\"[[EventSequenceID]]\",\"timeStamp\":\"[[EventTimeStamp]]\",
\"args\":[[EventMessageArguments]],\"service\":[[EventServiceNumber]],
\"commonEventID\":\"[[CommonEventID]]\",\"eventDate\":\"[[EventDate]]\"}"

手順

REST Web サービスにデータを転送するには、以下の手順を実行します。

XClarity Orchestrator のメニュー・バーで、「監視 ()」 > 「転送」をクリックし、左側のナビゲーションで「データ・フォワーダー」をクリックして、「データ・フォワーダー」カードを表示します。
「作成」アイコン () をクリックして、「データ・フォワーダーの作成」ダイアログを表示します。
フォワーダー名と任意の説明を指定します。
「状態」をクリックして切り替え、フォワーダーを有効または無効にします。
フォワーダーのタイプとして「REST」を選択します。
「構成」をクリックし、プロトコル固有の情報を入力します。
- REST サーバーのホスト名または IP アドレスを入力します。
- イベント転送に使用するポートを入力します。デフォルトは 80 です。
- フォワーダーがイベントを転送するリソース・パスを入力します (たとえば、/rest/test)。
- REST メソッドを選択します。これは以下のいずれかの値です。
  - PUT
  - POST
- イベント転送に使用するプロトコルを選択します。これは以下のいずれかの値です。
  - HTTP
  - HTTPS
- 要求のタイムアウト時間 (秒単位) を入力します。デフォルトは 30 秒です。
- 認証が必要な場合は、以下の認証タイプのいずれかを選択します。
  - 基本。指定されたユーザー ID とパスワードを使用して指定されたサーバーへの認証を行います。
  - トークン。指定されたトークンのヘッダー名と値を使用して指定されたサーバーへの認証を行います。
「フィルター」をクリックし、オプションでこのフォワーダーに使用するフィルターを選択します。
最大で 1 つのイベント・フィルターと 1 つのリソース・フィルターを選択できます。
フィルターを選択しない場合は、すべてのリソース (デバイス、リソース・マネージャー、および XClarity Orchestrator) で生成されたすべてのイベントに対してデータが転送されます。
このタブから、「除外イベント」トグルを「はい」に設定することで、除外イベントを転送することもできます。
「アクセス制御リスト」をクリックし、このフォワーダーに関連付けるアクセス制御リストを 1 つ以上選択します。
リソース・ベース・アクセスが有効になっている場合、少なくとも 1 つのアクセス制御リストを選択する必要があります。
ヒント
事前定義のスーパーバイザー役割が割り当てられたグループのメンバーであるユーザーは、オプションとしてアクセス制御リストを選択せずに「すべてを一致させる」を選択すると、転送されるデータが制限されません。
「作成」をクリックして、フォワーダーを作成します。

終了後

「データ・フォワーダー」カードから、以下の操作を実行できます。

「状態」列を選択して切り替え、選択したフォワーダーを有効または無効にします。
「編集」アイコン () をクリックして、選択したフォワーダーを変更します。
「削除」アイコン () をクリックして、選択したフォワーダーを削除します。

フィードバックを送る