Der folgende Abschnitt zeigt Ihnen, wie Sie den Datenverkehr und die Messwerte eines Geräts anzeigen können, und erklärt den Unterschied zwischen den beiden.
Datenverkehr vs. Messwerte
Datenverkehr = Alle von einem Gerät gesendeten oder empfangenen Rohdatenpakete, einschließlich verschlüsselter Messwerte
Messwerte = Messwerte, die von einem Gerät nach der Entschlüsselung (Parsing) der jeweiligen Rohdatenpakete gesendet/empfangen werden
Geräte-Datenverkehr anzeigen
Um den von einem Sensor gesendeten Rohdatenverkehr anzuzeigen, muss der Sensor zunächst ausgewählt werden. Dies geschieht unter Geräte -> Liste.
Um das Gerät Datenverkehr anzuzeigen, wählen Sie die Registerkarte „Datenverkehr“ für das ausgewählte Gerät.
Hier werden verschiedene Daten zu den empfangenen Datenverkehr in einer Liste angezeigt.
Geräte-Messwerte anzeigen
Um die Messwerte (= Messwerte) eines Sensors anzuzeigen, wählen Sie auf dem ausgewählten Gerät die Registerkarte „Messwerte“.
Hier haben Sie die Möglichkeit, die Messwerte nach einem bestimmten Zeitraum zu filtern.
Die Schaltfläche „Live-Daten“ kann auch verwendet werden, um die Live-Aktualisierung der Messwerte zu aktivieren bzw. zu deaktivieren.
Wenn hier keine Messwerte angezeigt werden, kann dies an Folgendem liegen:
- Die gewählte Zeitspanne ist zu kurz
- Die Messwerte werden von keinem Gateway empfangen
- Die Messwerte werden empfangen, aber es ist kein Parser für das Gerät ausgewählt
- Der Sensor ist nicht aktiviert
- Der Sensor wurde nicht korrekt im Mandanten gespeichert (falsche Informationen)
Paket Message Types
Zusätzlich zu den eigentlichen Informationen enthält jedes von den Geräten gesendete und vom Datahub empfangene Datenpaket immer auch Informationen über den sogenannten „Message Type“, d.h. die Art bzw. den Typ des betreffenden Pakets.
Pakete mit Messwerten (Readings)
Bei Paketen mit regulären Messwerten (Readings) hängt der Nachrichtentyp immer vom jeweiligen Gerätetyp ab und lautet wie folgt:
- LoRaWAN®-Geräte → type „lora„
- NB-IoT-Geräte → type „nbiot“
- Messgeräte/OMS-Geräte → type „omsraw„
Nachfolgend ein Beispiel für ein JSON-Paket mit Messwerten (Readings) für ein NB-IoT Gerät:
{
"_id": {
"$oid": "69014ac97e49a2effda8842e"
},
"uid": "NBIOT-0e227a0d-71c7-41ef-959a-557e0d4d079215",
"maintenant": "[Name Hauptmandant]",
"data": {
"nbiot": {
"mtype": "unconfirmed_data_up",
"port": 50045,
"ip": "46.210.143.28",
"host": "46.210.143.28",
"dir": "up"
},
"ownernumber": "8ZRI9968995305",
"raw": {
"encrypted": "aAOJdxZgUDhlCAdJapkFU5loX6AAAwI2BQAAaQBAAwABAAChAAACJgD+k5o7AxkKHQABOAT8AgAABRkKHAU4GhADG2YBIBMAIzsAgAAABmsZCh0AAAABARgOlJo7EZSaOxSUmjsXlJo7GpSaOxyUmjsclJo7HJSaOxyUmjsclJo7HJSaOxyUmjsclJo7HJSaOxyUmjsclJo7HJSaOxyUmjsclJo7LZSaOy2UmjstlJo7LZSaOy2UmjsTAAQJAAgAAADb/tz+oQBIFg=="
},
"unmapped": {
"volume": [
999986204,
19,
"L",
"Volume",
999986.204,
"m³"
],
"0800010000FF": 999986204
}
},
"clsbox": "DEADBEEF1020",
"meta": {
"packettype": "NB_FC02",
"parser": "2.0.26",
"sender": {
"mtype": "unconfirmed_data_up",
"port": 50045,
"ip": "46.210.143.28",
"host": "46.210.143.28",
"dir": "up"
},
"generated": true,
"SPValue": "NB_FC02",
"billingperiod": "hourly",
"devicetypename": "WZ",
"devicetype": "IUWS_NB_IoT",
"devicetypeid": 5
},
"type": "nbiot",
"version": 1,
"devicetypename": "IUWS_NB_IoT",
"tenant": "[Name Haupt- oder Submandant]",
"ts": {
"server": 1761692360,
"parser": 1761692360,
"datastore": 1761692360,
"eventtime": 1761739200,
"device": 1761692360
}
}
Bei Bedarf finden Sie in der folgenden Tabelle etwas mehr Informationen über die Bedeutung bestimmter Felder oder Abschnitte in einem solchen JSON-Paket mit Messwerten (Readings) :
| Feld/Abschnitt | Erklärung/Bedeutung |
|---|---|
| "_id": { | interne Verwendung in Datenbank |
| "uid": | interne Verwendung in Datenbank |
| "maintenant": | aktueller Mandant - bei Verwendung von nur Hauptmandanten identisch mit feld "tenant", bei Verwendung von Haupt- und Submandanten hingegen Abweichung möglich) |
| "nbiot": { | Technische Informationen zur NB-IoT-Übertragung |
| "ownernumber": | Interner Gebrauch für jeden Typ von DevEUI, Seriennummer und Ähnliches |
| "encrypted": | verschlüsselte Nutzlast (Payload) |
| "unmapped": { | Entschlüsselte und geparste Nutzlast (Payload) mit Messwerten (Readings) |
| "clsbox": | Interne Verwendung für alle Arten von Gateways – wird jedoch bei NB-IoT nicht benötigt, künftig kein Teil der NB-IoT-Ausgabe sein und enthält auch nur einen Platzhalter |
| "meta": { | Technische Informationen zur Übertragung |
| "generated": | interne Verwendung |
| "SPValue": | interne Verwendung |
| "billingperiod": | Abrechnungsszenario, in dem sich das Gerät befindet |
| "devicetypename": | Abkürzung für Gerätetypen (Wärmezähler, Wasserzähler usw.) |
| "devicetype": | Spezifischer Gerätetyp = Gerätemodell + Technologie (LoRaWAN, NB-IoT, Messung/OMS) |
| "devicetypeid": | ID für den oben genannten Gerätetyp "devicetype": |
| "type": | Allgemeiner Typ dieser Nachricht – hier „nbiot“, könnte aber auch z. B. „event“, „lora“ oder „omsraw“ sein (Sie können Ihre empfangenen Übertragungen z. B. danach kategorisieren) |
| "version": | interne Verwendung |
| "devicetypename": | siehe oben |
| "tenant": | siehe oben |
| "ts": { | verschiedene Unix Zeitstempel |
| "server": | Unix-Zeitstempel, wann diese Nachricht den Server erreichte |
| "parser": | Unix-Zeitstempel, wann diese Nachricht den Parser erreichte |
| "datastore": | Unix-Zeitstempel, wann diese Nachricht den Datastore erreichte |
| "eventtime": | Unix-Zeitstempel, wann dieses Gerät seine Auslesung durchgeführt hat |
| "device": | Unix-Zeitstempel für die interne Zeit des Geräts (hier kann eine Abweichung festgestellt werden, falls vorhanden) |
Pakete mit Smart Alerts
Zusätzlich zu den regulären Messwerten (Readings) können bestimmte Geräte auch sogenannte „Smart Alerts“ erzeugen. Diese Geräte können sich selbst überwachen und mögliche Probleme in Form dieser Smart Alerts ausgeben, z .B. einen niedrigen Batteriestand oder andere wichtige Statusänderungen/Ereignisse. Anders als die Pakete mit den regulären Messwerten sind alle Pakete, die solche Smart Alerts enthalten, vom Message Type „event“.
Nachfolgend ein Beispiel für ein JSON-Paket, das ein Smart Alert Event für ein NB-IoT Gerät enthält:
{
"_id": {
"$oid": "69014ac9cb4f4b025da87dc8"
},
"uid": "EB-5a37c7b3-259d-4bde-9ce1-43f443af8259",
"maintenant": "[Name Hauptmandant]",
"data": {
"ownernumber": "8ZRI9968995305",
"source": {
"uid": "NBIOT-0e227a0d-71c7-41ef-959a-557e0d4d0792",
"causedBy": "parser",
"type": "nbiot"
},
"event": {
"mtype": "unconfirmed_data_up",
"text": "cleared",
"classification": "warning_battery_ndc_low"
}
},
"type": "event",
"version": 1,
"tenant": "[Name Haupt- oder Submandant]",
"ts": {
"event": 1761692360,
"device": 1761692360
}
}
Bei Bedarf finden Sie in der folgenden Tabelle etwas mehr Informationen über die Bedeutung bestimmter Felder oder Abschnitte in einem solchen JSON-Paket mit Smart Alerts:
| Feld/Abschnitt | Erklärung/Bedeutung |
|---|---|
| "_id": { | interne Verwendung in Datenbank |
| "uid": | interne Verwendung in Datenbank |
| "maintenant": | aktueller Mandant - bei Verwendung von nur Hauptmandanten identisch mit feld "tenant", bei Verwendung von Haupt- und Submandanten hingegen Abweichung möglich) |
| "ownernumber": | Interner Gebrauch für jeden Typ von DevEUI, Seriennummer und Ähnliches |
| "source": { | Grund für das Auftreten dieses Events |
| "uid": | interne Verwendung in Datenbank |
| "causedBy": | what caused this message (e.g. the parser) |
| "type": | für die Übertragung verwendete Technologie (LoRaWAN, NB-IoT, OMS) |
| "mtype": | Richtung der Nachricht – z. B. „unconfirmed_data_up“ = Uplink vom Gerät zum Datenhub |
| "text": | zusätzliche Informationen, falls vom Parser im Event bereitgestellt |
| "classification": | Art des Grundes, aus dem dieser Alarm ausgelöst wurde – z. B. schwache Batterie |
| "type": | Allgemeiner Typ dieser Nachricht – hier „nbiot“, könnte aber auch z. B. „event“, „lora“ oder „omsraw“ sein (Sie können Ihre empfangenen Übertragungen z. B. danach kategorisieren) |
| "tenant": | siehe oben |
| "version": | interne Verwendung |
| "ts": { | verschiedene Unix Zeitstempel |
| "event": | Unix-Zeitstempel, wann dieses Ereignis ausgelöst wurde – wie „eventtime“ in Readings |
| "device": | Unix-Zeitstempel für die interne Zeit des Geräts (hier kann eine Abweichung festgestellt werden, falls vorhanden) |