イベント・グループからのすべてのイベントの照会

イベント・グループからすべてのイベントを照会するためには、EventAccess Bean の queryEventsByEventGroup(String, String, boolean) メソッドを使用します。

このタスクを実行する理由と時期

このタスクのステップ

  1. イベント・アクセス Bean を作成する必要がある場合は、イベント・アクセス Bean の作成を参照してください。
  2. EventAccess.queryEventsByEventGroup(String, String, boolean) メソッドを呼び出します。
    CommonBaseEvent[] events = eventAccess.queryEventsByEventGroup(eventGroup,
                                                                   eventSelector,
                                                                   ascendingOrder);
    このメソッドのパラメーターは、以下のとおりです。
    eventGroup
    イベント・グループの名前を含む文字列。このグループ内のイベントが照会されます。これは、イベント・インフラストラクチャー構成で定義されている 既存のイベント・グループの名前である必要があります。
    eventSelector
    照会を詳細化するイベント・セレクターを含む文字列 (オプション)。この照会を行うと、指定したイベント・グループと追加のイベント・セレクターの両方にマッチするイベントのみ返されます。 イベント・セレクターは、XPath 式の形式で指定されています (詳しくは、イベント・セレクターの書き込みを参照してください)。 追加のイベント・セレクターを指定しない場合は、このパラメーターをヌルにします。
    ascendingOrder
    返されるイベントを、creationTime プロパティーの値に従い昇順にソートするか降順にソートするか指定するブール値。このパラメーターを true に設定すると、イベントは昇順 (発生順) にソートされます。また false に設定すると、降順 (新しい順) にソートされます。

    返されるオブジェクトは、指定したイベント・グループ内のイベントを含む配列です。

    注: マッチするイベントの数が、データ・ストア・プロファイルで定義されている照会しきい値を超える場合、QueryThresholdExceededException 例外がスローされます。デフォルトの照会しきい値は 100 000 です。
以下のコードの断片では、critical_hosts という名前のイベント・グループに属する、重大度が 30 (警告) より大きいイベントがすべて返されます。
CommonBaseEvent[] events =
        eventAccess.queryByEventGroup("critical_hosts",
                                      "CommonBaseEvent[@severity > 30]",
                                      true);

ご利用条件 |


(c) Copyright IBM Corporation 2005, 2006.
本製品では Eclipse テクノロジーが採用されています。(http://www.eclipse.org)