Consulta de un número limitado de sucesos pertenecientes a un grupo de sucesos

Puede consultar un número limitado de sucesos pertenecientes a un grupo de sucesos.

Por qué y cuándo realizar esta tarea

Para consultar un número limitado de sucesos pertenecientes a un grupo de sucesos, utilice el método queryEventsByEventGroup(String, String, Boolean, int) del bean EventAccess:

Pasos para realizar esta tarea

  1. Si necesita crear un bean de acceso a suceso, consulte el apartado Creación de un bean de acceso a suceso.
  2. Llame al método EventAccess.queryEventsByEventGroup(String, String, boolean, int).
    CommonBaseEvent[] events =  eventAccess.queryEventsByEventGroup(eventGroup,
                                                                   eventSelector,
                                                                   ascendingOrder,
                                                                   maxEvents);
    Los parámetros de este método son los siguientes:
    eventGroup
    Una serie que contiene el nombre del grupo de sucesos del que desea consultar los sucesos. Debe ser el nombre de un grupo de sucesos existente definido en la configuración de la infraestructura de sucesos.
    eventSelector
    Una serie que contiene un selector de sucesos opcional que refina adicionalmente la consulta. La consulta devuelve solamente los sucesos que coincidan con el grupo de sucesos especificado y con el selector de sucesos adicional. Un selector de sucesos se especifica con el formato de una expresión XPath (para obtener más información, consulte el apartado Grabación de selectores de sucesos). Si no desea especificar un selector de sucesos adicional, este parámetro puede ser nulo.
    ascendingOrder
    Un valor booleano que especifica si se han de clasificar los sucesos en orden ascendente o descendente según el valor de la propiedad creationTime. Si el valor de este parámetro es true, los sucesos se clasifican por orden ascendente (cronológico). Si su valor es false, se clasifican por orden descendente (orden cronológico inverso).
    maxEvents
    Un entero que especifica el número máximo de sucesos que desea que se le devuelva.

    El objeto devuelto es una matriz que contiene los predecesores del grupo de sucesos especificado.

    Nota: Si el número máximo de sucesos coincidente supera el umbral definido para la consulta en el perfil del almacén de datos, se genera una excepción QueryThresholdExceededException. El umbral de consulta por omisión es 100.000.
El siguiente fragmento de código devuelve todos los sucesos que pertenecen a un grupo de sucesos llamado critical_hosts y cuya gravedad es mayor que 30 (warning), pero especifica que no se devuelvan más de 5000 sucesos coincidentes:
CommonBaseEvent[] events =
        eventAccess.queryByEventGroup("critical_hosts",
                                      "CommonBaseEvent[@severity > 30]",
                                      true,
                                      5000);

Condiciones de uso |


(c) Copyright IBM Corporation 2005, 2006.
Este centro de información está basado en tecnología Eclipse (http://www.eclipse.org)