メインコンテンツまでスキップ

REST Web サービスへのイベント転送のセットアップ

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

このタスクについて

特定の受信者にイベントを送信するために、最大 20 のイベント・フォワーダーを作成して有効にすることができます。

イベント・フォワーダーの構成後に XClarity Administrator がリブートされた場合、イベントが正しく転送されるためには、管理サーバーによって内部データが再生成されるのを待つ必要があります。

XClarity Administrator v1.2.0 以降の場合、「スイッチ」は「新しいイベント・フォワーダー」ダイアログと「イベント・フォワーダーの変更」ダイアログの「イベント」タブにあります。以前のリリースから 1.2.0 以降にアップグレードした場合は、必ずイベント・フォワーダーを更新して RackSwitch イベントを適切に追加または除外してください。これは、「すべてのシステム」チェックボックスにチェックを入れてすべてのデバイスを選択した場合も必要です。

手順

REST Web サービス用のイベント・フォワーダーを作成するには、以下の手順を実行します。

  1. XClarity Administrator メニュー・バーで、「監視」 > 「イベント転送」をクリックします。「イベント転送」ページが表示されます。
  2. イベント・フォワーダー」タブをクリックします。
  3. 作成」アイコン (「作成」アイコン) をクリックします。「新しいイベント・フォワーダー」ダイアログの「全般」タブが表示されます。
  4. イベント・フォワーダーのタイプとして「REST」を選択し、プロトコル固有の情報を入力します。
    • フォワーダーがイベントを転送するリソース・パスを入力します (たとえば、/rest/test)。

    • イベント転送に使用するプロトコルを選択します。これは以下のいずれかの値です。
      • HTTP

      • HTTPS

    • REST メソッドを選択します。これは以下のいずれかの値です。

      • PUT

      • POST

    • 要求のタイムアウト時間 (秒単位) を入力します。デフォルトは 30 秒です。

    • オプション: 認証が必要な場合は、以下の認証タイプのいずれかを選択します。
      • 基本。指定されたユーザー ID とパスワードを使用して指定されたサーバーへの認証を行います。

      • なし。認証は使用しません。

  5. 出力フォーマット」をクリックして、転送するイベント・データの出力形式を選択します。情報は、イベント・フォワーダーのタイプごとに異なります。

    次の例の出力形式は、REST Web サービス受信者のデフォルトの形式です。二重角かっこ内のすべての単語は変数であり、イベント転送時に実際の値に置き換えられます。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]]\"}"

    デフォルトにリセット」をクリックすると、出力形式をデフォルトのフィールドに戻すことができます。

  6. 除外イベントを許可する」を選択して除外イベントが転送されないようにするか、「除外イベントを許可する」をクリアして除外イベントを転送します。詳しくは、イベントの除外を参照してください。
  7. このフォワーダーを有効化する」を選択して、このイベント・フォワーダーのイベント転送をアクティブ化します。
  8. 次へ」をクリックして、「デバイス」タブを表示します。
  9. このイベント・フォワーダーで監視するデバイスおよびグループを選択します。
    ヒント
    すべての管理対象デバイスのイベント (現行および将来) を転送するには、「すべてのシステムと突き合わせ」チェックボックスにチェックを入れます。

    すべてのシステムと突き合わせ」チェックボックスにチェックを入れなかった場合、選択したデバイスの UUID 列にダミー UUID がないことを確認します。ダミー UUID は、再起動後にリカバリーしていない、または管理サーバーによってすべては検出されていないデバイスに割り当てられます。ダミー UUID のあるデバイスを選択した場合、デバイスがすべて検出され、あるいはリカバリーされてダミー UUID がリアル UUID に変わるまで、イベント転送はこのデバイスに実行されません。

  10. 次へ」をクリックして、「イベント」タブを表示します。
  11. このイベント・フォワーダーで使用するフィルターを選択します。
    • イベント・カテゴリーによって一致
      1. レベルのステータスにかかわらずすべての監査イベントが転送されるようにするには、「すべての監査イベントを含む」を選択します。
      2. すべての保証イベントが転送されるようにするには、「保証イベントを含める」を選択します。
      3. すべてのヘルスの状態変更イベントを転送するには、「ステータス変更イベントを含める」を選択します。
      4. すべてのヘルスの状態更新イベントを転送するには、「ステータス更新イベントを含める」を選択します。
      5. 転送するイベント・クラスと保守容易性レベルを選択します。
      6. 転送から除外する 1 つ以上のイベントの ID を入力します。コンマを使用して ID で区切ります (例: FQXHMEM0214I,FQXHMEM0214I)。
    • イベント・コードの一致。転送する 1 つ以上のイベントの ID を入力します。複数の ID はコンマで区切ります。
    • イベント・カテゴリーで除外
      1. ステータスのレベルに関わらず、すべての監査イベントを除外するには、「すべての監査イベントを除外する」を選択します。
      2. すべての保証イベントを除外するには、「保証イベントを除外する」を選択します。
      3. すべてのヘルスの状態変更イベントを除外するには、「ステータス変更イベントを除外する」を選択します。
      4. すべてのヘルスの状態更新イベントを除外するには、「ステータス更新イベントを除外する」を選択します。
      5. 除外するイベント・クラスと保守容易性レベルを選択します。
      6. 転送する 1 つ以上のイベントの ID を入力します。ID はコンマで区切ります。
    • イベント・コードで除外。除外する 1 つ以上のイベントの ID を入力します。複数の ID はコンマで区切ります。
  12. 特定のタイプのイベントを含めるかどうかを選択します。
    • すべての監査イベントを含む」。選択したイベントのクラスや重大度に基づいて、監査イベントに関する通知を送信します。
    • 保証イベントを含める」。保証に関する通知を送信します。
    • ステータス変更イベントを含める」。ステータスの変更に関する通知を送信します。
    • ステータス更新イベントを含める」。新しいアラートに関する通知を送信しました
    • Bulletin イベントを含める」。新しい Bulletin に関する通知を送信します。
  13. 通知するイベントのタイプと重大度を選択します。
  14. イベントを保守容易性でフィルタリングするかどうかを選択します。
  15. 次へ」をクリックして、「スケジューラー」タブを表示します。
  16. オプション: このイベント・フォワーダーに、指定したイベントを転送する時間と日数を定義します。指定された期間中に発生するイベントのみが転送されます。

    イベント・フォワーダーのスケジュールを作成しない場合、イベントは 24 時間 365 日転送されます。

    1. 左にスクロール」アイコン (「左にスクロール」アイコン) と「右にスクロール」アイコン (「右にスクロール」アイコン)、および「」、「」、「」ボタンを使用して、スケジュールを開始する日付および時刻を見つけます。
    2. タイム・スロットをダブルクリックして、「新しい期間」ダイアログを開きます。
    3. 日付、開始時間および終了時間、スケジュールを再発生させるかどうかなどの必要情報を入力します。
    4. 作成」をクリックしてスケジュールを保存し、ダイアログを閉じます。新しいスケジュールがカレンダーに追加されます。
    ヒント
    • タイム・スロットを変更するには、カレンダーの別のタイム・スロットにスケジュール項目をドラッグします。
    • 期間を変更するには、スケジュール項目の上部または下部を選択してカレンダーの新しい時間にドラッグします。
    • 終了時間を変更するには、スケジュール項目の下部を選択してカレンダーの新しい時間にドラッグします。
    • スケジュールを変更するには、カレンダーのスケジュール項目をダブルクリックして「項目の編集」をクリックします。
    • すべてのスケジュール項目の要約を表示するには、「スケジューラーの要約を表示」を選択します。要約には、各項目のタイム・スロットおよび反復可能な項目が含まれます。
    • カレンダーまたはスケジューラーの要約からスケジュール項目を削除するには、項目を選択して「項目の削除」を選択します。
  17. 作成」をクリックします。

    イベント・フォワーダーが「イベント転送」テーブルに示されます。


    イベント・フォワーダーのリストが表示された「イベント転送」ダイアログ
  18. 新しいイベント・フォワーダーを選択して「テスト・イベントの生成」をクリックします。イベントが適切な REST Web サービスに正しく転送されることを確認します。

終了後

「イベント転送」ページでは、選択したイベント・フォワーダーに対して以下の操作を実行できます。
  • イベント・フォワーダーのリストを更新する。「最新表示」アイコン (「最新表示」アイコン) をクリックします。
  • 特定のイベント・フォワーダーの詳細を表示する。「名前」列のリンクをクリックします。
  • イベント・フォワーダーのプロパティとフィルター基準を変更する。「名前」列でイベント・フォワーダー名をクリックします。
  • イベント・フォワーダーを削除する。「削除」アイコン (「削除」アイコン) をクリックします。
  • イベント転送を一時停止する (イベント転送の一時停止を参照)。