Reportes de opEvents: Análisis y Generación de Informes de Eventos
Introducción
En esta página se describen los reportes disponibles en opEvents, los cuales pueden generarse de forma automática o manual desde el apartado Vistas > Resumen de Reportes (Views > Summary Reports). Su objetivo es ofrecer una visión consolidada del comportamiento de los eventos registrados en la infraestructura del cliente durante un periodo determinado.
Estos reportes permiten a los equipos de operación y a los responsables de la toma de decisiones identificar tendencias, evaluar la estabilidad del servicio y priorizar acciones de mejora a partir del análisis de eventos, los cuales pueden clasificarse por severidad, tipo y nodo afectado.
Su enfoque está orientado a facilitar el seguimiento operativo, el control de incidentes recurrentes y la medición de la salud general de la infraestructura, evitando la necesidad de revisar eventos individuales de forma manual.
¿Qué son los reportes de opEvents?
Son reportes que pueden generarse en opEvents y están diseñados para desglosar los eventos registrados, proporcionando una visión integral del comportamiento y desempeño de la infraestructura monitoreada. Permiten identificar nodos críticos, eventos recurrentes y patrones de incidentes, con el fin de apoyar la priorización de acciones correctivas y el fortalecimiento de la gestión preventiva.
Estos reportes concentran la información de los eventos detectados en los nodos del entorno durante un periodo de tiempo específico.
Reporte Diario (Daily Report): proporciona una vista diaria de los eventos generados.
Información destacada:
Recuento de eventos por nodo durante el día
Recuento de eventos por prioridad
Impactos relevantes al servicio
Duración de incidentes por nodo
Reporte Semanal (Weekly Report): proporciona una vista semanal de los eventos generados.
Información destacada:
Patrones semanales de eventos
Comparación entre días
Identificación de eventos repetitivos
Principales causas por nodo
Nodos con mayor impacto operativo
Reporte Mensual (Monthly Report): proporciona una vista mensual de los eventos generados.
Información destacada:
Análisis histórico y comparativo
Tendencias de crecimiento o reducción de eventos
Identificación de fallas crónicas o estructurales
Indicadores de estabilidad operativa
Estos reportes permiten contar con una vista histórica y resumida de lo ocurrido en un periodo determinado, evitando la revisión individual de eventos en tiempo real.
¿Cuál es su enfoque?
El enfoque de este tipo de reportes es operativo y analítico, con el objetivo de ofrecer una visión clara de lo ocurrido en la operación, la forma en que se han atendido los eventos y el impacto generado, tomando como base la información registrada. No están orientados al monitoreo en tiempo real.
Están diseñados para apoyar:
El análisis de comportamientos
La identificación de recurrencias
La detección de problemas repetitivos
La evaluación de la estabilidad del entorno
Asimismo, permiten responder preguntas como:
¿Qué tipos de eventos ocurren con mayor frecuencia?
¿Qué nodos o servicios generan más alertas?
¿Los incidentes aumentan o disminuyen con el tiempo?
¿Qué beneficios ofrecen?
Los reportes de opEvents permiten transformar la información generada en la operación diaria en insumos claros para su control y seguimiento. A partir del aprovechamiento de los datos capturados por la plataforma, se obtienen beneficios relevantes, entre los que destacan:
Visión consolidada de eventos
Proporcionan una vista concentrada de los eventos, reduciendo la necesidad de revisar logs o alertas individuales.
Ahorro de tiempo operativo
Una vista general permite evaluar el estado del sistema en menor tiempo que mediante revisiones individuales por equipo.
Mejor toma de decisiones
Facilitan la priorización de acciones de mejora, ajustes y correcciones.
Análisis de equipos y del entorno
Permiten identificar patrones como fallas recurrentes, degradación de servicios y franjas horarias con mayor incidencia.
Soporte para auditorías
Resultan útiles para fines de documentación, cumplimiento y revisiones internas.
¿Cuál es su propósito?
El propósito de estos reportes es convertir el registro técnico de eventos en información accionable para la gestión de la operación, facilitando la detección de riesgos, la planeación de acciones correctivas y la prevención de incidencias futuras.
A través de su uso es posible:
Transformar los eventos registrados en indicadores del comportamiento de los equipos y servicios
Identificar condiciones crónicas y definir planes de mitigación
Sustentar iniciativas de mejora continua en el entorno monitoreado
Evaluar la evolución operativa con base en evidencia registrada
Analizar el contexto de las alertas asociadas a uno o varios eventos para comprender su origen e impacto
Respaldar la gestión de la infraestructura mediante evidencia histórica consolidada
Los reportes de opEvents complementan el monitoreo operativo al proporcionar una base analítica para la planificación y el control del servicio.
Información sobre las secciones de un reporte
Al generar un reporte de forma manual, el sistema muestra una ventana en la que se debe especificar el nombre que se asignará al reporte y el periodo de análisis correspondiente (MM-DD-AAAA).
Tabla de Resumen
El reporte generado presenta al inicio una tabla de Resumen, la cual incluye el número total de eventos registrados en el periodo seleccionado, el total de eventos almacenados en la base de datos al momento de la generación del reporte y la cantidad de nodos habilitados en el módulo, entre otros indicadores.
A continuación se explica con detalle la tabla de Resumen:
Sección | Descripción |
Periodo del reporte | Intervalo de fechas definido para el análisis del reporte |
Eventos en el periodo del reporte | Total de eventos ocurridos dentro del periodo seleccionado; indica el volumen de alertas generadas en ese intervalo |
Promedio de eventos por segundo en el periodo del reporte | Frecuencia promedio de generación de eventos durante el periodo analizado |
Total events in database (Total de eventos en la base de datos) | Número total de eventos almacenados en toda la base de datos de opEvents al momento de generar el reporte |
Average events per second (Eventos promedio por segundo) | Promedio histórico de eventos por segundo considerando la totalidad de la base de datos |
Nodos habilitados | Total de nodos configurados para ser monitoreados por la plataforma |
Nodos con eventos en el periodo del reporte | Cantidad de nodos que registraron al menos un evento durante el periodo analizado |
periodo de mayor actividad por recuento de eventos | Intervalo de 24 horas con la mayor cantidad de eventos registrados |
Eventos del periodo más activo | Número total de eventos generados durante el intervalo de mayor actividad |
periodo de mayor actividad por recuento de incidentes | Intervalo de 24 horas con el mayor número de incidentes activos o abiertos |
Incidentes del periodo más activo | Total de incidentes registrados en el intervalo de máxima actividad dentro del periodo analizado. |
Top 10 nodos por recuento de eventos
Esta sección presenta el listado de los diez nodos con mayor número de eventos registrados durante el periodo analizado. Proporciona una vista comparativa de la frecuencia de eventos por nodo, permitiendo identificar de forma rápida los equipos con mayor volumen de alertas, posibles focos de inestabilidad y candidatos prioritarios para revisión operativa. Asimismo, facilita la detección de concentraciones anómalas de eventos y el establecimiento de acciones de seguimiento y mejora.
Top 10 eventos por recuento
Esta sección presenta el listado de los diez tipos de eventos más frecuentes registrados durante el periodo analizado, independientemente de los nodos en los que se hayan originado. Ofrece una vista agregada de las alertas más comunes del entorno, lo que facilita la identificación de patrones de falla, condiciones recurrentes y posibles causas raíz. Esta información permite priorizar tareas de ajuste, correlación y remediación, así como evaluar la efectividad de las acciones preventivas implementadas.
Prioridades de eventos por recuento
En opEvents, cada evento cuenta con una propiedad de prioridad (configurable y dinámica). Esta sección muestra la distribución y frecuencia de eventos por nivel de prioridad durante el periodo cubierto por el reporte.
La información permite visualizar la proporción de eventos críticos, mayores, menores e informativos, facilitando la evaluación del nivel de severidad predominante en la operación. Asimismo, ayuda a identificar incrementos inusuales en prioridades altas, validar la correcta clasificación de alertas y ajustar reglas de generación o escalamiento cuando sea necesario.
Top 10 nodos y eventos por recuento de eventos
Esta sección presenta las combinaciones de nodo y tipo de evento con mayor frecuencia durante el periodo analizado, clasificadas según el número de ocurrencias de cada combinación. De esta forma, no solo se identifica qué eventos son más comunes o qué nodos generan más alertas, sino específicamente qué pares nodo–evento concentran la mayor actividad.
Este enfoque permite detectar relaciones directas entre equipos y tipos de falla, facilitando la identificación de problemas puntuales, condiciones repetitivas en dispositivos específicos y posibles causas raíz asociadas a configuraciones o componentes concretos.
En entornos altamente homogéneos, la categoría "Otro" tiende a concentrar la mayor proporción, mientras que las combinaciones específicas nodo/evento se distribuyen en segmentos de tamaño similar y relativamente pequeño, lo que indica una dispersión uniforme de los eventos. En cambio, cuando una combinación destaca claramente, puede señalar un foco específico que requiere atención prioritaria.
Top 10 nodos por peso de evento
Esta sección presenta los diez nodos con mayor peso de eventos durante el periodo analizado. El peso se calcula como el número de eventos multiplicado por su nivel de prioridad, por lo que combina volumen y severidad en un solo indicador.
De esta manera, una gran cantidad de eventos de baja prioridad puede tener un impacto equivalente al de pocos eventos de alta prioridad. Este enfoque permite identificar nodos cuyo impacto operativo no solo depende de la cantidad de alertas generadas, sino también de su criticidad.
La comparación entre el recuento total de eventos y el peso acumulado permite detectar rápidamente nodos con alta concentración de eventos críticos. Cuanto mayor sea la diferencia entre ambas métricas en la visualización, mayor será la proporción de eventos de alta prioridad asociados a ese nodo. Esta información resulta útil para priorizar revisiones técnicas y acciones correctivas.
Top 10 nodos por duración del incidente
Esta sección presenta los diez nodos con mayor duración acumulada de incidentes durante el periodo analizado, es decir, aquellos que concentraron el mayor tiempo total de afectación operativa.
En opEvents, un incidente se define como un intervalo de indisponibilidad o degradación para una entidad con estado (por ejemplo, un nodo, una interfaz o un servicio supervisado). El gráfico circular muestra los nodos ordenados según la suma de las duraciones de todos sus incidentes.
La tabla asociada proporciona métricas detalladas que facilitan la diferenciación entre nodos con muchos incidentes de corta duración y nodos con pocos incidentes pero con tiempos de inactividad prolongados. Este análisis ayuda a identificar problemas de estabilidad sostenida, evaluar el impacto real en la disponibilidad y priorizar acciones de remediación enfocadas en reducir el tiempo total de interrupción.
Top 10 nodos e incidencias por duración
Esta sección presenta la visualización de los nodos y tipos de incidente con mayor duración acumulada durante el periodo analizado, combinando una gráfica de duración con una tabla de detalle.
La tabla incluye, para cada combinación nodo–incidente, métricas como la duración total acumulada, la duración máxima registrada, la duración promedio y el número de ocurrencias. Este nivel de desglose permite distinguir entre incidentes frecuentes de corta duración y eventos menos comunes pero con afectaciones prolongadas.
Duración total: tiempo acumulado de indisponibilidad o afectación asociado a ese nodo, sumando la duración de todos sus incidentes en el periodo del reporte. Permite identificar qué nodos concentraron mayor tiempo total de impacto operativo.
Duración máxima: mayor duración registrada para un solo incidente en ese nodo. Corresponde al incidente individual más largo ocurrido en el periodo. Ayuda a detectar caídas prolongadas o eventos de larga recuperación.
Duración promedio: tiempo promedio de duración de los incidentes del nodo. Se calcula como: duración total ÷ número de incidentes.
Recuento de incidentes: número total de incidentes registrados para ese nodo en el periodo analizado.
Porcentaje (por duración total): proporción que representa la duración acumulada de incidentes de ese nodo respecto al total de duración de incidentes de todos los nodos incluidos en la tabla. Permite dimensionar el peso relativo del nodo en el impacto global. Por ejemplo, si un nodo muestra 6.8%, significa que concentró el 6.8% del tiempo total de incidentes del conjunto analizado.
Interpretación de la tabla:
duración total alta + recuento bajo = pocos incidentes pero muy largos
duración total alta + recuento alto = muchos incidentes y además prolongados
duración promedio alto = incidentes típicamente largos
duración máxima muy alta = existe al menos un evento crítico prolongado
En opEvents, este análisis facilita la identificación de problemas persistentes, degradaciones sostenidas y puntos críticos de disponibilidad, proporcionando elementos objetivos para priorizar acciones correctivas y estrategias de prevención.
Resumen de duración de incidentes
Esta sección muestra la distribución de los incidentes según su duración, agrupados en intervalos resumidos de un día. Su objetivo es ofrecer una vista estadística del tiempo de afectación, permitiendo identificar cómo se reparte la duración de los incidentes dentro del periodo analizado.
La visualización permite distinguir rápidamente si predominan incidentes de corta, mediana o larga duración, así como detectar la presencia de casos atípicos con tiempos de inactividad extendidos. Este resumen facilita la evaluación del comportamiento general de la recuperación del servicio y la efectividad de los tiempos de atención.
En opEvents, esta información sirve como referencia para el análisis de tendencias de disponibilidad y para la definición de objetivos de mejora en los tiempos de resolución.
Resumen de eventos para periodos de 1 día
Esta sección presenta una gráfica de barras con el total de eventos registrados por día dentro del intervalo analizado. Cada barra representa un periodo de 24 horas y permite visualizar la variación diaria en el volumen de eventos.
La vista facilita la identificación de picos y caídas de actividad, así como la detección de comportamientos atípicos o cambios en la carga de alertas a lo largo del tiempo. A partir de esta información es posible correlacionar incrementos de eventos con ventanas de mantenimiento, fallas masivas o cambios operativos.
Este resumen diario, generado por opEvents, sirve como referencia rápida para reconocer tendencias de corto plazo y seleccionar fechas específicas que requieran un análisis más detallado en las secciones desglosadas del reporte.
Resumen de incidentes para periodos de 1 día
Esta sección presenta una gráfica de barras con el número de incidentes registrados por día dentro del intervalo analizado. Cada barra representa un periodo de 24 horas y muestra cuántos incidentes estuvieron activos o se generaron en esa fecha.
La visualización permite identificar variaciones diarias en la cantidad de incidentes, detectar picos de afectación, periodos de estabilidad relativa y posibles ciclos de recurrencia. También facilita la correlación con cambios operativos, mantenimientos programados o fallas relevantes en la infraestructura.
En conjunto con el resumen diario de eventos, este gráfico de opEvents ayuda a diferenciar entre volumen de alertas y número de incidentes consolidados, aportando una perspectiva más cercana al impacto operativo real.
Al acceder a Vistas > Resumen de Reportes (Views > Summary Reports) en opEvents, es posible descargar los reportes generados en formato XLSX para su análisis y distribución externa.
El archivo exportado incluye cada una de las secciones del reporte en hojas de cálculo independientes, junto con sus respectivas gráficas y tablas de datos. Esta estructura facilita la revisión detallada de la información, el filtrado y ordenamiento de métricas, así como la reutilización de los datos para presentaciones, auditorías o análisis adicionales.
La exportación a XLSX permite además:
Trabajar la información de forma offline
Integrar los resultados con otras fuentes de datos
Generar reportes personalizados a partir de las tablas base
Compartir resultados con áreas operativas y de gestión sin requerir acceso directo a la plataforma
Navegación interactiva desde la tabla de Resumen
Al consultar los reportes directamente en el módulo de opEvents, la tabla de Resumen incluye campos con enlaces interactivos (mostrados en azul) que permiten acceder a vistas detalladas relacionadas con cada métrica.
Estos enlaces dirigen a tablas y gráficas específicas que desglosan la información del indicador seleccionado, tales como periodos de mayor actividad, listados de eventos, incidentes asociados o distribuciones por intervalo de tiempo. De esta forma, el usuario puede pasar de una vista consolidada a un análisis detallado con un solo clic.
El uso de estos vínculos facilita:
La exploración guiada de los datos del reporte
El acceso rápido a los periodos o métricas más relevantes
La validación del detalle detrás de los valores agregados
La navegación entre resumen ejecutivo y evidencia técnica
Esta funcionalidad permite realizar análisis progresivo, partiendo del resumen general hacia el detalle operativo sin necesidad de ejecutar consultas adicionales.
Link de la sección "Periodo del reporte"
Al seleccionar el enlace en "Periodo del reporte", se despliega una tabla con el detalle completo de los eventos registrados dentro del intervalo analizado.
Esta vista presenta el listado de eventos con sus principales atributos como: fecha y hora, nodo origen, tipo de evento, prioridad, estado e información descriptiva, permitiendo revisar el detalle operativo que respalda los indicadores del resumen. Desde esta tabla es posible ordenar y filtrar los registros para facilitar el análisis puntual, la validación de picos de actividad y la identificación de casos específicos.
Link de la sección "Periodo de mayor actividad por recuento de eventos"
Al seleccionar el enlace "Periodo de mayor actividad por recuento de eventos", se abre una vista detallada que muestra la tabla de eventos correspondientes al intervalo de 24 horas con mayor volumen de registros dentro del reporte.
Esta tabla concentra exclusivamente los eventos generados en ese periodo de máxima actividad e incluye sus campos principales: fecha, nodo, tipo de evento, prioridad y descripción; lo que permite analizar con mayor precisión qué originó el incremento de alertas. A partir de esta información es posible identificar concentraciones por nodo, eventos dominantes y posibles causas operativas asociadas al pico observado, facilitando el análisis de impacto y la validación de comportamientos anómalos.
Link de la sección "Eventos del periodo más activo"
Al seleccionar el enlace en "Eventos del período más activo", se despliega una tabla con el conjunto de eventos que conforman el intervalo identificado como el de mayor actividad dentro del reporte.
Esta vista permite examinar en detalle los registros que contribuyen al total indicado en el resumen, mostrando los atributos relevantes de cada evento. Su consulta facilita validar el volumen reportado, identificar qué categorías de eventos dominaron ese periodo y reconocer si el incremento estuvo asociado a nodos o condiciones específicas. Asimismo, permite aplicar filtros y ordenamientos para profundizar en el análisis del comportamiento observado.
Link de la sección "Periodo de mayor actividad por recuento de incidentes"
Al seleccionar el enlace en Período de mayor actividad por recuento de incidentes, se abre una vista detallada con la tabla de incidentes correspondientes al intervalo de 24 horas que concentró el mayor número de incidentes dentro del reporte.
Esta tabla muestra el detalle de los incidentes registrados en ese periodo, lo que permite analizar con precisión el momento de mayor impacto operativo. La vista facilita identificar concentraciones por nodo o servicio, reconocer patrones de indisponibilidad y evaluar si el incremento de incidentes estuvo asociado a una causa común o a múltiples eventos independientes.
Información sobre la prioridad en opEvents
Los eventos se presentan clasificados de acuerdo con la siguiente tabla:
Prioridad en opEvents | Nivel en NMIS |
0 | n/a |
1 | n/a |
2 | Normal |
3 | Warning |
4 | n/a |
5 | Minor |
6 | Major |
7 | Critical |
8 | Fatal |
9 | n/a |
10 | n/a |
Envío de reportes por correo
Es posible enviar los reportes generados en opEvents vía correo electrónico, ya sea de forma manual ejecutando una instrucción en la consola del servidor o de manera automática utilizando el archivo opCommon.json.
Configurar servidor de correo
Acceder a la carpeta
/usr/local/omk/conf/Realizar una copia de seguridad del archivo
opCommon.jsonEditar el archivo y configurar un servidor de correo en la sección
"email", por ejemplo:
...
"email" : {
"mail_from" : "notificaciones@dominio.com",
"mail_server_port" : 587,
"mail_password" : "password",
"mail_domain" : "http://dominio.com ",
"mail_server" : "smtp.dominio.com",
"mail_use_tls" : "true",
"mail_user" : "notificaciones@dominio.com"
},
...Guardar los cambios y validar la integridad del archivo (deberá devolver todo el contenido del archivo .json; en caso de ver algún error, revisar en qué línea es):
jq . opCommon.json
Reiniciar demonios
service omkd restart
service opeventsd restart
Generación y envío de reportes de forma manual
opEvents permite generar reportes directamente desde la línea de comandos mediante la ejecución del siguiente comando:
/usr/local/omk/bin/opevents-cli.pl act=create-report {start=<fecha/hora> end=<fecha/hora> | [daily|weekly|monthly]=true} [topn=N] [summary_int=NM[dhm]] [path=<archivo_salida.xlsx>] [email=usuario@dominio] [title="Título del reporte"]
Este comando crea un reporte en formato XLSX con la misma información disponible en los reportes del módulo web, permitiendo automatizar su generación, guardarlo en archivo y/o enviarlo por correo electrónico.
path=/ruta/archivo_salida.xlsx: guarda el reporte generado en la ruta y nombre de archivo indicados, en formato XLSX. Es importante guardar el reporte para poder descargarlo si no se va a enviar por correo electrónico.
title="Título del reporte": sirve para darle un título al reporte y poder identificarlo.
start / end: define la fecha y/u hora de inicio y fin del periodo a analizar. Se pueden usar todos los formatos de fecha/hora soportados por opEvents (fechas absolutas o relativas). Por ejemplo: los siguientes valores crearán un reporte del 24 de mayo del 2025 a las 00:00hrs al 25 de mayo a las 00:00hrs.
start=2025-05-24T00:00:00 end=2025-05-25T00:00:00
daily / weekly / monthly = true: genera un reporte automático diario, semanal o mensual.
Hace opcionales los parámetros start y end.
Si se usa daily sin start ni end, el reporte se genera de un día anterior (por ejemplo: si el comando se ejecuta de manera manual el 16 de febrero, el reporte se generará del 15 de febrero a las 00:00hrs al 16 de febrero a las 00:00hrs).
Si se usa weekly sin start ni end, el reporte se genera de la semana anterior en la que se ejecuta la instrucción (por ejemplo: si el comando se ejecuta de manera manual el 16 de febrero, el reporte se generará del 8 de febrero a las 00:00hrs al 15 de febrero a las 00:00hrs).
Si se usa monthlysin start ni end, el reporte se genera del mes anterior a la fecha en la que se ejecuta (por ejemplo: si el comando se ejecuta de manera manual el 16 de febrero, el reporte se generará del 1 de enero al 1 de febrero).
topn=N: define cuántos elementos incluir en los listados "Top" (por ejemplo, Top nodos, Top eventos). Si se especifica, reemplaza el valor por defecto que es 10.
summary_int=NM[dhm]: controla el tamaño de los bloques de tiempo con los que se calculan y muestran las estadísticas y gráficas de resumen (eventos e incidentes). Esto impacta directamente en el nivel de detalle de las visualizaciones.
N = cantidad numérica
M → d=días u h=horas o m=minutos
Ejemplos:
summary_int=1d: agrupa todos los eventos/incidentes por día; útil para reportes de varias semanas o meses.summary_int=6h: divide cada día en bloques de 6 horas; útil para identificar variaciones dentro del mismo día.summary_int=30m: genera una vista muy detallada con intervalos de media hora; útil para análisis de picos o ventanas específicas de falla.
Si se define este parámetro, se usa en lugar del intervalo automático calculado por la duración del reporte. Si no se especifica este parámetro, el sistema calcula automáticamente el intervalo según la duración total del reporte.
¿Cómo afecta el resultado? El valor definido indica el tamaño de cada intervalo de agrupación:
Intervalos más grandes: vista más resumida, menos barras/puntos en las gráficas.
Intervalos más pequeños: vista más detallada, mayor granularidad temporal.
email=usuario@dominio: envía el reporte generado a la dirección de correo especificada.
title="texto": permite definir un título personalizado para el reporte.
Validación de recepción de correo
Si el comando anterior se ejecuta utilizando la opción email=usuario@dominio, se enviará un correo que contendrá el archivo adjunto y el link de referencia del reporte generado, dependiendo de las opciones que se le hayan proporcionado.
Ejemplos prácticos:
Reporte de un día: del 10 de febrero del 2026 a las 00:00hrs al 11 de febrero del 2026 a las 00:00hrs.
/usr/local/omk/bin/opevents-cli.pl act=create-report start=2026-02-10T00:00:00 end=2026-02-11T00:00:00 email=usuario@dominio title="report"
Reporte de una semana, generado el 9 de febrero de 2026: del 1 de febrero del 2026 a las 00:00hrs al 8 de febrero del 2026 a las 00:00hrs.
/usr/local/omk/bin/opevents-cli.pl act=create-report weekly=true email=usuario@dominio title="report"
Reporte generado el 9 de febrero de 2026:
/usr/local/omk/bin/opevents-cli.pl act=create-report monthly=true email=usuario@dominio title="report"
Los archivos adjuntos contienen las secciones del reporte en cada una de sus hojas de cálculo.
Programación de envío automático de reportes
Para programar el envió automático de reportes, se utiliza el archivo opCommon.json.
Acceder a la carpeta
/usr/local/omk/conf/Realizar una copia de seguridad del archivo
opCommon.jsonEditar el archivo y ubicar la siguiente sección:
...
"opevents_daily_report_recipients" : [], #lista de correos a los que se enviara el reporte diario
"opevents_daily_report_title" : "Daily Summary Report",
"opevents_weekly_report_recipients" : [], #lista de correos a los que se enviara el reporte semanal
"opevents_weekly_report_title" : "Weekly Summary Report",
"opevents_monthly_report_recipients" : [], #lista de correos a los que se enviara el reporte mensual
"opevents_monthly_report_title" : "Monthly Summary Report",
...Agregar las direcciones según los reportes que desean enviarse de forma automática.
Para configurar más de un correo, deberán de separarse con comas, quedando de la siguiente manera:
...
"opevents_daily_report_recipients" : ["usuario1@dominio.com","usuario2@dominio.com","usuario3@dominio.com","usuario4@dominio.com"],
"opevents_daily_report_title" : "Daily Summary Report",
"opevents_weekly_report_recipients" : [],
"opevents_weekly_report_title" : "Weekly Summary Report",
"opevents_monthly_report_recipients" : [],
"opevents_monthly_report_title" : "Monthly Summary Report",
...Guardar los cambios y validar la integridad del archivo (deberá devolver todo el contenido del archivo .json; en caso de ver algún error, revisar en qué línea es):
jq . opCommon.json
Reiniciar demonios
service omkd restart
service opeventsd restart
Cuando se genere un reporte de forma automática, se enviará a los correos configurados.
Consumo de API
Para elaborar el resumen del reporte de eventos, es importante señalar que actualmente no se cuenta con acceso directo a las API de los datos correspondientes, por lo que la información debe consolidarse mediante una hoja de cálculo. Por otro lado, en el caso del módulo opEvents, este si dispone de API nativas que permiten realizar consultas directas a los eventos, lo que facilita obtener y validar información con mayor detalle. Con base en el análisis realizado y en la información recopilada, se adjunta el acceso en el siguiente enlace.
TopN
Cuando se crea report_data, no se aplica ningún filtro TopN; de este modo, los datos del informe almacenados en la base de datos contienen toda la información.
Cuando se procesa la información requerida se exporta el reporte al formato HTML, hoja de cálculo o correo electrónico, aplicando el valor TopN.
La interfaz gráfica para visualizar reportes no permite configurar TopN, sin embargo, el endpoint sí lo admite. Por lo tanto, al agregar ?o_topn=50 a la URL, se mostrarán los 50 primeros elementos. Puede utilizarse cualquier valor numérico.
Por ejemplo:
https://[ip del servidor]/en/omk/opEvents/reports/[número del reporte creado]?o_topn=50
Antes de agregar ?o_topn=50:
Después de agregar se muestra en la captura, el título de la gráfica indica ‘Top de 50 eventos’, reflejando que se está aplicando el parámetro TopN con un valor de 50.
El comando opevents-cli para la acción act=create-report acepta el parámetro [topn=N], cuyo valor predeterminado es 10. El report_data almacenado en la base de datos conserva todos los datos de eventos. Sin embargo, el parámetro topn es requerido debido a que create-report también se procesa para generar hojas de cálculo o correos electrónicos, por lo que el sistema necesita conocer cuántos elementos deben incluirse en los datos exportados.
Contenido relacionado
Envío de alertas: opEvents a email y a otros gestores