Abfrage
Auf der Abfrage-Seite erkunden Sie die Zeitreihendaten, die Pulse von Ihren OPC-UA-Knoten und S7-Tags erfasst. Statt einen einzelnen Monitor zu betrachten, erstellen Sie eine Ad-hoc-Abfrage — wählen Sie die Datenpunkte, legen Sie die Aggregation fest und sehen Sie das Ergebnis als Diagramme oder als Tabelle.
Dies ist eine reine Auswertung. Abfragen ändern niemals Ihre Monitore, Schwellenwerte oder Vorfälle.
Aufbau einer Abfrage
Eine Abfrage wird im Bereich Definieren aus drei Teilen zusammengesetzt, die nebeneinander angezeigt werden:
- SELECT — die zu berechnenden Aggregationen (z. B. Durchschnitt, Maximum, ein Perzentil).
- WHERE — die einzubeziehenden Datenpunkte (die OPC-UA-Knoten und S7-Tags).
- GROUP BY — wie die Ergebnisse in einzelne Datenreihen aufgeteilt werden.
Zeitraum und Granularität legen Sie über das Uhrsymbol in der Kopfzeile des Bereichs fest. Klicken Sie auf Abfrage ausführen, um sie auszuführen, oder auf Abbrechen, um die aktuellen Ergebnisse zu löschen.
SELECT — Aggregationen
Jede Aggregation verdichtet alle Messwerte eines Zeitintervalls zu einer einzigen Zahl. Sie können einer Abfrage bis zu vier Aggregationen hinzufügen.
Eine Aggregation ist eine Funktion, die auf ein Feld angewendet wird:
- Funktionen — Anzahl, Summe, Durchschnitt, Min, Max sowie Perzentile (P1, P5, P10, P25, P50/Median, P75, P90, P95, P99 und feinere Stufen wie P0,1 und P99,9).
- Felder — der aggregierte Wert:
- Wert — der numerische Messwert des Knotens oder Tags. Boolesche Tags zählen als
0oder1. - Latenz — wie lange der Lesevorgang gedauert hat, in Millisekunden. Nützlich, um langsame oder sich verschlechternde Verbindungen zu erkennen.
- Wert — der numerische Messwert des Knotens oder Tags. Boolesche Tags zählen als
Anzahl benötigt kein Feld — sie zählt die Anzahl der Messwerte in jedem Intervall.
Um eine Aggregation hinzuzufügen, beginnen Sie, einen Funktionsnamen einzugeben. Geben Sie die Funktion gefolgt von ( ein, um ein Feld zu wählen — zum Beispiel avg( und dann Wert oder Latenz. Das Ergebnis wird als Chip wie avg(value) oder max(latency) angezeigt.
TIP
Nur erfolgreiche Lesevorgänge werden einbezogen. Ein Messwert wird nur gezählt, wenn die Quelle einen guten Status gemeldet hat (OPC-UA-Status Good, S7-Lesestatus OK). Fehlgeschlagene oder veraltete Lesevorgänge werden ausgeschlossen, sodass die Aggregate nur fehlerfreie Daten widerspiegeln.
WHERE — Datenpunkte
Das Feld WHERE wählt aus, welche Knoten und Tags in die Abfrage einfließen.
Beginnen Sie, einen Endpunktnamen einzugeben, um ihn zu finden, und geben Sie dann / ein, um zu seinen Knoten oder Tags zu navigieren. Wählen Sie einen bestimmten Knoten bzw. Tag aus oder verwenden Sie den Platzhalter *, um alle untergeordneten Elemente dieses Endpunkts auf einmal einzubeziehen. Ausgewählte Datenpunkte werden als Chips angezeigt; entfernen Sie einen Datenpunkt über das × oder mit der Rücktaste.
Sie können Datenpunkte aus mehreren Endpunkten kombinieren. OPC-UA- und S7-Daten werden gemeinsam abgefragt und zu einem Ergebnis zusammengeführt.
WARNING
Mindestens ein Datenpunkt ist erforderlich. Eine Abfrage mit leerem WHERE-Feld wird nicht ausgeführt — die Seite fordert Sie auf, zuerst einen Datenpunkt auszuwählen.
GROUP BY — Aufteilung in Datenreihen
Standardmäßig werden alle ausgewählten Datenpunkte zu einer einzigen Datenreihe zusammengefasst. GROUP BY teilt diese Reihe in mehrere auf:
- Monitor — eine Datenreihe pro Endpunkt (gruppiert nach Monitornamen).
- Datenpunkt — eine Datenreihe pro OPC-UA-Knoten oder S7-Adresse.
Sie können beides kombinieren. Zum Beispiel erzeugt avg(value) gruppiert nach Datenpunkt eine Linie pro Knoten, sodass sich Tags leicht miteinander vergleichen lassen.
Zeitraum und Granularität
Öffnen Sie das Uhrsymbol in der Kopfzeile des Bereichs, um Folgendes festzulegen:
- Zeitraum — ein Schnellbereich (letzte 15 Minuten bis letzte 30 Tage) oder ein benutzerdefinierter Start- und Endzeitpunkt.
- Granularität — die Größe der einzelnen Zeitintervalle (10 Sekunden bis 1 Woche). Belassen Sie die Einstellung auf Automatisch, damit Pulse ein passendes Intervall für den gewählten Zeitraum wählt. Wird die Granularität nicht ausdrücklich festgelegt, fasst Pulse die Daten stündlich zusammen.
Eine feinere Granularität liefert mehr Details, aber auch mehr Punkte; eine gröbere Granularität glättet die Daten und ist über lange Zeiträume schneller.
Ergebnisse lesen
Nachdem eine Abfrage ausgeführt wurde, erscheinen die Diagramme unterhalb des Editors, darunter eine Übersicht und eine Tabelle in einer Registerkartenleiste. Eine kurze Zusammenfassungszeile zeigt die Ausführungszeit der Abfrage, die Anzahl der zurückgegebenen Zeitintervalle und die tatsächlich angewendete Granularität.
Diagramme
Die Diagramme werden immer angezeigt. Jede Aggregation in Ihrem SELECT erhält ihr eigenes Diagramm: Eine Abfrage mit count und avg(value) erzeugt zwei getrennte Diagramme — eines pro Aggregation —, sodass unterschiedliche Einheiten und Skalen sich nie eine Achse teilen. Innerhalb jedes Diagramms wird jede GROUP-BY-Datenreihe als eigene Linie dargestellt.
Die Farben werden durch die Übersichtstabelle darunter erklärt, in der jede Zeile dieselbe Farbe wie ihre Linie trägt.
Vorfallmarkierungen
Vorfälle, die während des Zeitraums an den abgefragten Monitoren aufgetreten sind, werden als vertikale Markierungen in den Diagrammen dargestellt, eingefärbt nach Status (unbestätigt, bestätigt, behoben). Über die Schaltfläche Vorfälle oberhalb der Diagramme können Sie einzelne Vorfälle ein- oder ausblenden — praktisch, um eine Spitze in den Daten dem auslösenden Vorfall zuzuordnen.
Übersicht
Die Registerkarte Übersicht fasst den gesamten Zeitraum als Tabelle mit einer Zeile pro Gruppe zusammen. Jede Aggregation ist eine Spalte (z. B. count, avg(value)), und wenn Sie nach Monitor oder Datenpunkt gruppieren, erscheinen auch diese als Spalten. Ein farbiger Punkt in jeder Zeile entspricht der Linie dieser Gruppe in den Diagrammen.
Diese Summen werden über alle Messwerte im Zeitraum berechnet — avg(value) ist also der echte Durchschnitt über den Zeitraum, Perzentile sind exakt und count ist die Gesamtzahl — und nicht eine Kombination der Werte pro Intervall.
Tabelle
Die Registerkarte Tabelle zeigt die zeitliche Aufschlüsselung — eine Zeile pro Zeitintervall und Gruppe, mit einer Spalte je Aggregation. Die Spalten sind sortierbar. Verwenden Sie die Tabelle, wenn Sie die exakten Werte pro Intervall statt eines Trends oder einer Gesamtsumme benötigen.
Vorgeschlagene Abfragen
Unterhalb des Editors bietet Vorgeschlagene Abfragen fertige Ausgangspunkte für häufige Fragestellungen, etwa Durchschnittswert pro Datenpunkt, Spitzenwerte, Abruf-Latenz, die langsamsten Endpunkte und die Latenzverteilung.
Wenn Sie einen Vorschlag auswählen, werden SELECT, GROUP BY, Granularität und Zeitraum für Sie ausgefüllt, während die bereits gewählten Datenpunkte erhalten bleiben. Falls Sie noch keinen Datenpunkt ausgewählt haben, wählen Sie zuerst einen im WHERE-Feld und führen Sie dann den Vorschlag aus.
Die Vorschläge verschwinden, sobald Sie eine Abfrage ausführen, und kehren zurück, wenn Sie auf Abbrechen klicken.
Verwandte Dokumentation
- Monitore — die OPC-UA-Knoten und S7-Tags, deren Messwerte Sie hier abfragen.
- OPC UA und Siemens S7 — wie die zugrunde liegenden Daten erfasst werden.