Gebeurtenissen visualiseren

Configureer en filter query's voor CDF-gebeurtenissen en annoteer de gebeurtenissen in grafieken op uw Grafana-dashboard. U kunt het tijdbereik, de weer te geven gebeurtenissen en de kolommen aanpassen aan uw behoeften.

Werken met gebeurtenissen in een tabel

Open het tabblad Gebeurtenis in Grafana als u met de gebeurtenissen in een tabel wilt werken.

Een query definiëren

Bij de query events wordt gebruikgemaakt van het eindpunt gebeurtenissen/lijst om gegevens op te halen.

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

Voorbeeld:

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

U kunt filteren op de volgende eigenschappen: externalIdPrefix, metadata, assetIds, assetExternalIds, rootAssetIds, assetSubtreeIds, dataSetIds, source, type en subtype.

Standaard retourneert de query actieve gebeurtenissen in het tijdbereik, maar u kunt een query aanpassen met de aanvullende tijdfilters startTime, endTime, activeAtTime, createdTime en lastUpdatedTime.

Dit voorbeeld retourneert alle voltooide gebeurtenissen die zijn gestart in het huidige tijdbereik:

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

Dit voorbeeld retourneert alleen voltooide gebeurtenissen:

events{endTime={isNull=false}}

Filteren op de client

Gebruik de operators =~, !~ en != om meer filters voor de client op te geven. Een komma tussen verschillende filters werkt als de logische operator AND.

Indeling:

• =~ - gelijk aan regex. Retourneert resultaten die overeenkomen met de reguliere expressie.

• !~ - ongelijk aan regex. Resultaten die overeenkomen met de reguliere expressie, worden uitgesloten.

• != - strikte ongelijkheid. Retourneert items waarvan een eigenschap niet gelijk is aan een bepaalde waarde.

Voorbeeld:

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

OPMERKING

Gebruik de filters op de client niet als primaire filtermethode. Grafana past de filters toe nadat items zijn geretourneerd uit CDF, en mogelijk ziet u niet alle gegevens als CDF het maximale aantal items (1000) retourneert.

Sjablonen maken

Maak sjablonen met behulp van de syntaxis $variable_name.

Voorbeeld:

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

Veldnamen wijzigen en velden ordenen

Selecteer het tabblad Transformeren om veldnamen te wijzigen en velden te ordenen.

Grafieken met gebeurtenissen annoteren

Gebruik annotaties om uitgebreide gegevens over een gebeurtenis uit CDF als overlay te plaatsen op grafieken in Grafana.

1. Navigeer naar de instellingen van uw dashboard en selecteer Annotaties.
2. Selecteer uw CDF-project in het veld Data Source.

1. Geef de query op waarmee u gebeurtenissen wilt ophalen en filteren uit CDF. Bijvoorbeeld:

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

   Met de bovenstaande query worden gebeurtenissen opgevraagd met parameter type="some" en de resultaten worden gefilterd op subtype dat overeenkomt met sub.*.

   • Voor een volledige lijst met geldige parameters raadpleegt u de API-documentatie.

   • Leer hoe u de resultaten kunt filteren.