Abfrage

Auf der Abfrage-Seite erkunden Sie die Zeitreihendaten, die Pulse von Ihren Datenquellen erfasst — OPC-UA-Servern, S7-SPS, Prometheus-Endpunkten und Heartbeats. Statt einen einzelnen Monitor zu betrachten, erstellen Sie eine oder mehrere Ad-hoc-Abfragen — 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

Jede Abfrage ist eine Zeile im Bereich Definieren und wird aus drei Teilen zusammengesetzt, die nebeneinander angezeigt werden:

• SELECT — die zu berechnende Aggregation (z. B. Durchschnitt, Maximum, ein Perzentil).
• WHERE — die einzubeziehenden Datenpunkte.
• 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; sie gelten für alle Abfragen der Seite, sodass sich alle Diagramme eine Zeitachse teilen und zum selben Zeitpunkt gelesen werden können. Klicken Sie auf Abfrage ausführen (oder drücken Sie ⌘ Eingabe / Strg Eingabe), um sie auszuführen, oder auf Abbrechen, um die aktuellen Ergebnisse zu löschen.

Mit dem Ausführen erhält das Ergebnis außerdem eine eigene Adresse: Die URL der Seite benennt nun diesen Lauf. Wer sie später öffnet — oder von Ihnen erhält — sieht die Zahlen dieses Laufs, statt die Frage erneut über einen neueren Zeitraum zu stellen. Klicken Sie wieder auf Abfrage ausführen, wenn Sie aktuelle Zahlen möchten: Das ist ein neuer Lauf mit eigener URL, sodass ein bereits geteilter Link weiterhin dasselbe zeigt. Ein Ergebnis wird 30 Tage aufbewahrt; danach bittet sein Link darum, die Abfrage erneut auszuführen.

Mehrere Abfragen vergleichen

Über + Abfrage hinzufügen fügen Sie eine weitere Zeile hinzu, bis zu sechs. Jede Zeile fragt nach ihrem eigenen Gegenstand — eigene Datenpunkte und Tags, eigene Gruppierung, eigene Aggregationen. So vergleichen Sie unterschiedliche Größen: die Temperatur einer Linie mit dem Durchsatz einer anderen, oder den Wert eines Sensors mit der Latenz der Verbindung, die ihn liest.

Mehrere Aggregationen desselben Gegenstands brauchen keine zweite Abfrage — legen Sie sie in dieselbe Zeile, und sie werden gemeinsam abgefragt (siehe SELECT unten).

Eine neue Zeile startet leer. Das Menü ⋮ einer Zeile bietet:

• Duplizieren — eine Kopie der Zeile, bereit, zum Vergleichsobjekt umgebaut zu werden.
• Entfernen — die Zeile löschen. Die letzte verbleibende Abfrage lässt sich nicht entfernen.

Jede Abfrage wird durch einen Buchstaben (A, B, C …) gekennzeichnet, der auf ihrer Zeile und auf ihrem Diagramm erscheint. Klicken Sie auf den Buchstaben, um der Abfrage stattdessen einen Namen zu geben — hilfreich, wenn zwei Abfragen sonst gleich aussähen. Der Name erscheint in der Diagrammüberschrift, in der Übersicht und in der Abfrageauswahl der Registerkarte Tabelle, und er bleibt erhalten, wenn Sie den Link zur Seite teilen.

KI um Hilfe bitten

Klicken Sie auf die Schaltfläche KI um Hilfe bitten (✦) in der Werkzeugleiste, um KI-Canvas mit einer vorausgefüllten Eingabe zu öffnen, die den Assistenten durch die Erstellung einer Abfrage führt. Der Assistent fragt, was Sie herausfinden möchten, erstellt die Abfrage und zeigt Ihnen die Ergebnisse.

SELECT — die Aggregation

Eine Aggregation verdichtet alle Messwerte eines Zeitintervalls zu einer einzigen Zahl. Eine Abfrage trägt eine bis vier davon, und jede erhält ihr eigenes Diagramm — Durchschnitt und Maximum eines Sensors sind also eine Abfrage, eine Anfrage und zwei Grafiken.

Eine Aggregation ist eine Funktion, die auf ein Feld angewendet wird:

• Funktionen — Anzahl, Summe, Durchschnitt, Min, Max, Neuester 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 Datenpunkts. Boolesche Messwerte zählen als 0 oder 1.
  • Latenz — wie lange der Lesevorgang gedauert hat, in Millisekunden. Nützlich, um langsame oder sich verschlechternde Verbindungen zu erkennen.

