イベント・グループからの限定数のイベント照会

イベント・グループからの限定数のイベントを照会することができます。

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

イベント・グループから限定数のイベントを照会するには、EventAccess Bean の queryEventsByEventGroup(String, String, Boolean, int) メソッドを使用します。

このタスクのステップ

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

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

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

ご利用条件 |


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