Ereignisse visualisieren

Richten Sie Abfragen für CDF-Ereignisse ein, und filtern Sie diese, um sie als Kommentare zu Grafiken in Ihrem Grafana-Dashboard einzufügen. Sie können den Zeitbereich, die anzuzeigenden Ereignisse und die Spalten nach Ihren Bedürfnissen anpassen.

Mit Ereignissen in einer Tabelle arbeiten

Öffnen Sie die Registerkarte Ereignis in Grafana, um mit den Ereignissen in einer Tabelle zu arbeiten.

Eine Abfrage definieren

Die Abfrage events verwendet den Endpunkt events/list, um Daten abzufragen.

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

Beispiel:

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

Sie können nach den folgenden Eigenschaften filtern: externalIdPrefix, metadata, assetIds, assetExternalIds, rootAssetIds, assetSubtreeIds, dataSetIds, source, type und subtype.

Standardmäßig gibt die Abfrage aktive Ereignisse im Zeitbereich aus, aber Sie können eine Abfrage mit den zusätzlichen Filtern startTime, endTime, activeAtTime, createdTime und lastUpdatedTime anpassen.

Das nachfolgende Beispiel gibt alle abgeschlossenen Ereignisse aus, die im aktuellen Zeitbereich gestartet wurden:

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

Das nachfolgende Beispiel gibt nur abgeschlossene Ereignisse aus:

events{endTime={isNull=false}}

Clientseitige Filterung

Mit den Operatoren =~, !~ und != können Sie weitere clientseitige Filter angeben. Ein Komma zwischen den Filtern bedeutet AND.

Format:

• =~ – Gleichheit des regulären Ausdrucks. Gibt Ergebnisse aus, die dem regulären Ausdruck entsprechen.

• !~ – Ungleichheit des regulären Ausdrucks. Schließt Ergebnisse aus, die dem regulären Ausdruck entsprechen.

• != – strikte Ungleichheit. Gibt Objekte aus, bei denen eine Eigenschaft nicht dem angegebenen Wert entspricht.

Beispiel:

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

HINWEIS

Setzen Sie die clientseitigen Filter nicht als primäre Filtermethode ein. Grafana wendet die Filter an, nachdem die Objekte von CDF ausgegeben wurden. Es ist möglich, dass Sie nicht alle Daten sehen, wenn CDF die maximale Anzahl an Objekten (1.000) ausgibt.

Vorlagen erstellen

Erstellen Sie Vorlagen mit der Syntax $variable_name.

Beispiel:

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

Felder umbenennen und organisieren

Wählen Sie die Registerkarte Transform aus, um Felder umzubenennen und zu organisieren.

Versehen Sie Grafiken mit Ereignissen

Überlappen Sie Grafiken in Grafana mit Anmerkungen, die wertvolle Ereignisinformationen aus CDF enthalten.

1. Navigieren Sie zu den Einstellungen in Ihrem Dashboard, und wählen Sie Anmerkungen aus.
2. Wählen Sie Ihr CDF-Projekt aus dem Feld Datenquelle aus.

1. Geben Sie die Abfrage an, mit der Ereignisse aus CDF abgerufen und gefiltert werden. Zum Beispiel:

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

   Die oben genannte Abfrage fordert Ereignisse mit dem Parameter type="some" an, und filtert die Ergebnisse nach subtype, der sub.* entspricht.

   • Eine vollständige Liste der gültigen Parameter finden Sie in der API-Dokumentation.

   • Erfahren Sie, wie Sie die Ergebnisse filtern können.