Anzahl benötigt kein Feld — sie zählt die Anzahl der Messwerte in jedem Intervall. Neuester gibt den Wert des Messvorgangs mit dem größten Zeitstempel im Intervall zurück — nützlich, wenn Sie den aktuellsten Messwert statt eines Aggregats wie Durchschnitt oder Maximum benötigen.

Um die Aggregation festzulegen, 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.

Wählen Sie erneut, um eine weitere hinzuzufügen; jede erscheint als eigener Chip, und das × eines Chips entfernt ihn — genauso, wie das WHERE-Feld Datenpunkte aufnimmt und wieder freigibt. Vier ist die Grenze, denn so viele kann eine einzelne Anfrage tragen; eine fünfte Aggregation gehört in eine zweite Abfrage.

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 und Tags

Das Feld WHERE wählt aus, welche Datenpunkte in die Abfrage einfließen.

Beginnen Sie, den Namen einer Datenquelle einzugeben, um sie zu finden, und wählen Sie dann einen ihrer Datenpunkte — einen OPC-UA-Knoten, eine S7-Adresse, eine Prometheus-Zeitreihe oder einen Heartbeat. Mit * beziehen Sie alles ein, was diese Quelle misst. Ausgewählte Datenpunkte werden als Chips angezeigt; entfernen Sie einen Datenpunkt über das × oder mit der Rücktaste.

Sie können Datenpunkte aus mehreren Quellen beliebiger Art kombinieren. Sie werden gemeinsam abgefragt und zu einem Ergebnis zusammengeführt.

Was * auslässt

* erfasst, was eine Quelle misst, nicht ihre Zustandssignale. Die Erreichbarkeit der Quelle selbst und jeder OPC-UA-Knoten, der auf sein Vorhandensein statt auf seinen Wert überwacht wird, bleiben außen vor — beide melden einen konstanten Wert, und ein Durchschnitt neben einer Temperatur würde dadurch verflacht. Wählen Sie eines von beiden namentlich aus, um es einzeln darzustellen.

Sie können auch nach Monitor-Tags filtern — den Bezeichnungen, die Sie Ihren Monitoren zuweisen. Tags erscheinen im selben Dropdown, nach Kategorie geordnet. Wählen Sie einen oder mehrere Tags aus, um die Abfrage auf Daten von Monitoren zu beschränken, die diese Tags tragen. Tag-Chips zeigen die Tag-Farbe und den Namen neben den ausgewählten Datenpunkt-Chips an. Entfernen Sie einen Tag-Chip über das × oder mit der Rücktaste. Eine Abfrage kann auch ausschließlich Tags verwenden, ohne bestimmte Datenpunkte auszuwählen.

WARNING

Für jede Abfrage der Seite ist mindestens ein Datenpunkt oder Tag erforderlich. Eine Abfrage mit leerem WHERE-Feld wird nicht ausgeführt, und der Fehler wird an der betreffenden Zeile angezeigt.

GROUP BY — Aufteilung in Datenreihen

Standardmäßig werden alle von einer Abfrage ausgewählten Datenpunkte zu einer einzigen Datenreihe zusammengefasst. GROUP BY teilt diese Reihe in mehrere auf:

• Monitor — eine Datenreihe pro Bedingungsmonitor, der die ausgewählten Datenpunkte liest.
• Datenpunkt — eine Datenreihe pro Datenpunkt.
• Datenquelle — eine Datenreihe pro Datenquelle.

Sie können sie kombinieren. avg(value) gruppiert nach Datenpunkt erzeugt eine Linie pro Datenpunkt — der schnellste Weg, Messwerte miteinander zu vergleichen. Ergänzen Sie Monitor, um jeden Datenpunkt nach dem überwachenden Monitor aufzuschlüsseln; ein Datenpunkt, den zwei Monitore lesen, erscheint dann unter jedem einmal.

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.

Mit einem früheren Zeitraum vergleichen

Öffnen Sie das Uhrsymbol in der Kopfzeile des Bereichs und scrollen Sie zum Abschnitt Mit vorherigem Zeitraum vergleichen. Wählen Sie einen Abstand — wie weit der zweite Zeitraum zurückliegt — und die Seite ruft sowohl das aktuelle Fenster als auch das gleichlange, um diesen Abstand zurückversetzte Fenster ab und stellt sie gemeinsam dar.

Die verfügbaren Abstände hängen vom gewählten Zeitraum ab: Es werden nur Abstände angeboten, die mindestens so lang wie das Fenster sind, damit sich die beiden Zeiträume nicht überschneiden. Bei einem 7-Tage-Fenster stehen beispielsweise „Vorherige 7 Tage" und „Vorherige 28 Tage" zur Auswahl, nicht aber „Vorherige Stunde".

