Visualizzazione di eventi

Impostare e filtrare le query sugli eventi CDF e annotare gli eventi nei grafici sul dashboard di Grafana. È possibile personalizzare l'intervallo di tempo, gli eventi da visualizzare e le colonne in base alle proprie esigenze.

Utilizzo di eventi in una tabella

Aprire la scheda Evento in Grafana per utilizzare gli eventi in una tabella.

Definizione di una query

La query events utilizza l'endpoint events/list per recuperare dati.

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

Esempio:

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

È possibile filtrare in base a queste proprietà: externalIdPrefix, metadata, assetIds, assetExternalIds, rootAssetIds, assetSubtreeIds, dataSetIds, source, type e subtype.

Per impostazione predefinita, la query restituisce eventi attivi nell'intervallo di tempo, tuttavia è possibile personalizzare una query con i filtri temporali aggiuntivi startTime, endTime, activeAtTime, createdTime e lastUpdatedTime.

Questo esempio restituisce tutti gli eventi terminati che sono iniziati nell'intervallo di tempo corrente:

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

Questo esempio restituisce solo gli eventi terminati:

events{endTime={isNull=false}}

Filtro lato client

Specificare più filtri lato client con gli operatori =~, !~ e !=. Una virgola tra più filtri funge da operatore AND logico.

Formato:

• =~ - Uguaglianza regex. Restituisce i risultati che soddisfano l'espressione regolare.

• !~ - Diseguaglianza regex. Esclude i risultati che soddisfano l'espressione regolare.

• != - Diseguaglianza stretta. Restituisce elementi in cui una proprietà non è uguale a un determinato valore.

Esempio:

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

NOTA

Non utilizzare i filtri lato client come metodo di filtro primario. Grafana applica i filtri dopo che CDF ha restituito elementi. È possibile che non tutti i dati siano visibili se CDF restituisce il numero massimo di elementi (1000).

Creazione di modelli

Creare modelli utilizzando la sintassi $variable_name.

Esempio:

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

Ridenominazione e organizzazione dei campi

Selezionare la scheda Trasforma per rinominare e organizzare i campi.

Annotazione di grafici con eventi

Utilizzare le annotazioni per sovrapporre le informazioni sugli eventi dettagliate da CDF sui grafici in Grafana.

1. Spostarsi sulle impostazioni del dashboard e selezionare Annotazioni.
2. Selezionare il progetto CDF nel campo Origine dati.

1. Specificare la query per recuperare e filtrare eventi da CDF. Ad esempio:

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

   La query richiede eventi con il parametro type="some" e filtra i risultati in base al subtype corrispondente a sub.*.

   • Per un elenco completo di parametri validi, vedere la documentazione dell'API.

   • Ottenere ulteriori informazioni su come filtrare i risultati.