Visualizar eventos

Configure y filtre consultas en eventos de CDF y anote los eventos en gráficos en su tablero de Grafana. Puede personalizar el intervalo de tiempo, los eventos que se mostrarán y las columnas según sus necesidades.

Trabajar con eventos en una tabla

Abra la pestaña Evento en Grafana para trabajar con los eventos en una tabla.

Definir una consulta

La consulta events utiliza el punto final eventos/lista para recuperar datos.

Formato: events{someFilter=number, otherFilter="string"}

Ejemplo:

events{externalIdPrefix='WORKORDER', assetSubtreeIds=[{id=12}, {externalId='ext_id'}]}

Puede filtrar por estas propiedades: externalIdPrefix, metadata, assetIds, assetExternalIds, rootAssetIds, assetSubtreeIds, dataSetIds, source, type y subtype.

De forma predeterminada, la consulta devuelve eventos activos en el intervalo de tiempo, pero puede personalizar una consulta con los filtros de tiempo adicionales startTime, endTime, activeAtTime, createdTime y lastUpdatedTime.

Este ejemplo devuelve todos los eventos finalizados que comenzaron en el rango de tiempo actual:

events{startTime={min=$__from}, endTime={isNull=false}}

Este ejemplo devuelve solo eventos terminados:

events{endTime={isNull=false}}

Filtrado del lado del cliente

Especifique más filtrado del lado del cliente con los operadores =~, !~ y !=. Una coma entre varios filtros funciona como una AND lógica.

Formato:

• =~: igualdad de expresiones regulares. Devuelve resultados que satisfacen la expresión regular.

• !~: desigualdad de expresiones regulares. Excluye los resultados que satisfacen la expresión regular.

• !=: desigualdad estricta. Devuelve elementos donde una propiedad no es igual a un valor dado.

Ejemplo:

events{type='WORKORDER', subtype=~'SUB.*'}

NOTA

No utilice los filtros del lado del cliente como método de filtrado principal. Grafana aplica los filtros después de que CDF haya devuelto los elementos y es posible que no vea todos los datos si CDF devuelve el número máximo de elementos (1000).

Crear plantillas

Cree plantillas usando la sintaxis $variable_name.

Ejemplo:

events{type='WORKORDER', subtype=$variable}

Renombrar y organizar campos

Seleccione la pestaña Transformar para renombrar y organizar los campos.

Anotar gráficos con eventos

Utilice anotaciones para superponer información detallada sobre eventos de CDF en gráficos en Grafana.

1. Vaya a la configuración de su tablero y seleccione Anotaciones.
2. Seleccione su proyecto CDF en el campo Fuente de datos.

1. Especifique la consulta para obtener y filtrar eventos de CDF. Por ejemplo:

   events{type="some", subtype=~"sub.*"}

   La consulta anterior solicita eventos con el parámetro type="some" y filtra los resultados por subtype que coincide con sub.*.

   • Para obtener una lista completa de parámetros válidos, consulte la documentación de la API.

   • Aprenda a filtrar los resultados.