Para consultar todos los sucesos pertenecientes a un grupo de
sucesos, utilice el método queryEventsByEventGroup(String, String,
boolean) del bean EventAccess:
Por qué y cuándo realizar esta tarea
Pasos para realizar esta tarea
- Si necesita crear un bean de acceso a suceso, consulte el apartado Creación de un bean de acceso a suceso.
- Llame al método EventAccess.queryEventsByEventGroup(String,
String, boolean).
CommonBaseEvent[] events = eventAccess.queryEventsByEventGroup(eventGroup,
eventSelector,
ascendingOrder);
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).
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):
CommonBaseEvent[] events =
eventAccess.queryByEventGroup("critical_hosts",
"CommonBaseEvent[@severity > 30]",
true);