Puede consultar un número limitado de sucesos de un grupo de sucesos.
Por qué y cuándo se efectúa esta tarea
Para consultar un número limitado de sucesos de un grupo de sucesos,
utilice el método queryEventsByEventGroup(serie, serie, booleano, entero) del
bean EventAccess.
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, entero).
CommonBaseEvent[]
events = eventAccess.queryEventsByEventGroup(grupo_sucesos,
selector_sucesos,
orden_ascendente,
sucesos_máximos);
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 sucesos 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).
- sucesos_máximos
- Entero que especifica el número máximo de sucesos que desea que se devuelva.
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), pero especifica que no deben devolverse más de 5.000 eventos
coincidentes:
CommonBaseEvent[] events =
eventAccess.queryByEventGroup("sistemas_principales_críticos",
"CommonBaseEvent[@severity > 30]",
true,
5000);