Jede Datenkarte liest eine Datenquelle: eine Abfrage, die einen Wert, eine Reihe, eine Tabelle oder einen Datensatz liefert. Parameter lassen ein Board für viele Geräte oder Standorte arbeiten. Schlüsselfilter grenzen eine Menge von Geräten über ihre Werte ein. Diese Seite listet die IoT-Quellen auf, erklärt, wie das Zeitfenster und die Aggregate funktionieren, und zeigt, wie man ein Board baut, das dem Gerät oder Standort folgt, das der Betrachter auswählt.
Wie eine Karte ihre Daten erhält
Ein Widget deklariert Slots: was es braucht, nie woher es kommt. Ein Messinstrument braucht einen Wert; ein Liniendiagramm braucht eine Reihe; eine Tabelle braucht Zeilen. Im Reiter Daten der Karte füllst du jeden Slot aus:
- Wähle die Quelle und die Abfrage, zum Beispiel Ein Wert eines Geräts (live).
- Fülle die Felder aus: das Gerät (oder Aus dem Dashboard übernehmen, siehe unten) und den Wert.
- Wähle Speichern.
Der Reihen-Slot eines Linien-, Balken- oder Flächendiagramms nimmt bis zu 8 Quellen auf (+ Weitere Quelle hinzufügen), sodass ein Diagramm Werte mehrerer Geräte zeigen kann.
Auch die Beispieldaten und die Entwicklerquellen auflisten zeigt Quellen für Tests. Für Produktionsboards ausgeschaltet lassen.
IoT-Datenquellen
| Abfrage | Liefert | Live |
|---|---|---|
| Ein Wert eines Geräts (live) | Ein Schlüssel eines Geräts, gewählt aus den Werten, die das Gerät sendet | Ja |
| Messwerte eines Geräts über die Zeit (live) | Bis zu 20 Schlüssel eines Geräts über das Zeitfenster, aggregiert je Intervall. auto folgt den ersten Zahlen, die das Gerät sendet. | Ja |
| Neueste Werte vieler Geräte (eine Zeile je Gerät) | Eine Zeile je Gerät (alle, ein Profil oder die Geräte eines Parameters) mit bis zu 20 Schlüsseln; höchstens 500 Zeilen | Abgefragt |
| Neueste Werte eines Geräts als ein Datensatz | Bis zu 20 Schlüssel eines Geräts als ein Datensatz (für Attribute oder ein Formular) | Abgefragt |
| Alle neuesten Werte eines Geräts | Eine Zeile je Schlüssel mit Name und Einheit (höchstens 500) | Abgefragt |
| Die Live-Werte eines Geräts für seine Zeichnung oder 3D-Ansicht | Eine Zeile je Element eines Geräts, das <element>.<field>-Schlüssel sendet | Abgefragt |
| Ein Element des Prozessdiagramms eines Geräts, Ein Element eines Geräts über die Zeit (live), Die Messwerte eines Elements, benannt nach einer Person | Die Zeile eines Elements, sein Verlauf oder seine Messwerte nach Name | Gemischt |
| Geräte (live Verbindungsstatus) | Deine Geräte mit Verbindung, Status, Profil und zuletzt gesehen; Filter für Profil, Status und Verbindung; höchstens 500 Zeilen | Ja |
| Ein Attribut des Geräts an einer Position einer Menge | Ein Server- oder gemeinsames Attribut, zum Beispiel die Live-Adresse einer Kamera | Abgefragt |
| Alarme (live) | Alarme nach Status (Aktiv, Offen, Quittiert, Behoben, Alle Status) und Schweregrad; höchstens 500 Zeilen | Ja |
| Alarmanzahl nach Schweregrad (live) | Eine Anzahl je Schweregrad | Ja |
| Standorte und Anlagen (der Baum als Zeilen), Anlagen eines Alias, Geräte unter einer Anlage | Der Anlagenbaum, die Anlagen eines Parameters, die Geräte unter einer Anlage | Abgefragt |
| Status unter einer Anlage | Eine Zeile je untergeordnetem Element: schlechtester Status, Geräte, offene Alarme | Abgefragt |
| Ein Standort für einen Seitenkopf | Name, Ort, Status, Geräte, offene Alarme, zuletzt gesehen | Abgefragt |
Namen, Einheiten, Dezimalstellen und Wertebereiche stammen aus den Telemetrieschlüsseln des Geräteprofils. Jede Abfrage prüft deine Berechtigungen: Ein Gerät, das du nicht lesen darfst, liefert wie ein nicht existierendes Gerät eine leere Antwort.
Zeitfenster und Aggregate
Ein Diagramm, das dem Dashboard-Zeitfenster folgt (Zeitfenster des Dashboards verwenden), zeigt den Zeitraum, den der Betrachter in der Werkzeugleiste wählt. Eine Karte kann auch ihr eigenes Fenster festlegen (Fixieren: letzte …) oder den Zeitraum direkt davor (gleiche Länge) zum Vergleich zeigen.
| Einstellung | Werte |
|---|---|
| Relative Zeitfenster | Letzte 5, 15 oder 30 Minuten; 1, 6, 12 oder 24 Stunden; 3, 7, 14, 30, 90 oder 365 Tage; jedes andere „letzte N Minuten, Stunden oder Tage“ |
| Kalenderzeiträume | Diese Stunde, Heute, Diese Woche, Diese Woche (Mo), Dieser Monat, Dieses Quartal, Dieses Halbjahr, Dieses Jahr, und jeweils der vorherige; Gestern, Vorgestern, Dieser Tag letzte Woche |
| Längstes Zeitfenster | 366 Tage |
| Gruppierungsintervall | auto, 1, 5, 10, 15 oder 30 Minuten, 1, 2, 6 oder 12 Stunden, 1 oder 7 Tage |
| Die meisten Intervalle in einem Zeitfenster | 500 (ein feineres Intervall wird vergröbert) |
Bei auto wird ein Zeitfenster bis zu 1 Stunde nach Minuten gruppiert, bis zu 1 Tag nach 5 Minuten, bis zu 7 Tagen nach Stunden, und längere Fenster nach Tagen.
Das Aggregat von Messwerte eines Geräts über die Zeit ist eines von:
| Aggregat | Je Intervall |
|---|---|
avg, min, max | Durchschnitt, niedrigster, höchster Wert |
last | Der letzte Wert |
sum, count | Summe, Anzahl der Messwerte |
increase | Für Zähler (Strom-, Wasserzähler): der Anstieg seit dem vorherigen Intervall. Ein Rückgang gilt als Zählerrücksetzung und wird ab null gezählt. Das erste Intervall zählt, was innerhalb davon gestiegen ist. |
Zeitfenster länger als 24 Stunden werden aus gespeicherten Aggregaten beantwortet, nicht aus Rohmesswerten. Rohmesswerte werden je nach Aufbewahrungsklasse deiner Organisation (durch deinen Tarif festgelegt) 7 bis 90 Tage aufbewahrt; Minutenaggregate bis zu 31 Tage; Stunden- und Tagesaggregate für die gesamte Klasse (bis zu 1.095 Tage). Siehe Wie lange Daten aufbewahrt werden und Aggregate und Verdichtungen.
Ein Zeitfenster ohne Zeitzone verwendet die Zeitzone des Browsers des Betrachters. Die Board-Einstellungen können Betrachtern erlauben, das Gruppierungsintervall, die Aggregation (Durchschnitt, Minimum, Maximum, Summe, Anzahl, Keine (Rohwerte)) und die Zeitzone zu ändern. Als Standard speichern (nur Bearbeiter) behält das Zeitfenster für alle.
Parameter
Ein Parameter ist ein Wert oder eine Entität, die die Karten lesen. Öffne Parameter verwalten… beim Anpassen. Ein Board enthält bis zu 16 Wertparameter und insgesamt 48 Parameter; die Filterleiste zeigt höchstens 16.
| Art | Beispiel |
|---|---|
| Wert: Text, Wert: Zahl, Wert: Datum, Wert: Ja oder Nein, Wert: feste Liste, Wert: Liste aus einer Adresse | Ein Schwellenwert, eine Schicht, ein Produkt |
| Entität (ein Gerät, eine Anlage…) | Das Gerät, um das es auf der Seite geht |
Für einen Entitätsparameter wählst du:
| Einstellung | Auswahlmöglichkeiten |
|---|---|
| Wie er gewählt wird | Der Betrachter wählt; Die Seite oder ein Link setzt ihn; Fest: eine Entität; Fest: eine Liste; Alle dieses Typs; Nach Name; Nach Untertyp oder Profil; Bezogen auf einen anderen Parameter oder eine andere Entität |
| Eine oder viele | Eine Entität oder Viele Entitäten |
| In der Filterleiste | Angezeigt, Betrachter können es ändern, Angezeigt, nicht änderbar, Ausgeblendet |
Der Schlüssel eines Parameters beginnt mit einem Kleinbuchstaben und hat höchstens 40 Buchstaben, Ziffern oder Unterstriche. Das Umbenennen eines Schlüssels bricht Karten und Links, die den alten verwenden. Du kannst einen Parameter nicht entfernen, den noch Karten, Seiten, Filter oder andere Parameter verwenden; das Fenster nennt sie.
Eine Karte an einen Parameter binden
Wähle im Datenfeld der Karte Aus dem Dashboard übernehmen und den Parameter, oder Das Gerät dieser Seite. Wenn eine Karte ein Gerät nimmt und der Parameter einen Standort enthält, nimmt die Karte die Geräte unter dem Standort; sind es mehrere, heißt es „holds N devices; pick one“?p.device=…), sodass ein kopierter Link dieselbe Ansicht öffnet.
Grenzen: Eine aufgelöste Menge enthält höchstens 500 Entitäten (die ersten 500 nach Name); eine feste Liste enthält höchstens 100; Beziehungstiefe 1 bis 10 Ebenen.
Schlüsselfilter
Ein Schlüsselfilter grenzt einen Entitätsparameter nach Werten ein, zum Beispiel „Geräte, deren temperature über 30 liegt“. Öffnen Sie Schlüsselfilter verwalten….
- Ein Schlüssel ist ein Entitätsfeld, ein Attribut (beliebiger, client-, shared- oder server-Bereich) oder Latest telemetry.
- Werttypen: Text, Zahl, Boolesch, Datum und Uhrzeit.
- Operationen: gleich, ungleich, größer, größer oder gleich, kleiner, kleiner oder gleich, zwischen, in, nicht in, ist gesetzt, ist nicht gesetzt, ist wahr, ist falsch, beginnt mit, endet mit, enthält, enthält nicht.
- Verknüpfen Sie Bedingungen mit Und: alle treffen zu oder Oder: mindestens eine trifft zu.
- Markieren Sie einen Filter als bearbeitbar, damit Betrachter ihn ändern können.
Obergrenzen: 16 Filter pro Board, 8 Schlüsselfilter pro Filter, 4 Bedingungen pro Schlüsselfilter.
Live-Daten
Karten mit Markierung „live“ aktualisieren sich, während das Board geöffnet ist. Ein Board nutzt eine Verbindung für alle seine Karten. Karten, die nicht live aktualisiert werden können, werden in ihrem Intervall aktualisiert; eine Tabelle mit Seitenumbruch wird immer in ihrem Intervall aktualisiert. Ist die Live-Verbindung nicht verfügbar, zeigt das Board „Live-Updates nicht verfügbar — Polling“ an.
Messwerte in Geschäftsdatensätzen
Ein Geräteschlüssel kann auch ein Feld eines Geschäftsdatensatzes speisen, zum Beispiel den Zähler eines Assets. Richten Sie dies unter Readings-Zuordnung im ⋯-Menü von Geräte oder auf dem Reiter Feeds eines Geräts ein.