InfluxDB

Um Werte über die Influx-Datenbank per api abrufen zu können, muss unter Administration/ Einstellungen/ Berechtigungen/ Module das Modul “States Influxdb Datasource” aktiviert werden.

Search query:


SELECT

Die SELECT-Anweisung wird verwendet, um Daten aus einer Datenbank auszuwählen. Die zurückgegebenen Daten werden in einer Ergebnistabelle, der sogenannten Ergebnismenge, gespeichert.

Für die Auswahl der Daten stehen die folgenden Tags zur Verfügung:

Tags
Description
value_number Werte mit Nummer als Datentyp.
Auch Booleans sind als Datentyp Nummer gespeichert:
- 0 for False
- 1 for True
value_string Werte mit Zeichenketten als Datentyp
SELECT "value_number"

Die Funktionen können auch direkt auf die abgefragten Werte angewendet werden

Function
Description
last() Nur der letzte Wert eines Datenpunkts https://docs.influxdata.com/flux/v0.x/stdlib/universe/last/
mean() Der Durchschnitt aller Werte eines Datenpunkts
min() Nur der niedrigste aller Werte eines Datenpunkts
max() Nur der höchste aller Werte eines Datenpunkts
SELECT mean("value_number")



FROM

Alle werte sind in der state_history-Tabelle gespeichert. Die Query sollte also wie folgt aufgebaut sein:

FROM "states_history"



WHERE

Die WHERE-Query wird zum Filtern von Datensätzen verwendet. Sie wird verwendet, um nur die Datensätze zu extrahieren, die eine bestimmte Bedingung erfüllen.

Folgende Tags stehen in Grafana zur Filterung der Daten zur Verfügung:

Tags
Mögliche Werte
Beschreibung
account_id Id des Accounts für den der Datenpunkt erzeugt wurde.
config_id Id des Konnektors von dem die Informationen zu diesem Datenpunkt stammen.
dtwin_id Id des Digitalen Zwillings oder Virtuellen Gerätes.
dtwin_title Titel des Digitalen Zwillings oder Virtuellen Gerätes.
parser_variable Zugewiesene Variable im parser die diesen Datenpunkt repräsentiert.
source_identifier Die externe ID des Virtuellen Geräts für den dieser Datenpunkt erzeugt wurde.
source_type Quelle/System von dem der Datenpunkt stammt (z.B. Konnektor oder Aggregation).
state_id Id des Datenpunkts.
state_identifier Schlüssel des Datenpunktes.
state_type number; string; boolean; json Typ des Datenpunktes.
twin_ancestor_ids Ids der in der Hierachie übergeordneten Zwillinge.
twin_category virtualDevice; digitalTwin Unterscheidung, ob es sich um ein Virtuelles Gerät oder einen Digitalen Zwillling handelt.
twin_tags Tag(s) des Digitalen Zwillings oder Virtuellen Gerätes.
unit Einheit des Wertes wie im Datenpunkt hinterlegt.
vdevice_groups Gruppe(n) des virtuellen Gerätes





Weitere Informationen zur Influx-Datenbank können der offiziellen Influx Dokumentation entnommen werden.