Zum Deaktivieren des Vergleichs klicken Sie im selben Abschnitt auf Aus.

Überlagerung und nebeneinander

Während der Vergleich aktiv ist, erscheint unterhalb der Abstände ein Schalter Als Überlagerung anzeigen:

• Aus (Standard) — jedes Diagramm teilt sich in zwei Bereiche auf, einen pro Zeitraum, jeder mit eigener Zeitachse. Beim Ablesen über beide Bereiche hinweg ist Intervall i der gleiche Abstand in beiden Zeiträumen.
• Ein — beide Zeiträume werden in einem Diagramm auf einer gemeinsamen Zeitachse gezeichnet. Der aktuelle Zeitraum verwendet durchgezogene Linien, der frühere gestrichelte Linien in derselben Farbe. Nützlich für einen schnellen visuellen Vergleich, bei dem die genaue Intervall-Ausrichtung weniger wichtig ist als die Gesamtform.

Diagrammansicht pro Diagramm

Wenn ein Vergleich läuft, zeigt der Kopf jedes Diagramms einen Schalter Aktuell / Vergleich. Damit wechseln Sie dieses einzelne Diagramm zwischen dem aktuellen und dem früheren Zeitraum — ohne die Vergleichseinstellungen der gesamten Seite zu ändern.

Wie Abstände angewendet werden

PQL richtet Zeitintervalle an der Epoche aus. Wenn der gewählte Abstand keine ganze Anzahl von Intervallen ergibt — etwa „Vorherige 30 Tage" bei wöchentlicher Granularität — wird er auf die nächste ganze Intervallanzahl gerundet. Die Zeitraumbezeichnungen in den Diagrammen und in der Übersicht zeigen den tatsächlich angewendeten Abstand an, sodass Sie immer wissen, welchen Zeitraum die frühere Periode abdeckt.

Ergebnisse lesen

Nach einem Lauf erscheinen die Diagramme unterhalb des Editors, darunter eine Übersicht und eine Tabelle in einer Registerkartenleiste. Eine kurze Zusammenfassungszeile zeigt, wie lange die langsamste Abfrage gedauert hat, die Anzahl der zurückgegebenen Zeitintervalle und die tatsächlich angewendete Granularität.

Diagramme

Die Diagramme werden immer angezeigt. Jede Aggregation jeder Abfrage erhält ihr eigenes Diagramm, in der Reihenfolge ihrer Definition, sodass unterschiedliche Einheiten und Skalen sich nie eine Achse teilen — eine Abfrage mit count und avg(value) erzeugt zwei Grafiken. Innerhalb jedes Diagramms wird jede GROUP-BY-Datenreihe als eigene Linie dargestellt.

Jedes Diagramm trägt als Überschrift den Buchstaben oder Namen der Abfrage, ihre Aggregation und eine Zeile, die benennt, was sie liest — wichtig, sobald zwei Diagramme beide mit avg(value) überschrieben sind und verschiedene Sensoren meinen.

Wenn Sie den Zeiger irgendwo über den Stapel bewegen, wird in jedem Diagramm ein Fadenkreuz zum selben Zeitpunkt gezeichnet, sodass sich ein Moment über alle hinweg ablesen lässt. Alle Diagramme teilen sich den Zeitraum der Seite; wo eine Abfrage zu einem Zeitpunkt keinen Messwert hat, zeigt sie eine Lücke statt einer Linie durch einen nie gelesenen Wert.

Schlägt eine Abfrage fehl oder liefert sie nichts, sagen das nur ihre eigenen Diagramme; die übrigen beantworten weiterhin ihre Fragen.

Die Farben werden durch die Übersichtstabelle darunter erklärt, in der jede Zeile dieselbe Farbe wie ihre Linie trägt.

Wenn eine Abfrage mehr als eine Aggregation liefert, zeichnet das Bewegen des Mauszeigers über die Diagramme ein gemeinsames Fadenkreuz — eine senkrechte Linie am selben Zeitintervall in allen Aggregationsdiagrammen gleichzeitig. Dies erleichtert den Vergleich, zum Beispiel von Durchschnitts- und Maximalwerten zum gleichen Zeitpunkt. Das Fadenkreuz folgt dem Mauszeiger überall in der Diagrammspalte, einschließlich in den Lücken zwischen Diagrammen und auf den Achsenbeschriftungen. Ein Werte-Tooltip erscheint nur bei dem Diagramm, über dem sich der Mauszeiger direkt befindet.

