Para consultar todos los sucesos de un grupo de sucesos, utilice el método
queryEventsByEventGroup(serie, serie, booleano) del bean EventAccess.
Por qué y cuándo se efectúa esta tarea
Pasos para realizar esta tarea
- Si necesita crear un bean de acceso a sucesos, consulte el apartado Creación de un bean de acceso a sucesos.
- Llame al método EventAccess.queryEventsByEventGroup(serie, serie,
booleano).
CommonBaseEvent[] events = eventAccess.queryEventsByEventGroup(grupo_sucesos,
selector_sucesos,
orden_ascendente);
Los parámetros de este método son los siguientes:
- grupo_sucesos
- Serie que contiene el nombre del grupo de sucesos del que desea consultar
sucesos. Debe ser el nombre de un grupo de sucesos existente definido en la
configuración de la infraestructura de sucesos.
- selector_sucesos
- Serie que contiene un selector de suceso opcional que define más detalladamente
la consulta. La consulta sólo devuelve los sucesos que coincidan con el grupo de
sucesos especificado y el selector de sucesos adicional. Un selector de sucesos se
especifica con la forma de una expresión XPath (para obtener más información,
consulte el apartado Escritura de selectores de sucesos).
Si no desea especificar un selector de sucesos adicional, este parámetro puede quedar vacío.
- orden_ascendente
- Valor booleano que especifica si los sucesos devueltos deben ordenarse en orden
descendente o descendente de acuerdo con el valor de la propiedad creationTime. Si
este parámetro es true, los sucesos se ordenan en orden ascendente
(cronológico); si es false, se ordenan en orden descendente (cronológico
inverso).
El objeto devuelto es una matriz que
contiene los sucesos de grupo de sucesos especificado.
Nota: Si el número de
sucesos coincidentes supera el umbral de consulta definido en el perfil de almacén
de datos, se emitirá una excepción QueryThresholdExceededException. El umbral de
consulta predeterminado es 100.000.
Ejemplo
El fragmento de código siguiente devuelve todos los sucesos que
pertenecen a un grupo de sucesos llamado
sistemas_principales_críticos y
cuya gravedad es mayor que 30 (aviso):
CommonBaseEvent[] events =
eventAccess.queryByEventGroup("sistemas_principales_críticos",
"CommonBaseEvent[@severity > 30]",
true);