Vorfallmarkierungen

Vorfälle, die während des Zeitraums aufgetreten sind, werden in jedem Diagramm an derselben Stelle als vertikale Markierungen 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 einer Abfrage mit einem Einbruch in einer anderen und mit dem folgenden Vorfall in Beziehung zu setzen.

Übersicht

Die Registerkarte Übersicht fasst den gesamten Zeitraum zusammen, mit einem Block je Abfrage — nicht je Diagramm — unter ihrem Buchstaben oder Namen und darin einer Zeile pro Gruppe. Die Aggregationen einer Abfrage sind hier Spalten, wo sie oben getrennte Bilder sind. Wenn Sie nach Monitor, Datenpunkt oder Datenquelle gruppieren, erscheinen auch diese als Spalten, und ein farbiger Punkt in jeder Zeile entspricht der Linie dieser Gruppe in den Diagrammen.

Eine Abfrage ohne GROUP BY hat eine einzige Zeile, die alles Ausgewählte abdeckt; statt einer Gruppenspalte trägt sie deshalb eine Spalte Liest, die ihren Gegenstand benennt.

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.

Wenn ein Vergleich aktiv ist, erhält jede Aggregationsspalte zwei weitere: Vorher, denselben Aggregatwert für den früheren Zeitraum, und Δ, die prozentuale Änderung vom früheren zum aktuellen Wert — positiv in Grün, negativ in Amber. Ein Gedankenstrich bedeutet, dass kein früherer Messwert vorhanden ist oder der frühere Wert null war.

Eingrenzen aus der Übersicht

Jede Zeile der Übersicht trägt rechts eine ⋯-Schaltfläche (oder kann per Rechtsklick geöffnet werden). Das Menü bietet je nach Gruppierung der Zeile folgende Aktionen:

• Auf diesen Datenpunkt eingrenzen — schreibt das WHERE der Abfrage auf diesen einzelnen Datenpunkt um und führt sie sofort erneut aus. Verfügbar, wenn die Abfrage nach Datenpunkt oder Datenquelle gruppiert ist.
• Auf diesen Monitor eingrenzen — schreibt das WHERE der Abfrage auf diesen einzelnen Monitor um und führt sie sofort erneut aus. Verfügbar, wenn die Abfrage nach Monitor gruppiert ist.

Eine Aktion ist deaktiviert, wenn die Abfrage bereits auf dieses Element eingegrenzt ist — die Seite zeigt bereits die engere Antwort, ein erneutes Drücken würde nichts ändern.

Wenn eine Abfrage auf einen Monitor eingegrenzt ist, zeigt das WHERE-Feld einen Chip mit dem Monitornamen neben den Datenpunkt- und Schlagwort-Chips. Entfernen Sie ihn mit dem × am Chip, um den Gegenstand wieder zu erweitern.

Tabelle

Die Registerkarte Tabelle zeigt die zeitliche Aufschlüsselung — eine Zeile pro Zeitintervall und Gruppe. Die Spalten sind sortierbar. Verwenden Sie die Tabelle, wenn Sie die exakten Werte pro Intervall statt eines Trends oder einer Gesamtsumme benötigen. Bei mehr als einer Abfrage auf der Seite wählen Sie über die Auswahl oberhalb der Tabelle, welche sie zeigt.

Vorgeschlagene Abfragen

Unterhalb des Editors bietet Vorgeschlagene Abfragen fertige Ausgangspunkte für häufige Fragestellungen, etwa Durchschnittswert pro Datenpunkt, Spitzenwerte, Abruf-Latenz, die langsamsten Datenquellen und das Stichprobenvolumen pro Datenquelle.

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. Ein Vorschlag, der mehr als eine Frage stellt — etwa der Betriebsbereich, der sowohl Minimum als auch Maximum will — wird zu einer Abfrage je Frage, alle auf denselben Datenpunkten. 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.

Auf mobilen Geräten wird der Bereich durch eine Schaltfläche Vorgeschlagene Abfragen ersetzt. Tippen Sie darauf, um ein Einschubfeld von unten zu öffnen, das alle Vorschläge mit Namen und Beschreibung auflistet. Tippen Sie auf einen Vorschlag, um ihn sofort auszuführen.

Verwandte Dokumentation

• Monitore — die Bedingungsmonitore, die auf den hier abgefragten Messwerten alarmieren.
• OPC UA, Siemens S7 und Heartbeat — wie die zugrunde liegenden Daten erfasst werden.
• KI-Canvas — bitten Sie den Assistenten, Abfragen in Ihrem Auftrag zu erstellen und auszuführen.