LooT · Zeitreihen für verknüpfte Nodes

Vom leeren Tenant zur Leitwarte

Du legst als Systemadmin ein kleines Smart Home an, lernst die Oberfläche kennen und siehst dann an einer Brauerei mit 355 Millionen Messwerten, was LooT kann. Alles hier ist echt: Bildschirmfotos und Bildfolgen zum Abspielen aus dem laufenden System. Bilder vergrößerst du per Klick.

Das große Bild in 30 Sekunden

LooT hat nur vier Grundideen. Wer sie kennt, findet sich in jeder Ansicht zurecht.

Geräte & Quellen Sensoren, Gateways, Skripte, du selbst schreiben Werte mit Zeitstempel ① Tenant mit Node-Baum Haus Wohnzimmer Temperatur °C · Double Fenster offen Bool Solarleistung W ② jeder Node = eine Zeitreihe ③ Zeitleiste Fenster = welcher Ausschnitt Locator = welcher Augenblick ④ Tabs zeigen ihn Node-Seite Chart Dashboard · Karte alle folgen derselben Zeit Rechte entscheiden, wer welchen Teil des Baums sehen, beschreiben oder umbauen darf (Kapitel 9).

① Tenant

Ein abgeschotteter Mandant mit eigenen Nodes, Benutzern, Charts und Dashboards.

② Node

Ein Knoten im Baum. Hat er einen Werttyp, gehört ihm eine Zeitreihe: Wert + Zeitstempel.

③ Zeitleiste

Ein Zeitfenster und ein Locator für alles, was du gerade ansiehst.

④ Tabs

Node-Seiten, Charts, Dashboards, Editor: verschiedene Blicke auf dieselben Daten.

Zur Umgebung der Aufnahmen

Die Aufnahmen stammen von der Entwicklungsumgebung „midgard“ (Stand 16.11.2026, LooT 0.1.19 bis 0.8.0; deshalb zeigt die Statusleiste auf manchen Bildern eine andere Version, und in den Bildfolgen ist die Benutzerin „alice“ statt „admin“ angemeldet). Die Brauerei enthält simulierte Daten von 2023 bis zum Vormittag des Aufnahmetags; deshalb sind sehr kurze Fenster wie „Letzte 1 h“ leer.

1

Anmelden als Systemadmin

Ein Benutzerkonto, das Tenants anlegen darf.

1

Öffne die LooT-Adresse im Browser. Ohne Sitzung leitet dich die App zur Anmeldeseite von Keycloak (OIDC) weiter. Gib dort Benutzername und Passwort des Systemadmins ein.

2

Danach landest du auf der Seite „Tenant auswählen“. In der Statusleiste unten rechts steht admin (Systemadmin) – daran erkennst du, dass du Systemadmin bist. Nur Systemadmins sehen oben den Knopf „Tenant anlegen“ und alle Tenants des Systems.

Tenant-Auswahl🔍 vergrößern
Tenant-Auswahl mit den vorhandenen Tenants (links die Rail, unten die Statusleiste mit „admin (Systemadmin)“ und dem Link „Systemzustand“).
Was ist ein Tenant?Ein Tenant ist ein abgeschotteter Mandant: eigene Nodes, eigene Benutzer und Rechte, eigene Charts und Dashboards. Daten verschiedener Tenants sehen sich nie.
2

Beispiel-Tenant „Smart Home Beispiel“ anlegen

Unser kleines Hausautomatisierungs-Projekt.

1

Klicke auf Tenant anlegen, tippe den Namen ein (Smart Home Beispiel) und bestätige mit Anlegen. Bleibt der Knopf „Anlegen“ grau, einmal Tab drücken, damit das Feld übernommen wird.

Dialog Tenant anlegen🔍
Der Dialog „Tenant anlegen“ braucht nur einen Namen.
Neuer leerer Tenant🔍
Der neue Tenant (ID 11) ist leer: „Dieser Tenant hat noch keine Nodes.“
2

Der Tenant öffnet sich mit seiner Startseite: oben die Wurzel-Nodes, darunter vier einklappbare Bereiche für die Verwaltung. Rechts zeigt Eigenschaften die „Eigenen Rechte“ R W X M Q U S T – als Systemadmin hast du alle.

ZusammenhangDer Tenant ist die äußere Grenze für alles Weitere: Nodes, Rechte, Charts, Dashboards und Zeitbereiche gehören immer zu genau einem Tenant. Deshalb beginnt jedes Projekt hier – und deshalb siehst du in der Brauerei später nichts von deinem Smart Home.
3

Tenant-Verwaltung: Benutzer, KI, Aufbewahrung

Die vier Bereiche der Tenant-Startseite.

Benutzer- und Gruppenverwaltung

Mitglieder sind alle Benutzer, die den Tenant überhaupt sehen. Der Haken „Admin“ macht jemanden zum Tenant-Admin.

Neuen Benutzer anlegen: E-Mail (Pflicht), optional Vor- und Nachname, optional „Als Admin anlegen“. Keycloak schickt dem Benutzer eine Mail, mit der er sein Passwort setzt.

Vorhandenen Benutzer hinzufügen: per Namenssuche – praktisch, wenn jemand schon in einem anderen Tenant ist.

Benutzer lassen sich in Gruppen bündeln, Gruppen können wieder Gruppen enthalten. Rechte vergibst du später an Benutzer oder Gruppen (siehe Kapitel 9).

Je Zeile gibt es außerdem ein Mail-Symbol und einen Papierkorb (Mitglied entfernen).

Benutzerverwaltung🔍
Mitgliederliste mit Admin-Haken und die Formulare zum Anlegen.

KI-Analyse

Der Schalter „KI-Analyse aktiv“ gibt den Tenant für Auswertungen mit Modellen frei. Ist er aus, bleibt die Funktion gesperrt.

Prognose: Zeitreihenmodelle sagen Verläufe voraus (im Chart der Knopf „Prognose …“). Du legst fest, ob alle betriebenen Modelle oder nur ausgewählte erlaubt sind, und welches das Standardmodell ist.

Fragen (Sprachmodell): Ein Sprachmodell beantwortet Fragen zu den Daten des Tenants und liest sie dafür über Lese-Werkzeuge. Auch hier wählst du erlaubte Modelle und ein Standardmodell.

Die Modelle laufen als eigene Dienste; ihren Zustand siehst du im Systemzustand.

KI-Analyse🔍
Zwei getrennte Blöcke: Prognose und Fragen (Sprachmodell).

Aufbewahrungsklassen

Jeder Node mit Zeitreihe gehört zu einer Aufbewahrungsklasse: Sie bestimmt, wie lange Werte gespeichert bleiben. Vorhanden sind 7 Tage30 Tage1 Jahr10 Jahreunbegrenzt

Neue Klasse (nur Systemadmin): Name, Dauer + Einheit (Minuten bis Jahre, 1 Minute bis 100 Jahre) oder „Unbegrenzt“, optional ein Kurzname.

Unter der Haube liegt je Klasse und Werttyp eine eigene Datenbanktabelle mit automatischer Löschrichtlinie: abgelaufene Daten verschwinden blockweise. Wechselst du die Klasse eines Nodes, kopiert LooT die vorhandenen Werte im Hintergrund um.

Aufbewahrungsklassen🔍
Der Bereich „Neue Klasse“: Name, Dauer, Einheit, Kurzname.
ZusammenhangDie drei Bereiche greifen später überall ein: Gruppen sind die Empfänger der Rechte am Node-Baum (Kapitel 9). Die Aufbewahrungsklasse wählst du bei jedem Node (Kapitel 7) – sie entscheidet, wie weit du in Charts zurückblicken kannst. Und nur mit eingeschalteter KI-Analyse erscheint im Chart der Knopf „Prognose …“ (Kapitel 12).
Faustregel für die AufbewahrungSchnelle Rohdaten (z. B. Schwingungssignale) kurz aufbewahren, Zähler- und Verbrauchswerte lang. In unserem Smart-Home-Beispiel: Zählerstand 10 Jahre, Temperatur 1 Jahr, Fensterkontakt 30 Tage, Mäher-Position 7 Tage.
4

Aufbau der Web-App

Klicke auf die Punkte im Bild oder in der Liste.

Aufbau der Oberfläche
  • 1
    Rail (Schaltleiste)Die Symbole am linken Rand öffnen Ansichten: Nodes, Templates, Charts, Komponenten, Zeitbereiche, Datenquellen, Workflows, Dashboards und Exchange. Mehr in Kapitel 5.
  • 2
    Linke ZoneZeigt die gewählten Ansichten, hier den Node-Baum mit Suche (Platzhalter * und ?) und Tag-Filter. Mehrere Ansichten lassen sich nebeneinander stapeln.
  • 3
    ZeitleisteDas zentrale Zeitfenster und der Locator für alles, was du ansiehst. Details in Kapitel 6.
  • 4
    Tab-GruppeJeder geöffnete Node, Chart, Dashboard oder Editor ist ein Tab. Kursiv = Vorschau-Tab, der beim nächsten Klick ersetzt wird; ein Doppelklick heftet ihn an. Über „Arbeitsbereiche“ verwaltest du Tab-Sätze.
  • 5
    DetailbereichDer Inhalt des aktiven Tabs: bei einem Node der letzte Wert, der Verlauf, Historie, Kommandos und Verbindungen.
  • 6
    Eigenschaften (rechte Zone)Bearbeitbare Stammdaten des gewählten Elements, plus der Reiter „Rechte“. Änderungen gelten erst nach Speichern.
  • 7
    StatusleisteTenant (Link zur Tenant-Startseite), Befehlspalette, Zeitzone, Hell/Dunkel-Umschalter, Benutzer, Link zum Systemzustand und die LooT-Version.
  • 8
    Untere Rail: BereicheBlendet die Zonen Eigenschaften, Objekt-Browser und die Konsole ein oder aus; darunter dein Benutzermenü.

Werkzeuge für den Alltag

Suchen und Filtern im Baum

Das Suchfeld über dem Baum sucht Nodes im ganzen Tenant nach Name (und Alias), mit den Platzhaltern * (beliebig viele Zeichen) und ? (genau ein Zeichen). Während du tippst, erscheint eine Trefferliste mit Pfad und der Anzahl („8 Treffer“); ein Klick springt zum Node.

Suche mit Platzhalter🔍
Suche Lager*: sechs Lagertanks im Gär- und Lagerkeller und die Lagertemperaturen der Verdichter, jeweils mit Pfad.
Tag-Filter🔍
„Tag filtern“: Energie, Massendaten, Neu 2025, Produktionsstraße, Spektrum, Zustandsüberwachung. Tags setzt du in den Eigenschaften oder im Text.

Die Befehlspalette (Strg+K)

Ein Eingabefeld über der Seite, mit dem du alles per Tastatur erreichst: Gehen zu (Nodes, Datenquellen, Ingest-Test, Exchange, Systemzustand, User Settings, Anzeigeeinheiten, Tenant wechseln), Neues Chart, Gerät einrichten, Theme (hell, dunkel, wie System) und Tabs (Arbeitsbereiche, schließen, nächster/vorheriger Tab, nach rechts/unten teilen). Tippst du einen Namen, findet die Palette auch Nodes. Dieselbe Palette öffnet der Knopf „Befehle“ in der Statusleiste.

Befehlspalette🔍
Die Befehlspalette mit Gruppen „Gehen zu“, „Charts“, „Datenquellen“, „Ansicht“ und „Tabs“ samt Tastenkürzeln (z. B. Alt+W schließt den aktiven Tab).
ZusammenhangDie Oberfläche merkt sich je Benutzer und Tenant, was offen ist: Tabs, Breite der Zonen, Zeitfenster. Das liegt in der Datenbank, nicht im Browser – du findest deinen Arbeitsplatz auf jedem Gerät so vor, wie du ihn verlassen hast. Zwei Personen stören sich dabei nicht.
Für Neugierige: User Settings und Konsole

Konto-Menü → User Settings: Schriftart, Schriftgröße, Einrücktiefe und Zeilenabstand im Baum, Abstand zwischen den Fenstern (mit Live-Vorschau) sowie die Anordnung der Ansichten – jeweils mit „zurücksetzen“.

User Settings🔍
Seite „User Settings“ mit Vorschau des Baums.

Konsole: Untere Rail → Konsole öffnet eine Kommandozeile loot> mit Tab-Vervollständigung – dieselben Befehle wie das Programm loot, z. B. node list. Sie nutzt deine Anmeldung; Rechte gelten unverändert.

5

Die Rail-Ansichten im Überblick

Jedes Symbol der linken Leiste mit einem Beispiel aus der Brauerei.

Nodes

Der Node-Explorer: ein Baum aus Werk, Abfüllung, Energie, Kälteanlage … Ein Node ist ein Knoten mit Namen, optional mit einer Zeitreihe (Einheit, Werttyp) und beliebig vielen Kindern. Strukturknoten ohne Zeitreihe (z. B. „Werk Hopfenthal“) ordnen nur.

Zeilen mit Einheit rechts (°C, kW) haben Werte. Ein Klick zeigt Details, Rechtsklick öffnet das Kontextmenü (Kapitel 11).

Nodes🔍
Node-Baum der Brauerei mit Eigenschaften rechts.

Templates

Vorlagen sind wiederverwendbare Teilbäume. „Gärtank“ legt z. B. einen fertig vorbereiteten Teilbaum samt Einstellungen an. Einsetzen: Rechtsklick auf einen Node → Neu → Aus Template …. Umgekehrt speichert Als Template speichern … einen vorhandenen Teilbaum als Vorlage.

So entstehen viele gleichartige Gärtanks in Sekunden statt Stunden.

Templates🔍
Templates „Gärtank“ und „Malzsilo“.

Charts

Gespeicherte Diagramme in Gruppen: Offen (gerade als Tab geöffnet), Meine und Geteilt. Eine Zeile zeigt Name, Änderungszeit und Anzahl der Serien. Ein Klick öffnet das Chart als Tab. Alle Typen erklärt Kapitel 12.

Charts🔍
Chart-Liste unten links; oben eine weitere Ansicht.

Komponenten

Hier laufen die „Rechenbausteine“ des Tenants. Oben In Betrieb: aktive Verwendungen (ein grüner oder roter Punkt zeigt den Zustand), z. B. „Ausstoß Linie 1 in hl“. Darunter die Bibliothek:

Skripte in Python, TypeScript oder C#
Signal z. B. ein Funktionsgenerator (LFO)
Wandler Schwelle, Skalieren, Zuordnungstabelle

Komponenten lesen Nodes und schreiben berechnete Werte in andere Nodes.

Komponenten🔍
Komponenten in Betrieb und die Bibliothek.

Zeitbereiche

Benannte Zeitfenster zum Wiederverwenden: Rückblick (Letzte 1 h … 30 Tage, „Live“), Kalender (Heute, Gestern, Diese Woche …) und Geteilt – feste Fenster, die ein Admin für alle veröffentlicht hat, z. B. „Störfall Kälteanlage August 2024“. Ein Klick stellt das ganze Fenster der Zeitleiste um.

Zeitbereiche🔍
Rückblick, Kalender und geteilte Bereiche mit Dauer.

Datenquellen

Externe Systeme, die Werte liefern: Gateways, ein Labor-LIMS, eine Wetterstation. Eine Statusleiste zählt Alle / Aktiv / Prüfen / Stillgelegt; neue Quellen stehen zunächst bei „Prüfen“ („Wartet auf ersten Wert“). Gerät einrichten führt durch die Anbindung einer neuen Quelle.

Datenquellen🔍
Drei Datenquellen der Brauerei im Status „Prüfen“.

Workflows

Ein Workflow ist ein Datenflussplan auf einer Zeichenfläche: Nodes, Komponenten (Skripte, Wandler) und Dashboard-Steuerelemente werden verbunden. Notizen und Gruppen dokumentieren den Plan. Die Legende erklärt vier Linienarten: Zuordnung, Verbindung, Bindung und UI-Kante.

Workflow🔍
„Produktionsstraße Abfüllung Linie 1“ – von der Flaschenzuführung bis zum Palettierer.

Dashboards

Bedienoberflächen aus Steuerelementen: Zeiger-Instrumente, Ampeln, Balken, Mini-Charts, Karten, Schieberegler, Schalter, Knöpfe. Der Modus Bedienen ist für den Alltag, Bearbeiten zum Umbauen. Schreibende Elemente (Schieber, Schalter, „Notstopp“) schreiben direkt in einen Node.

Mehr in Kapitel 13.

Dashboards🔍
Dashboard „Leitwarte“ mit Liste der Dashboards links.

Exchange

Der Pfeil-Knopf unten in der Rail führt zur Seite Exchange: Teilbäume samt Werten, Charts, Dashboards und Rechten exportieren und in einem anderen Tenant wieder wiederherstellen – z. B. um einen Prototyp in die Produktion zu heben oder ein Backup zurückzuspielen. Im Kontextmenü eines Nodes gibt es dazu Exportieren ….

Kein BildDiese Seite haben wir im Rundgang nicht geöffnet, um nichts zu verändern. In unserem neuen Tenant steht sie unter „Seiten“ in der Rail.
6

Die Zeitleiste: eine Zeit für alles

Das wichtigste Bedienelement von LooT – zum Abspielen und Durchklicken.

In vielen Programmen hat jedes Diagramm seine eigene Zeitauswahl. In LooT gibt es eine Zeitleiste über allen Tabs. Sie beantwortet zwei Fragen: Welchen Ausschnitt sehe ich (das Zeitfenster)? Und welchen Augenblick darin meine ich (der Locator)?

Letzte 7 Tage · Live MoDiMiDoFrSaSo jetzt Chart-Tab Node-Seite 370,5 kW„Am Locator“ Karte · Tabelle · Spektrum zeigen denselben Ausschnittund denselben Augenblick
Die weiße Linie ist der Locator: Er wandert in der Leiste und in jedem Diagramm gleichzeitig.

① Das Zeitfenster wechseln – alle Diagramme folgen

Ein Klick auf den Chip links in der Leiste öffnet die Liste der Zeitbereiche. Spiele die Bildfolge ab und achte auf drei Dinge: das Band oben (je Tag ein Segment, Wochenende schraffiert), die Kurven – und das kleine Wort hinter jeder Serie in der Legende.

  1. Letzte 24 hRückblick „Letzte 24 h“ (Live). Das Fenster endet immer bei „jetzt“ und wandert mit. Die Wirkleistung kommt im Sekundentakt – LooT zeichnet sie verlustarm verdichtet („LTTB“), damit auch 86.400 Punkte flüssig bleiben. Rechts ist es leer: Die simulierten Daten enden am frühen Morgen.
  2. Letzte 7 Tage„Letzte 7 Tage“. Dasselbe Chart, anderer Ausschnitt: Jetzt erkennst du fünf Produktionstage und ein ruhiges Wochenende. Hinter „Wirkleistung“ steht nun Stunde: LooT zeigt den Stundenmittelwert als Linie und Minimum/Maximum als Band.
  3. Letzte 30 Tage„Letzte 30 Tage“. Vier Wochen im Blick – das Wochenmuster wiederholt sich. Das Band oben beschriftet jetzt nur noch die Wochenanfänge.
  4. Letzter MonatKalender: „Letzter Monat“ (Fest). Ein abgeschlossener Zeitraum. Der Chip trägt „Fest“ statt „Live“, und der Locator (der noch auf „jetzt“ steht) liegt außerhalb – die Leiste zeigt deshalb den Wegweiser „jetzt ▸“.
  5. Modernisierung 2025Geteilter Bereich „Modernisierung 2025“ (fünf Monate). Solche Fenster legt ein Admin für alle an. Die Stufe springt auf Tag. Und man sieht eine Geschichte: Ab Mitte Mai liefert die neue PV-Anlage (orange), und der Verbrauch steigt mit der neuen Dosenlinie.
  6. StörfallGeteilter Bereich „Störfall Kälteanlage August 2024“. Sechs Tage aus dem Vorjahr, mit einem Klick erreichbar. Die PV-Serie zeigt „–“: 2024 gab es die Anlage noch nicht. Das Band oben übernimmt die Farbe des Bereichs.
Zusammenhang: Fenster ↔ StufeJe größer das Fenster, desto gröber die Stufe: roh / LTTB → Stunde → Tag. LooT wählt sie selbst, damit nie Millionen Punkte in den Browser müssen. Du verlierst dabei nichts: Das Min/Max-Band zeigt weiter jede Spitze, und Hineinzoomen holt die Rohwerte zurück (Bildfolge ③).
Art des BereichsBeispieleVerhalten
RückblickLetzte 1 h … 30 TageLive endet bei „jetzt“ und läuft mit.
KalenderHeute, Gestern, Diese Woche, Letzter MonatLaufende Zeiträume sind Live, abgeschlossene Fest.
Geteilt„Störfall Kälteanlage August 2024“Feste Fenster für alle; veröffentlichen darf, wer am Tenant das Recht T hat. Eigene, persönliche Bereiche kann jeder anlegen.
Eigener Bereichfrei gewähltVon/Bis selbst setzen, verschieben, zoomen und bei Bedarf „Als Zeitbereich speichern“.

② Den Locator ziehen – ein Augenblick in allen Ansichten

Hier stehen zwei Tabs nebeneinander: links ein Chart, rechts die Node-Seite der Wirkleistung. Wir greifen das Schild des Locators in der Zeitleiste und ziehen es von „jetzt“ nach links durch die Woche.

  1. StartAusgangslage. Der Locator steht auf „jetzt“ (rechter Rand, grün „jetzt“). Die Node-Seite zeigt den letzten Wert: 355,56 kW, Marke „Live“.
  2. ZiehenDer Locator wandert. Die weiße Linie läuft in beiden Diagrammen mit. In der Legende des Charts ändern sich die Werte beider Serien, rechts wechselt „Letzter Wert“ auf die Marke Am Locator und zeigt den Wert zu genau diesem Zeitpunkt – nachts rund 360 kW, in der Schicht über 1.100 kW.
  3. LoslassenLosgelassen. Der Locator bleibt stehen, bis du ihn wieder bewegst. In der Leiste erscheint der Knopf „jetzt“.
  4. ZurückEin Klick auf „jetzt“ – der Locator folgt wieder der Gegenwart, die Node-Seite zeigt wieder den jüngsten Wert.

So setzt du den Locator

  • Ziehen am Schild in der Zeitleiste (wie oben).
  • Strg+Klick in ein Diagramm setzt ihn an die Klickstelle.
  • Pfeiltasten: ein Datenpunkt der aktiven Serie, mit Umschalt 10 % des Fensters.
  • In Tabellen (Historie, Datensätze, Dateien) erscheint beim Überfahren einer Zeile „Locator hierher setzen“.
  • Doppelklick auf die Zeit im Schild: Zeitpunkt eintippen.
Locator gesetzt🔍
Nach Strg+Klick: 965,82 kW „Am Locator“; der Tooltip nennt bei verdichteten Daten Mittelwert, Minimum und Maximum der Stunde.
Zusammenhang: wofür der Locator gut istEr macht aus „ungefähr da“ eine gemeinsame Zeitmarke. Du siehst im Chart eine Spitze, setzt den Locator darauf – und liest auf der Node-Seite, in jedem anderen Chart, im 3D-Chart (weiße Raute) und im Spektrum („am Locator“) ab, was in genau diesem Moment los war. Es gibt nur einen Locator je Tenant-Arbeitsplatz; ihn zu setzen verändert kein Fenster.

③ Im Diagramm zoomen und schieben – das Fenster eines Tabs lösen

Manchmal willst du in einem Chart genauer hinsehen, ohne allen anderen Tabs das Fenster wegzuziehen. Genau das passiert, wenn du direkt im Diagramm arbeitest:

  1. 30 TageStart: 30 Tage. Stufe „Stunde“. Der Mauszeiger steht auf Donnerstag, 12.11.
  2. Strg + MausradStrg + Mausrad zoomt um den Mauszeiger. Oben im Chart wechselt die Plakette auf „Lokal“ mit Von – Bis: Dieser Tab hat jetzt sein eigenes Fenster. Die Zeitleiste ganz oben bleibt bei „Letzte 30 Tage“ – andere Tabs merken nichts. Mit jedem Schritt wird die Kurve schärfer, bis aus „Stunde“ die Rohwerte („LTTB“/„roh“) werden: Du siehst einzelne Schichtwechsel und Pausen.
  3. ZiehenZiehen mit der linken Maustaste schiebt den Ausschnitt. Die Daten laden beim Schieben nach – hier weiter in den 12. und 13.11.: Nachtabsenkung auf rund 360 kW, Schichtbeginn um 6 Uhr.
  4. Übernehmen„Übernehmen“ in der Plakette macht aus dem lokalen Ausschnitt einen benannten Zeitbereich (persönlich oder für alle geteilt) und wählt ihn in der Zeitleiste – dann folgen alle Tabs. So hältst du eine Auffälligkeit für Kollegen fest.
Geste im DiagrammWirkung
Strg + MausradZoomt um den Mauszeiger (ohne Strg scrollt die Seite).
ZiehenVerschiebt den Ausschnitt.
Strg + ZiehenZieht einen Bereich auf, in den gezoomt wird.
DoppelklickZurück zum Ausschnitt vor dem ersten Zoom.
Strg + KlickSetzt den Locator (ändert das Fenster nicht).
Klick auf die Kette in der PlaketteBindet den Tab wieder an die Zeitleiste; war der lokale Ausschnitt geändert, fragt LooT: zentralen Bereich wiederherstellen oder als Zeitbereich übernehmen?
Zusammenhang: gebunden und gelöstJeder Tab ist entweder gebunden (geschlossene Kette, folgt der Zeitleiste) oder gelöst („Lokal“, eigener Ausschnitt). Neue Tabs sind gebunden. So kannst du links die Übersicht der Woche stehen lassen und rechts in eine Stunde hineinzoomen – der Locator bleibt dabei für beide derselbe.
Nachschlagen: die Bausteine der Leiste im Detail
Zeitleiste🔍
Fensterchip, Aktivität und das Band mit dem Locator-Schild.
ElementBedeutung
Chip („Letzte 7 Tage · Live“)Das aktuelle Zeitfenster mit Farbpunkt und Kennzeichen Live/Fest. Ein Klick öffnet die Liste.
BandJe Kalendertag ein Segment in wechselnder Tönung; Samstag und Sonntag neutral und schraffiert.
Locator-SchildZeigt Datum und Uhrzeit des Locators; liegt er außerhalb des Fensters, erscheint ein Wegweiser („◂ Locator“ / „jetzt ▸“), ein Klick zentriert das Fenster um ihn.
AktivitätKlappt die Aktivitätsübersicht für ausgewählte Nodes auf.
Zeitbereich-Menü🔍
Die Liste der Zeitbereiche: Eigener Bereich, Rückblick, Kalender, Geteilt und „Zeitbereiche verwalten …“.
7

Nodes über die Oberfläche anlegen

Das Smart-Home-Haus entsteht.

1

Auf der Tenant-Startseite: Neuer Node legt einen Wurzel-Node an. Wir nennen ihn Haus und lassen den Werttyp auf „keine Zeitreihe“ – er dient nur zum Ordnen.

2

Weitere Nodes entstehen im Baum per Rechtsklick → Neu → Kind-Node … (Kapitel 11). So legen wir Wohnzimmer, Heizung, Energie und Garten unter Haus an, dann darunter die Messstellen.

Dialog Node anlegen🔍
Der Dialog „Node anlegen“ (hier noch fast leer).
Nachschlagen: alle Felder des Dialogs „Node anlegen“

Die Felder des Dialogs

FeldWirkung
Name / BeschreibungName im Baum; Beschreibung erscheint unter dem Titel der Detailseite.
EinheitPhysikalische Einheit (°C, %, W, kWh, …). LooT kann Werte beim Anzeigen oder Schreiben in andere Einheiten derselben Größe umrechnen. „Andere …“ erlaubt eine eigene Einheit.
WerttypSiehe Kapitel 9. „(keine Zeitreihe)“ = reiner Strukturknoten. Lässt sich nur ändern, solange die Zeitreihe leer ist.
RichtungEingang (Sensor liefert), Ausgang (Sollwert, den LooT an ein Gerät schickt), Ein- und Ausgang, keine (intern).
Gleicher ZeitstempelKommt zweimal derselbe Zeitstempel: Erster gewinnt oder Letzter gewinnt (Standard).
Datenaufkommen„Normal“ oder „Sehr hoch“ (über 100.000 Werte je Tag) – dann behandelt LooT den Node als Massendaten-Node.
AufbewahrungDie Klasse aus Kapitel 3.
Aliase & TagsZusätzliche Namen (z. B. „EG“) und Schlagworte zum Filtern im Baum.
Zusammenhang: drei Entscheidungen je NodeWerttyp legt fest, was gespeichert wird und wie die Node-Seite aussieht (Zahl → Verlauf, Geo → Karte, Kapitel 9). Richtung sagt, wer schreibt: Ein Eingang kommt vom Sensor, ein Ausgang ist ein Sollwert, den LooT ans Gerät schickt (z. B. vom Schieberegler eines Dashboards). Aufbewahrung bestimmt, wie lange du zurückblicken kannst. Alles andere (Einheit, Aliase, Tags) kannst du jederzeit nachtragen.

Das Ergebnis: unser Smart Home

Node-Baum Smart Home🔍
14 Nodes in vier Räumen. Links der Baum (Einheiten rechts), rechts die Eigenschaften der gewählten „Temperatur“, mittig die Testseite zum Schreiben von Werten.
PfadTypEinheitRichtungAufbewahrung
Haus › Wohnzimmer › TemperaturDouble°CEingang1 Jahr
Haus › Wohnzimmer › LuftfeuchteDouble%Eingang1 Jahr
Haus › Wohnzimmer › Fenster offenBool–Eingang30 Tage
Haus › Heizung › VorlauftemperaturDouble°CEingang1 Jahr
Haus › Heizung › Sollwert RaumDouble°CAusgang1 Jahr
Haus › Heizung › BetriebsmodusString–Eingang30 Tage
Haus › Energie › StrombezugDoublekWhEingang10 Jahre
Haus › Energie › SolarleistungDoubleWEingang1 Jahr
Haus › Garten › Mäher PositionGeo–Eingang7 Tage
Der Baum wächst weiterIn Kapitel 8 ergänzen wir per Text ein weiteres Zimmer (später „Gästezimmer“) samt Link und im Kapitel 10 einen Test-Node „Außentemperatur“ für die Einheiten-Umrechnung. Spätere Bilder zeigen deshalb mehr Nodes als diese Tabelle.

Werte einspielen

3

Rechtsklick auf einen Node → Wert schreiben … öffnet die Seite Ingest-Test. Sie schreibt einen Wert genau wie ein Gerät über die Ingest-Schnittstelle (POST /api/ingest); dafür braucht man das Recht Write. Eingabefelder: Wert (leer = „kein Wert“), die Einheit des eingegebenen Werts und ein Zeitstempel in Ortszeit (leer = jetzt).

Wert senden🔍
Wert 19,5 mit Zeitstempel 11:00 wird gesendet. Wir haben so 12 Halbstundenwerte eingespielt.
Node Temperatur mit Verlauf🔍
Detailseite „Temperatur“: letzter Wert 19,8 °C und der Verlauf der letzten 6 Stunden.
Zum Schreiben im AlltagEchte Daten kommen nicht von Hand, sondern von Geräten über die Ingest-API, den gRPC-Gerätekanal, Datenquellen oder die CLI (loot write <pfad> <wert>).
8

Nodes als Text definieren

Ein ganzer Teilbaum in einem Editor – lesen, ändern, speichern.

ZusammenhangDialog und Text sind zwei Wege zum selben Ziel: Beide beschreiben denselben Node-Baum. Was du im Dialog einstellst, steht danach im Text – und umgekehrt. Der Text ist außerdem die schnellste Art, einen fremden Teilbaum zu verstehen.

Den Dialog „Node anlegen“ aus Kapitel 7 brauchst du für einzelne Nodes. Wenn du viele Nodes auf einmal anlegen, einen Teilbaum durchlesen, vergleichen oder dokumentieren willst, beschreibst du ihn als Text. Das Format ähnelt YAML: eine Zeile je Node, die Einrückung ergibt die Ebene.

So öffnest du den Text

1

Rechtsklick auf einen Node (oder den Tenant „Nodes“) im Baum → Öffnen ▸ Als Text öffnen (siehe Kapitel 11). Der Eintrag braucht dafür das Recht Read, zum Speichern später Manage.

2

LooT öffnet einen eigenen, festen Tab mit dem Symbol </>. Pro Eintrag gibt es einen Text-Tab (adressierbar als t/<Tenant>/text/<Node>); erneutes Öffnen springt zum vorhandenen. Der Tab folgt nicht der Auswahl im Baum. Ungespeicherter Text zeigt einen Punkt im Tab und bleibt beim Wechseln der Tabs erhalten.

Textansicht des Nodes Haus
  • 1
    Text-Tab „Haus“Fester Tab mit </>. Daneben bleiben die anderen Tabs (hier „Temperatur“ und „Ingest-Test“) unberührt.
  • 2
    EditorEin Code-Editor wie in VS Code (Monaco): Zeilennummern, Faltung, Farben, Vervollständigung für Eigenschaften und Werte. Der Parser prüft beim Tippen und markiert Fehler sofort – ganz ohne Server.
  • 3
    Kontexthilfe „An dieser Stelle“Zeigt zur Zeile unter dem Cursor, was dort erlaubt ist (hier: Node-Zeile), die möglichen Formen und was darunter eingerückt werden darf. Mit dem Fragezeichen oben rechts ein-/ausblenden.
  • 4
    Speichern · Neu ladenDaneben die Meldung „14 Einträge aus „Haus“ gelesen“. Neu laden erzeugt den Text frisch vom Server.
  • 5
    Titelzeile„TEXT · „Haus“ mit Unterknoten“: der Text umfasst den Node und seinen ganzen Teilbaum, der Node selbst steht in der obersten Zeile.

Die Syntax im Überblick

SchreibweiseBedeutung
NameStrukturknoten („Ordner“) ohne eigene Werte.
Name: doubleNode mit Zeitreihe und diesem Werttyp: int, long, float, double, bool, string, blob, geo (Kurzformen wie integer, boolean, text, custom werden ebenfalls verstanden).
EinrückungDie Tiefe ergibt die Ebene; Geschwister stehen gleich tief. In diesem Tutorial 4 Leerzeichen je Ebene. Die Reihenfolge der Zeilen bleibt erhalten.
@propertiesBlock unter einem Node, je Zeile eigenschaft: wert: description, type, unit, direction (in, out, inout, none), duplicates (first, last), retention (Name der Aufbewahrungsklasse), aliases, tags, default (nur in Templates), reference (Ziel eines Links). Einzeln auch als @unit: °C.
Name: @reference PfadEin Link: der Node wird ein zweites Mal eingehängt, ohne Daten zu kopieren. Pfade schreibt man Tenant/Wurzel.Kind.Enkel: ein / trennt nur den Tenant ab, die Node-Ebenen trennt ein Punkt.
@permissionsRechte, je Zeile user Anna: rwm oder group Betrieb: deny w. Kürzel r w x m q oder Wörter (read, write, execute, manage, sources); deny verbietet. Vergeben dürfen nur Tenant-Admins.
@actionBlock mit rename: Neuer Name und/oder remove: true – benennt den vorhandenen Node um bzw. entfernt ihn samt Teilbaum und Zeitreihenwerten.
# …Kommentar. Leerzeilen zählen nicht.
Tolerant beim SchreibenSchlüsselwörter, Werttypen, Richtungen, Rechte-Kürzel und Namen von Aufbewahrungsklassen gelten ohne Beachtung der Groß-/Kleinschreibung; mehrfacher Leerraum wird zu einem Leerzeichen (7 Tage = 7 Tage); in/out gilt als inout.

Ein echtes Beispiel: die Kälteanlage der Brauerei

So sieht der Text eines gewachsenen Teilbaums aus, mit Beschreibungen, Aliasen (VIB-V1) und Tags (Massendaten, Zustandsüberwachung). 16 Einträge, ein Blick genügt, um die ganze Anlage zu überblicken.

Text der Kälteanlage🔍
„Als Text öffnen“ an „Kälteanlage“: Glykol-Vor-/Rücklauf, Störung und die beiden Verdichter mit Schwingungs- und Temperaturnodes.

Hands-on: ein Schlafzimmer per Text anlegen

Wir ergänzen im Smart-Home-Tenant einen neuen Raum. Öffne dafür „Haus“ als Text (Bild oben) und hänge ans Ende ein:

# neuer Raum unter „Haus“ (4 Leerzeichen eingerückt)
    Schlafzimmer
        @properties
            description: Rauminformationen Schlafzimmer
        Temperatur: double
            @properties
                unit: °C
                direction: in
                retention: 1 Jahr
        Licht an: bool
            @properties
                description: Deckenlicht schalten
                direction: inout
                retention: 30 Tage
        Fenster Link: @reference Smart Home Beispiel/Haus.Wohnzimmer.Fenster offen
TippenDer Parser prüft laufend und markiert Fehler direkt im Text.
SpeichernErst wird alles gelesen und geprüft; erst ohne Befund legt LooT die Nodes in Textreihenfolge an.
ErgebnisEine Meldung nennt, was angelegt, geändert, umbenannt oder unverändert blieb.

Was passiert bei Fehlern? Wir haben absichtlich direction: reinraus geschrieben und den Pfad des Links falsch notiert. Die Fehler stehen mit Zeilennummer unter dem Editor – gespeichert wird dann nichts:

Fehlerliste im Texteditor🔍
Unter dem Editor: „Zeile 70: Unbekannte Richtung 'reinraus'; erlaubt sind in, out, inout, none.“ und „Zeile 77: Ungültiges Pfadsegment …“
Zeile 70: Unbekannte Richtung 'reinraus'; erlaubt sind in, out, inout, none.
Zeile 77: Ungültiges Pfadsegment 'Haus.Wohnzimmer.Fenster offen': Der Name darf weder '.' noch '/' enthalten.
# nach dem ersten Korrekturversuch:
Zeile 77: Im Pfad 'Haus/Wohnzimmer/Fenster offen' trennt '/' nur den Tenant ab; Node-Ebenen werden mit '.' getrennt (Tenant/Wurzel.Kind).

Die Meldungen sagen genau, was zu tun ist. Mit direction: in und dem Pfad Smart Home Beispiel/Haus.Wohnzimmer.Fenster offen klappt das Speichern:

Gespeichert🔍
„4 angelegt, 0 geändert, 14 unverändert.“ Im Baum links erscheint „Schlafzimmer“; der kursive Eintrag „Fenster Link“ ist der Link.

Umbenennen und Löschen mit @action

Auch Änderungen am Bestand gehen per Text. Wir benennen „Schlafzimmer“ in „Gästezimmer“ um: Unter der Zeile mit dem vorhandenen Namen kommt ein @action-Block:

    Schlafzimmer
        @action
            rename: Gästezimmer
        @properties
            description: Rauminformationen Gästezimmer
rename im Text🔍
Der Block im Editor.
Umbenannt🔍
„0 angelegt, 0 geändert, 1 umbenannt, 17 unverändert. Text neu geladen.“
Vorsicht bei remove: trueEs löscht den vorhandenen Node samt Teilbaum und allen Zeitreihenwerten. Prüfe den Text vor dem Speichern genau und halte dich an das Recht Manage – nur wer es hat, kann speichern.
Nachschlagen: Spielregeln beim Speichern

Spielregeln beim Speichern

SituationVerhalten
Node mit gleichem Namen existiert schonEr dient als Vater seiner Kinder im Text. Nennt der Text eine Eigenschaft anders, wird sie aktualisiert; nicht genannte Eigenschaften bleiben unverändert.
Eigenschaft auf Standard zurücksetzenAusdrücklich nennen: duplicates: last, retention: unbegrenzt oder unit: (leer).
Anderer Werttyp / andere Aufbewahrung bei vorhandenen WertenDer Server lehnt ab, Speichern hält mit der Zeile an. Bis dahin Angelegtes bleibt.
Neu ladenErzeugt den Text neu (bis 2000 Einträge). Nur gesetzte Eigenschaften erscheinen; Standardwerte (z. B. Richtung inout, Aufbewahrung „unbegrenzt“) werden weggelassen. Neu laden und Speichern ändert nichts.
Rechte in @permissionsDer Text gilt als Soll für die genannten Benutzer/Gruppen: abweichende Einträge werden ersetzt, gleiche bleiben, fehlende entstehen, nicht genannte bleiben. Unbekannte Namen sind Fehler mit Zeilennummer.
Wo legt Speichern an?Am Node auf seiner Geschwisterebene unter seinem Vater (der Node wird als vorhanden erkannt); am Tenant als Wurzel-Nodes; an der Wurzel eines Templates als dessen Kinder.
Wann Text, wann Dialog?Dialog: ein einzelner Node, Rechte zeigen, Einheit mit Umrechnung. Text: Strukturen aufbauen, 20 gleichartige Nodes anlegen, einen Teilbaum durchlesen oder als Dokumentation weitergeben. Das Format ist zusätzlich als JSON-Schema beschrieben (doc/spec/node-outline.schema.json).
9

Datentypen und Berechtigungen

Was ein Node speichern kann – und wer was darf.

Datentypen

Wähle einen Typ. Die Bilder stammen aus der Brauerei und zeigen jeweils einen echten Node dieses Typs.

Double (und Int, Long, Float)

Zahlen: ganz (Int, Long) oder mit Nachkommastellen (Float, Double). Der Standard für Messwerte wie Temperatur, Leistung, Druck.

Sie haben eine Einheit. Über der Anzeige wählst du die Darstellungseinheit („wie gespeichert (kW)“, „alle Größen …“).

Bei vielen Werten zeichnet der Verlauf Mittelwert als Linie, Min/Max als Band je Stunde; zoomen liefert Details.

Beispiel: Wirkleistung · Strom

Double🔍
Wirkleistung 355,56 kW, Wochenverlauf mit Produktions- und Wochenendphasen.

Bool

Wahr/falsch: Schalter, Kontakte, Störmeldungen. Anzeige als „wahr“/„falsch“, im Dashboard als Ampel oder Lampe.

Beispiel: Verdichter 1 · Läuft

Bool🔍
Letzter Wert „falsch“; in der 7-Tage-Ansicht gab es keine Wechsel (Hinweis „Zum letzten Wert springen“).

String

Beliebiger Text – Betriebsmodi, Chargennamen, Statusmeldungen. Eine Zeitreihe speichert, wann sich der Text geändert hat.

Beispiel: Sudhaus · Sorte (Weißbier)

String🔍
Der aktuelle Wert groß; „Historie“ listet frühere Texte.

Compound

Ein Datensatz mit benannten Feldern zu einem Zeitstempel – z. B. ein Sudprotokoll mit Sud-Nummer, Sorte, Stammwürze, Ausschlagmenge, Dauer. Felder haben eigene Typen und Einheiten und lassen sich einzeln abfragen und in Charts nutzen.

Beispiel: Sudhaus · Sudprotokoll

Compound🔍
Tabelle „Letzte Datensätze“ mit Spalten je Feld.

Geo

Eine Position: Breite und Länge, optional Höhe, Genauigkeit, Geschwindigkeit und Richtung. Die Detailseite zeichnet den Pfad auf einer Karte (OpenStreetMap) und markiert die letzte Position. Auch Dashboards haben ein Karten-Element.

Beispiel: Logistik · LKW 1

Geo🔍
447 Positionen der Auslieferungstour zwischen Würzburg und Nürnberg.

Custom

Beliebige Dateien (Blobs): PDFs, Bilder, Messprotokolle bis 1 GB. Die Zeitreihe listet Zeitstempel, Größe, Inhaltstyp und Dateiname mit Knopf „Herunterladen“.

Beispiel: Labor · Analysenzertifikat

Custom🔍
Monatliche Zertifikate als Dateien.

Stream

Kontinuierliche Mediendaten wie Audio. Sie kommen vom Gerät über den Gerätekanal in Sitzungen, die per Kommando „Stream starten/beenden“ ausgelöst werden. Hier trägt die Zeitreihe keine Einzelwerte, sondern Aufnahmen.

Beispiel: Linie 1 · Mikrofon Abfüllhalle (WAV, 16 kHz)

Stream🔍
Format wav, 1 Kanal, 16 kHz, 16 Bit; „Noch keine Sitzung aufgezeichnet“.

Berechtigungen

Rechte gelten für einen Tenant oder einen Node, werden an Benutzer oder Gruppen vergeben – als Erlauben oder Verbieten – und vererben sich nach unten. Die effektiven Rechte entstehen aus eigenen und geerbten Gruppenrechten. Probiere es aus:

Mit diesen Rechten darf der Benutzer …
  • Node, Verlauf und letzte Werte ansehen
  • Werte schreiben (z. B. „Wert schreiben …“, Sollwert-Schieberegler im Dashboard)
  • Kommandos wie „Notstopp“ oder „Stream starten“ auslösen
  • Nodes anlegen, umbenennen, verschieben, löschen und Rechte vergeben
Reiter Rechte🔍
Reiter „Rechte“ eines Nodes: Eintrag für Benutzer/Gruppe anlegen (R/W/X/M, Erlauben/Verbieten) und darunter die effektiven Rechte nachsehen.
Die vier Zusatzrechte am TenantSystemadmins sahen in „Eigene Rechte“ R W X M Q U S T. Die vier Buchstaben danach gelten nur am Tenant:
Q Datenquellen anlegen · U Komponenten-Verwendungen anlegen · S Skripte anlegen · T Zeitbereiche für alle veröffentlichen.
PraxisGib Gruppen Rechte, nicht Einzelpersonen: „Betrieb“ darf lesen und schreiben, „Leitwarte“ zusätzlich Kommandos, „Technik“ verwalten. Mit Verbieten sperrst du gezielt einzelne Teilbäume.
10

Einheiten und Umrechnung

Gespeichert wird in einer Einheit – angezeigt, wie du sie brauchst.

Das GrundprinzipEin Node speichert seine Werte immer in seiner eigenen Einheit (z. B. kW). Umgerechnet wird ausschließlich auf dem Server – nicht im Browser. Deshalb gilt jede Umstellung überall gleich: Web-App, Handy-App, CLI und Programmierschnittstellen.
Gerät sendet68 °F ② Eingabe Ingest rechnet um°F → °C ① Node speichert20 °Cimmer in seiner Einheit Serverrechnet beim Lesen ③ du: 68 °Fje Größe ④ Serie: Kje Kurve Nur ① verändert gespeicherte Daten. ②, ③ und ④ rechnen unterwegs um.

Vier Stellen, an denen Einheiten eine Rolle spielen

WoWas du einstellstWirkung
1. Node-Einheit
(Eigenschaften)
In welcher Einheit der Node speichertÄndert das Stammdatum; vorhandene Werte werden im Hintergrund umgerechnet.
2. Eingabe
(Wert schreiben)
In welcher Einheit du einen Wert eingibstDer Ingest-Server rechnet vor dem Speichern in die Einheit des Nodes um.
3. Anzeige je Größe
(Node-Seite, „Anzeigeeinheiten“)
Pro Größe (Temperatur, Leistung …) eine WunscheinheitGilt für dich überall und auf allen Geräten. Gespeichert wird nichts um.
4. Anzeige je Serie
(Chart)
Einheit einer einzelnen KurveÜbersteuert Punkt 3 – nur für diese Serie im Chart.

Der Einheitenkatalog

Einheiten kommen aus einem festen Katalog, gruppiert nach Größen. Umrechnen geht nur innerhalb einer Größe (°C ↔ °F, aber nicht °C ↔ m). Die Seite „Anzeigeeinheiten“ listet alle:

Seite Anzeigeeinheiten🔍
Seite „Anzeigeeinheiten“: Voreinstellung (SI oder Imperial), darunter je Größe eine Auswahl. Ganz rechts die verfügbaren Einheiten der Größe.
Nachschlagen: alle Größen und Einheiten des Katalogs
GrößeEinheiten
Temperatur°C, °F, K, °R
Längenm, µm, mm, cm, m, km, in, ft, yd, mi
Volumenml, cm³, l, m³, ft³, gal (US), gal (UK), bbl
Masseµg, mg, g, kg, t, oz, lb
DruckPa, hPa, mbar, kPa, bar, psi, mmHg, atm
EnergieJ, kJ, Wh, kWh, MJ, cal, kcal, BTU
LeistungW, kW, MW, PS, hp
Geschwindigkeitm/s, km/h, mph, kn
Zeitms, s, min, h, d
Anteil%, ‰
Flächemm², cm², m², ha, km², ft², ac
Volumenstroml/h, l/min, l/s, m³/h, m³/s
Winkelrad, °, gon

Im Node-Dialog wählst du die Einheit aus diesem Katalog (SI und metrisch vor imperial). „Andere …“ erlaubt freien Text – solche Nodes lassen sich nicht umrechnen und bleiben „wie gespeichert“.

Ebene 3: Anzeige in deiner Wunscheinheit

Am schnellsten geht es direkt auf der Node-Seite: Über „Letzter Wert“ steht eine Auswahl mit „wie gespeichert (kW)“ und den Einheiten derselben Größe. Wir wählen W:

Node in Watt🔍
Aus 355,56 kW werden 355560 W. Der Verlauf heißt jetzt „IN W“ und die Achse zeigt 1.200.000 statt 1.200. Im Baum trägt „Wirkleistung“ das Badge W. Rechts steht in den Eigenschaften weiterhin kW – gespeichert wird nichts verändert.
  • Die Wahl gilt für die ganze Größe („Leistung“), nicht nur für diesen Node: andere Leistungs-Nodes erscheinen ebenfalls in W – ob in Baum, Objektliste, Editor, Charts oder Live-Werten.
  • Sie ist eine Benutzereinstellung und gilt auf all deinen Geräten.
  • Der erste Eintrag „wie gespeichert (kW)“ nimmt die Vorgabe wieder weg. Der Link „alle Größen …“ führt zur Seite „Anzeigeeinheiten“.
  • Nur numerische Nodes mit bekannter Einheit bieten die Auswahl an; Nodes ohne Einheit oder mit Text bleiben „wie gespeichert“.

Alles auf einmal: die Seite „Anzeigeeinheiten“

Du erreichst sie im Konto-Menü (unterstes Symbol der Rail) oder über die Befehlspalette. Dort stehen ganz oben zwei Voreinstellungen: SI (metrisch) und Imperial, dazu Zurücksetzen (wie gespeichert). Danach lassen sich einzelne Größen feiner anpassen.

Konto-Menü🔍
Konto-Menü: User Settings · Anzeigeeinheiten · Abmelden.
Voreinstellung Imperial🔍
Voreinstellung „Imperial“ setzt Temperatur °F, Länge ft, Volumen gal (US), Masse lb, Druck psi, Energie BTU, Leistung hp, Geschwindigkeit mph und Fläche ft². Zeit, Anteil, Volumenstrom und Winkel bleiben „wie gespeichert“.

Der Effekt auf einen Temperatur-Node der Kälteanlage – gespeichert ist 49,86 °C:

Node in Fahrenheit🔍
Mit „Imperial“ erscheint die Lagertemperatur des Verdichters in °F (Letzter Wert, Verlauf, Baum).
Danach wieder aufräumenZurück zum Normalzustand: Seite „Anzeigeeinheiten“ → Zurücksetzen (wie gespeichert). Für dieses Tutorial haben wir die Voreinstellung nach den Aufnahmen sofort zurückgesetzt.

Ebene 4: Einheit je Serie im Chart

Ein Klick auf den Namen einer Serie in der Legende öffnet den Serien-Dialog: Anzeigename, Farbe, Y-Achse (links/rechts) und die Anzeigeeinheit. Der Hinweis im Dialog sagt es deutlich: Die Einheit dieser Serie übersteuert die Vorgabe des Benutzers; unten steht „Node-Id 1196, gespeichert in kW“.

Serien-Dialog🔍
Serien-Dialog der Serie „Leistung“; die Auswahl „wie gespeichert (kW) · W · kW · MW · PS · hp“.
Serie in Watt🔍
Nach „Übernehmen“: Die Leistung wird in W gezeichnet (Legende „2210 W“, Achse bis 200.000). Die anderen Serien behalten ihre Einheit – und wirken neben so großen Werten flach.
Eine Achse, mehrere EinheitenJede Y-Achse trägt die Einheiten ihrer Serien als Beschriftung (z. B. „W/m² · W · °C“). Liegen sehr verschiedene Größenordnungen auf einer Achse, legst du eine Serie im Serien-Dialog auf die rechte Achse – oder wählst eine passendere Anzeigeeinheit (kW statt W).

Ebene 2: Werte in anderer Einheit eingeben

Auf der Testseite „Ingest-Test“ (Kapitel 7) steht unter dem Wert: „Einheit des eingegebenen Werts (gespeichert wird in °C; der Ingest-Server rechnet um)“. Gibst du dort 68 mit der Einheit °F ein, speichert LooT 20 °C.

Ingest-Test mit Einheit🔍
Ingest-Test: Wert, Einheit des Werts (hier °C), Zeitstempel.

Ebene 1: Die Einheit des Nodes ändern – mit Umrechnung der Werte

Das ist der gründlichste Eingriff, denn er verändert die gespeicherten Daten. Wir probieren es an einem kleinen Test-Node „Außentemperatur“ (°C) mit fünf Werten. Schritt für Schritt:

1

Node öffnen, rechts in den Eigenschaften das Feld Einheit ansehen: Es steht auf °C.

Einheit vorher🔍
Vorher: letzter Wert 5,2 °C, Verlauf zwischen 5 und 7,5 °C.
2

Die Auswahl zeigt jetzt nur Einheiten derselben Größe (°C, K, °F, °R), weil der Node schon Werte hat. Ohne Werte stünden alle Einheiten des Katalogs – auch anderer Größen – zur Wahl. Wir wählen °F und klicken Speichern.

Einheit gewählt🔍
°F ausgewählt, noch nicht gespeichert.
Umrechnungs-Job🔍
Umrechnung läuft: „Die Werte werden gerade von °C in °F umgerechnet. Einheit, Werttyp und Klasse sind erst danach wieder änderbar; neue Werte nimmt der Node währenddessen nicht an und Abfragen der Werte sind gesperrt.“
3

Ein Hintergrund-Job rechnet alle Werte um. Er wartet kurz (Standard 15 s), damit laufende Schreibvorgänge abgeschlossen sind, arbeitet dann in Stücken zu je 5.000 Zeilen in aufsteigender Zeit und lässt zum Schluss die zusammengefassten Stunden- und Tageswerte neu berechnen. Erst dann wechselt die Einheit am Node.

Einheit fertig🔍
Fertig: Der letzte Wert zeigt 41,36 °F (= 5,2 °C), Verlauf und Achse sind in °F, im Baum steht das Badge °F, in den Eigenschaften „°F“.
Nachschlagen: Regeln und Grenzen der Umrechnung

Regeln und Grenzen

RegelWarum
Recht Manage am Node nötig (sonst nur Ansicht)Es ist eine Änderung der Eigenschaften.
Mit Werten nur Einheiten derselben Größe; „Andere …“ und „(keine)“ entfallenEine Umrechnung von °C in m wäre sinnlos.
Rundung auf 12 signifikante StellenBei Float/Double gehen höchstens Stellen jenseits der 12. verloren.
Int/Long: nur verlustfreie Umrechnung (ganzzahlige Faktoren, z. B. m → mm)Sonst würde gerundet. Der Server lehnt mit Grund ab (409); läuft ein Ergebnis aus dem Zahlenbereich, endet der Job als gescheitert und der Node bleibt unverändert.
Einheit entfernen, nicht numerischer Typ oder bisherige Einheit nicht im Katalog: nicht möglichNicht verlustfrei umrechenbar.
Einheit nicht zugleich mit der Aufbewahrungsklasse ändernBeide Änderungen kopieren Werte; nacheinander ausführen.
Node ohne bisherige Einheit: neue Einheit ist nur BeschriftungEs gibt nichts umzurechnen.
Während des Jobs: keine neuen Werte, keine AbfragenSonst gäbe es gemischte Einheiten in einer Zeitreihe. Plane Umstellungen also bei laufenden Messungen kurz ein.
Anzeige umstellen ist nicht Einheit ändernWenn dir nur die Darstellung nicht passt, nimm Ebene 3 oder 4 – sie sind sofort wirksam, jederzeit umkehrbar und verändern keine Daten. Die Node-Einheit (Ebene 1) ändert man, wenn die Quelle künftig in einer anderen Einheit misst.
Für Entwickler: Einheiten im Text und in der Schnittstelle

Einheiten im Text und in der Schnittstelle

  • Textdefinition: unit: °C im @properties-Block (Kapitel 8); leer lassen (unit:) entfernt die Einheit.
  • Abfragen (Entwickler): Parameter unit nennt Zieleinheit(en) – für eine Einheit streng (Fehler bei Unpassendem), für Listen tolerant; unitPref gibt deine Vorgabe je Größe immer tolerant mit. GET /api/units liefert den Katalog.
  • Live-Werte: Beim Abonnieren eines Nodes nennt die Oberfläche die Zieleinheit; der Server rechnet jeden Wert vor dem Senden um.
11

Das Kontextmenü des Node-Explorers

Rechtsklick auf einen Node im Baum.

Kontextmenü🔍
Kontextmenü für „Haus“, Untermenü „Öffnen“ ausgeklappt.
Untermenü Neu🔍
Untermenü „Neu“: Kind-Node …, Link …, Aus Template ….

Klappe die Gruppen auf:

Öffnen ▸ Details · Im Editor zeigen · Als Text öffnen

Details öffnet die Detailseite als Tab. Im Editor zeigen öffnet den grafischen Editor (Kapitel 13) auf der Ebene des Nodes. Als Text öffnen zeigt den Node in einer Textansicht.

Exportieren …

Exportiert den Teilbaum in ein Archiv, das du über Exchange wiederherstellen kannst.

Neu ▸ Kind-Node · Link · Aus Template

Kind-Node … legt einen neuen Node unter dem gewählten an. Link … hängt einen vorhandenen Node ein zweites Mal ein – so gehört ein Zähler zu „Energie“ und zu „Kostenstelle A“, ohne Daten zu kopieren (LooT-Nodes sind verknüpft, nicht nur ein Baum). Aus Template … setzt eine Vorlage ein.

Umbenennen (F2) · Eigenschaften · Kommandos · Nach außen gezeigte Werte

Umbenennen geht auch mit F2. Eigenschaften aktiviert die rechte Zone. Kommandos zeigt die auslösbaren Aktionen des Nodes. Nach außen gezeigte Werte sind Werte von Nachfahren, die ein Strukturknoten stellvertretend präsentiert (z. B. „Haus“ zeigt die Raumtemperatur).

Wert schreiben …

Öffnet die Ingest-Testseite (Kapitel 7). Ausgegraut, wenn der Node keine Zeitreihe hat oder das Write-Recht fehlt – wie bei „Haus“.

Ausschneiden · Kopieren · Einfügen · Link einfügen

Wie im Dateimanager: Strg+X/C/V. Link einfügen (Strg+Umschalt+V) fügt das Kopierte als Verknüpfung statt als Kopie ein.

Verschieben … · Als Template speichern …

Verschieben wählt ein neues Elternelement in einem Dialog. Als Template speichern macht den Teilbaum zur wiederverwendbaren Vorlage.

Pfad kopieren

Kopiert den Pfad (z. B. Smart Home Beispiel/Haus/Wohnzimmer.Temperatur) für CLI, Skripte und die Ingest-API.

Rechte … · Löschen … (Entf)

Rechte … öffnet den Reiter „Rechte“. Löschen … entfernt den Node samt Kindern nach Rückfrage – ausschließlich mit dem Recht Manage.

12

Diagramme: bauen, umschalten, drehen

Jedes Chart ist ein Tab – vom Zeitverlauf bis zur Punktwolke im Raum.

Ein Chart ist in LooT nichts Festes, sondern eine Sammlung von Serien (Nodes) plus eine Darstellung (Typ und Optionen). Dieselben Serien lassen sich mit einem Klick als Linie, Histogramm, Streudiagramm oder 3D-Wolke ansehen.

In 20 Sekunden zum eigenen Chart

„Neues Chart“ (Ansicht „Charts“ → ⋮ oder Befehlspalette) öffnet einen leeren Chart-Tab. Dann ziehst du Nodes aus dem Baum hinein:

  1. AusgangslageEin Chart mit einer Serie. „Wirkleistung“ (Strombezug der Brauerei, blau) über sieben Tage. Im Baum links steht unter „PV-Anlage“ der Node „Leistung“.
  2. ZiehenNode greifen und ziehen. Am Mauszeiger hängt eine Karte, die sagt, was beim Loslassen passiert: „Leistung“ in „Chart 1“ zeigen. Das Chart leuchtet als Ziel auf.
  3. AblegenLoslassen – fertig. Die PV-Leistung erscheint als zweite Serie (orange) mit eigener Legendenzeile: Name, Wert am Locator, Stufe und ✕ zum Entfernen. Jetzt sieht man: Mittags deckt die PV-Anlage einen kleinen Teil des Bezugs.
Zusammenhang: was ein Chart speichert – und was nichtDas Chart merkt sich Typ, Optionen, Achsen und Serien, aber nicht den Zeitraum: Der kommt aus der Zeitleiste (Kapitel 6). Deshalb taugt ein gespeichertes Chart für jede Woche und jeden Störfall. „Nicht gespeichert“ neben dem Namen heißt: Es lebt nur in deinem Arbeitsplatz; Speichern unter … legt es im Tenant ab, wo du es mit anderen teilen kannst.

Welcher Typ für welche Frage?

Deine FrageTyp
Wie verläuft ein Wert, wann ändert er sich?Linie · Stufen (Zustände, Sollwerte)
Wie viel in Summe / welcher Anteil?Fläche (gestapelt) · Kreis · Baumkarte
Wie streut ein Wert, was ist typisch?Histogramm · Boxplot
Wann gab es Auffälligkeiten über viele Anlagen?Heatmap
Hängen zwei Größen zusammen?Streu (mit Trendlinie)
… und eine dritte Größe?Blasen (flach) · 3D (räumlich, Farbe = Zeit)
Welche Frequenzen stecken im Signal?Spektrum
Wann tauchen Frequenzen auf oder wandern?Spektrogramm
Zusammenhang: Typen und ZeitZeitverläufe (Linie, Stufen, Punkte, Fläche, Balken) zeichnen über der Zeit und zeigen den Locator als Linie. Die zusammenfassenden Typen (Kreis, Baumkarte, Histogramm, Boxplot) verdichten das ganze Zeitfenster zu einer Aussage – wechselst du das Fenster, ändert sich das Ergebnis; der Locator spielt dort keine Rolle.
Nachschlagen: alle 14 Typen und der Typ-Wähler
Charttyp-Menü🔍
Bei schmalem Tab klappt die Typ-Leiste zu einem Menü zusammen.
GruppeTypZeigt
ZeitverlaufLinieStandard. Wahrheitswerte erscheinen als Stufen (0/1).
StufenDer letzte Wert hält bis zum nächsten Zeitstempel.
PunkteNur die Messpunkte, keine Verbindung.
FlächeLinie mit Füllung; optional gestapelt oder gestapelt 100 %.
BalkenJe Punkt ein Balken – sinnvoll bei aggregierten Stufen.
Verteilung & VergleichHistogrammVerteilung der Werte je Serie im Zeitfenster.
BoxplotQuartile, Median und Ausreißer je Serie.
HeatmapZeit × Serie (Mittelwert) oder Zeit × Wertebereich (Anzahl).
KreisEine Scheibe je Serie; Wert = Aggregat über das Zeitfenster.
BaumkarteEine Kachel je Serie, Fläche = Aggregat, gruppiert nach Eltern-Node.
StreuJe ein Node auf X und Y, optional mit Trendlinie.
Zusammenhänge & AnalyseBlasenJe ein Node auf X, Y und Blasengröße.
3DDrei Nodes als Punkte oder Linie im Raum, Farbe nach Zeit.
SpektrumLeistungsspektrum (dB über Frequenz) von Stream-Nodes oder Zahlen; bis zu 8 Serien überlagert.

Zeitverläufe lesen

Linien-Chart🔍
Linien-Chart „Wetter und PV-Ertrag“: Globalstrahlung (blau), PV-Leistung (orange), Außentemperatur (grün). Die Legende nennt je Serie den Wert am Locator und die Stufe.
  • Min-Max-Band: Bei den Stufen Stunde und Tag liegt um den Mittelwert ein halbtransparentes Band von Minimum bis Maximum – keine Spitze geht verloren.
  • Zwei Y-Achsen: Jede Serie liegt links oder rechts; so passen kW und °C in ein Bild.
  • Optionen (≡): Gitter, Legende, Band; je Achse Minimum, Maximum und logarithmische Skala.

Statistische Diagramme

Streudiagramm🔍
Streu: Strahlung (X) gegen Leistung (Y) – klarer linearer Zusammenhang. Streu kennt nur zwei Felder; weitere Serien werden ausgeblendet und sind beim Zurückwechseln wieder da.
Boxplot🔍
Boxplot: je Serie Quartile, Median und Ausreißer – praktisch zum Vergleichen mehrerer Anlagenteile.

3D: drei Größen und die Zeit – zum Selberdrehen

Die Streu-Grafik oben zeigt zwei Größen. Was aber, wenn eine dritte mitspielt? Der Typ 3D legt drei Nodes auf die Achsen X, Y und Z; jeder Messzeitpunkt wird ein Punkt im Raum, die Farbe ist die Zeit (dunkelviolett = Anfang des Fensters, gelb = Ende).

Unser Beispiel fragt: Wovon hängt der Ertrag der PV-Anlage ab – von der Sonne, von der Temperatur oder von beidem? X = Globalstrahlung (W/m²), Y = Außentemperatur (°C), Z = PV-Leistung (kW), Zeitfenster Mai und Juni 2025. Greif die Wolke und dreh sie:

Was das Drehen zeigtAus einem einzigen Blickwinkel täuscht jede 3D-Grafik. Erst beim Drehen merkst du, dass die Punkte keine Kugel bilden, sondern eine dünne, schräge Scheibe: Die Leistung steigt geradlinig mit der Strahlung (rund 600 kW bei 850 W/m²), quer dazu streut nur die Temperatur. Der gelbe Strich am Boden sind die Nächte – Strahlung 0, Leistung 0, bei jeder Temperatur. Die weiße Raute ist der Punkt am Locator: Ziehst du den Locator in der Zeitleiste, wandert sie durch die Wolke.
3D-Chart in der Oberfläche🔍
Dasselbe Chart in der Oberfläche: oben die drei Ablagefelder X, Y, Z mit Node, Einheit, Wert am Locator und Stufe; darunter die Szene. Die Bildfolge oben stammt aus genau diesem Chart.

So baust und bedienst du ein 3D-Chart

Typ „3D“ wählenDie ersten drei Serien belegen X, Y, Z. Weitere werden ausgeblendet und sind in 2D wieder da.
Nodes auf die Felder ziehenEin Node je Feld; Ablegen ersetzt die Serie. Gezeichnet wird erst, wenn alle drei belegt sind.
DrehenZiehen mit der Maus dreht, Strg+Mausrad zoomt, Doppelklick setzt die Kamera zurück.
Punkt ablesenDer Tooltip nennt Zeit sowie X-, Y- und Z-Wert des Punkts.
3D-Optionen🔍
Optionen „3D“: Darstellung Punkte oder Linie, Punktgröße (1–12) und Farbskala (Viridis, Plasma, Cividis, Turbo, Jet, Hot, Bluered, Greys).
3D als Linie🔍
Als Linie in Zeitreihenfolge (Farbskala Turbo, hier eine Novemberwoche): Du siehst die Bahn, auf der das System von Tag zu Tag wandert.
Wann 3D, wann Blasen?Blasen: dritte Größe als Fläche, flach und gut lesbar – ideal für Berichte. 3D: dritte Größe als Raumachse plus Zeit als Farbe – ideal zum Erkunden.

Der Serien-Dialog

Ein Klick auf einen Namen in der Legende (bei 3D: im Feld) öffnet den Dialog zur Serie: Anzeigename (Standard der Node-Name, bis 60 Zeichen), Farbe aus einer festen Palette, Y-Achse links/rechts, bei numerischen Nodes die Anzeigeeinheit (siehe Kapitel 10) und Serie entfernen. Eine eigene Einheit lädt nur diese Serie neu.

Spektrum: Frequenzen statt Zeit

Der Typ Spektrum rechnet aus einem Rohsignal (z. B. Schwingung mit 1 kHz) über den Analysedienst ein Leistungsspektrum in dB. Das Spektrum mittelt über das ganze Zeitfenster; mit „am Locator“ rechnet es nur ab dem Locator. Peaks verraten wiederkehrende Anregungen – im Beispiel unten das Fenster „Vorlauf Lagerschaden Verdichter 1“ (Juni–August 2024).

Spektrum🔍
Spektrum aus 183 Frames: scharfe Spitzen über dem Rauschteppich zwischen 0 und 500 Hz.

Spektrogramm: das Spektrum über die Zeit („Wasserfall“)

Das Spektrum mittelt über das ganze Fenster. Willst du sehen, wann eine Frequenz auftaucht oder wandert, wählst du in den Optionen des Spektrum-Charts die Ansicht Spektrogramm:

So liest du es: Die Zeit läuft waagerecht, die Frequenz senkrecht, die Farbe ist der Pegel in dB (Standard Viridis: dunkel = leise, gelb = laut). Eine waagerechte helle Linie ist eine Frequenz, die dauernd da ist; setzt sie plötzlich ein oder wandert sie, siehst du den Zeitpunkt direkt. Das Spektrogramm zeigt genau eine Serie; live wachsen neue Spalten am rechten Rand an.

Spektrogramm-Ansicht🔍
Die Spektrogramm-Ansicht „Verdichter 1 – Spektrogramm“ im Fenster „Störfall Kälteanlage August 2024“: Zeitachse unten (15.08. – 19.08.), Farbskala von 0 bis −100 dB rechts, Fußzeile „3 Kacheln, Stufe 11 (Server)“. Hinweis zum Bild: Im Testsystem lieferte der Analysedienst für dieses Fenster keine Kacheln, deshalb bleibt die Fläche leer. Bei einem funktionierenden Analysedienst füllt sie sich mit farbigen Spalten wie oben beschrieben.
Wenn die Fläche leer bleibtPrüfe im Systemzustand, ob der Dienst „Analyse“ läuft, und ob im Zeitfenster überhaupt Rohdaten liegen (Spektren brauchen genügend Samples je Frame).
PrognoseDer Knopf „Prognose …“ rechnet mit einem Zeitreihenmodell einen Verlauf voraus (nur bei aktivierter KI-Analyse im Tenant, Kapitel 3) und kann ihn in Nodes schreiben.
13

Zum Tenant „Brauerei Schädelbräu“ wechseln

Was LooT mit einer richtigen Anlage kann.

Wechsle über das LooT-Logo oben links zurück zur Tenant-Auswahl und wähle dort „Brauerei Schädelbräu“. Die Brauerei hat rund 355 Mio. Werte seit 2023, etwa 250 Nodes, Skripte, Workflows, 18 gespeicherte Charts und 4 Dashboards.

Tenant Brauerei🔍
Startseite des Tenants „Brauerei Schädelbräu“; Wurzel ist „Werk Hopfenthal“.

Dashboards

Aus der Leitwarte wird ein Blick auf die ganze Anlage: Zeiger-Instrumente für Strombezug und Glykol-Vorlauf, Ampeln für Störungen, ein Mini-Chart der Gärtanks, eine Karte mit dem Lieferwagen und Bedienelemente (Sollwert-Schieber, Freigabe-Schalter, „Notstopp“).

Leitwarte🔍
Dashboard „Leitwarte Werk Hopfenthal“ (18 Steuerelemente, Modus „Bedienen“).
Kälteanlage🔍
Kälteanlage: Schwingung und Lagertemperatur des Verdichters, Betriebsstunden (14.250 h), Glykolkreis.
Gärkeller🔍
Gärkeller: 16 Gärtanks als Füllbalken mit Temperatur (hier zwischen −1 °C und 12 °C), dazu Sollwert, Charge und Programm.
Mehrere SchreiberSteuert dasselbe Ziel mehr als ein Element (z. B. Sollwert-Eingabe und Programm-Auswahl), blendet das Dashboard einen orangen Hinweis ein. Es ist gewollt – du siehst, dass dort zwei Wege schreiben.
Zusammenhang: Dashboard ↔ Nodes ↔ RechteEin Dashboard speichert selbst keine Daten. Jedes Element ist an einen Node gebunden: Anzeigen lesen ihn (Recht R), Schieber und Schalter schreiben hinein (Recht W), Taster lösen ein Kommando aus (Recht X). Ohne das passende Recht lässt sich ein Element nicht bedienen.

Dashboards selbst bauen: der Modus „Bearbeiten“

Oben im Dashboard schaltest du zwischen Bedienen und Bearbeiten. Im Bearbeiten-Modus erscheint der Knopf + Steuerelement, jedes Element hat einen Rahmen mit Griffen zum Verschieben und Vergrößern, rechts oben seinen Typ und unten die Bindung – hier der Pin in ← Wirkleistung (Eingang aus diesem Node) oder out → Freigabe Abfüllung (Ausgang schreibt in diesen Node).

Dashboard bearbeiten🔍
Die Leitwarte im Bearbeiten-Modus. Zu sehen sind die Typen Beschriftung, Gauge, LED, Ampel, Alter, Trend, Karte, Textanzeige, Zahlenanzeige, Sparkline, Schieberegler, Schalter, Taster.
Nachschlagen: alle Steuerelemente
SteuerelementZweckRichtung
Gauge, Zahlenanzeige, Textanzeige, Sparkline, TrendZeigen Zahlen, Texte und kurze Verläufenur Anzeige (in ←)
LED, AmpelZustandsanzeigen: Farben statt Zahlen (z. B. „OK“, Schwingung als Ampel)nur Anzeige
AlterWie alt ist der letzte Wert? („vor 14 h · veraltet“)nur Anzeige
KartePosition eines Geo-Nodesnur Anzeige
Schieberegler, SchalterZahl bzw. Bool in einen Node schreibenschreibt (out →)
TasterLöst ein Kommando aus (z. B. „Notstopp“); die Ablaufzeit lässt sich einstellenschreibt (out →)
BeschriftungÜberschriften und Text zur Gliederung–

Charts in der Praxis: die Galerie

Eine Auswahl der gespeicherten Brauerei-Charts; die Typen selbst erklärt Kapitel 12. Filtere die Beispiele:

Nodes im Detail: Historie, Statistik, Kommandos, Verbindungen

Eine Node-Seite (siehe Kapitel 9) zeigt oben den letzten Wert und den Verlauf. Darunter liegen aufklappbare Abschnitte:

Historie und Statistik🔍
Historie: Tabelle der letzten Werte mit Zeitstempel (Sekundentakt) und Wert in der Anzeigeeinheit. Statistik (rechts in den Eigenschaften, mit „Statistik aktualisieren“) fasst den Node samt Unterknoten zusammen – bei vielen Werten kann das etwas dauern.
Kommandos und Verbindungen🔍
Kommandos „Linie starten“, „Linie stoppen“ (mit Parameter „Grund“, Pflicht) und „Notstopp“ als Knöpfe samt Verlauf der ausgelösten Kommandos (90 Tage sichtbar). Verbindungen: der Alarm der Kälteanlage löst den Notstopp der Abfüllung aus.
AbschnittWas er kann
KommandosBenannte Aktionen mit typisierten Parametern (Pflicht, Standardwert, Minimum/Maximum, erlaubte Werte). Mit dem Recht Execute löst du sie per Knopf aus; ein Gerät führt sie aus und meldet Erfolg oder Fehler zurück, der Status erscheint live. „Kommando definieren“ legt neue an, der Stift ändert, der Papierkorb löscht.
Nach außen gezeigte WerteStrukturknoten ohne eigene Zeitreihe zeigen hier stellvertretend Werte ihrer Nachfahren.
VerbindungenTabelle Quelle (Ausgang) → Ziel (Eingang) mit Umwandlung (z. B. „keine“) und Geltungsbereich. So fließen Werte oder Alarme automatisch von einem Node zum anderen – hier vom Alarm der Kälteanlage zum Kommando „Notstopp“ der Linie 1.
HistorieDie letzten Werte als Tabelle; mit „Locator hierher setzen“ je Zeile.
Eigenschaften nutzenRechts siehst du außerdem Aliase (z. B. „P-Netz“ für die Wirkleistung – damit findet die Suche den Node auch unter dem Zweitnamen) und Tags (Energie, Massendaten). Beide kannst du im Text oder hier ergänzen.

Komponenten: Rechnen im System

Die Ansicht „Komponenten“ (Kapitel 5) zeigt die Bausteine; ein Klick öffnet sie als Tab mit den Reitern Übersicht, Quelltext, Ports, Versionen, Ausprobieren, In Betrieb, Rechte. Das Beispiel „Füllhöhe-prüfen“ ist ein Python-Skript im reaktiven Modus: Es meldet einen Alarm, wenn die Füllhöhe der Flaschen das Toleranzband verlässt.

Skript Füllhöhe prüfen🔍
Quelltext-Reiter: Kopf mit # loot:input value float …, # loot:input min float default=61.2, # loot:input max float default=62.8 und # loot:output alarm bool nullable, darunter die Funktion run(ctx). Unten: „Ausprobieren“ und „Als neue Version speichern“.
  • Die Ports (Ein- und Ausgänge) deklariert der Skriptkopf; im Workflow bindest du sie an Nodes.
  • Gespeichert wird als neue Version (die jüngste ist hier 1.0.0); der Reiter „Ausprobieren“ dient zum Testen des Skripts.
  • Skripte gibt es in Python, TypeScript und C#; neue Skripte anzulegen braucht am Tenant das Recht S.

Editor und Workflows

Der Editor zeigt eine Ebene des Baums als Diagramm: jeder Node eine Box mit seinen Kindern als Ports mit aktuellen Werten, Verbindungen als Linien. Ein Doppelklick legt einen Node an, Ports zieht man aufeinander, um zu verbinden (Entf löscht die gewählte Verbindung).

Editor🔍
Editor der Ebene „Kälteanlage“: Boxen „Verdichter 1“, „Verdichter 2“ mit Ports und Werten (z. B. Lagertemperatur 49,86 °C).
Workflow🔍
Workflow der Abfüllung: Skripte „Füllhöhe prüfen“ und „Ausstoß Linie 1 in hl“ zwischen Nodes und dem Dashboard.
MerkeDashboards bedienen, Charts auswerten, Editor/Workflows verknüpfen, Komponenten rechnen.
14

Der Systemzustand

Ist LooT gesund? Statusleiste → „Systemzustand“.

Jeder Messwert nimmt denselben Weg. Die Seite „Systemzustand“ zeigt ihn als Kette von Kacheln – hier das Prinzip:

Gerätesenden Werte Ingestprüft Rechte, Einheit NATSPuffer Writerspeichert PostgresZeitreihen Query Web-App grün: schreibenblau: lesen
Systemzustand
  • 1
    Kopfzeile„Live“ und Zeitstempel; Chips: 9 online, aktueller Durchsatz in Werten/s, 2 Warnungen.
  • 2
    ProblemeWarnungen im Klartext mit Empfehlung. Aktuell: Von zwei Docker-Containern der Modell-Downloads kommen keine Kennzahlen mehr an („Sammler liefert seit … nichts mehr“).
  • 3
    DatenwegDie Kette aus dem Schaubild als Kacheln; daneben Flow, Query, Web, Exchange, Analyse und Modelle. Jede Kachel zeigt Instanzen, CPU, Durchsatz und Rückstau.
  • 4
    AuslastungDie Kachel „Modelle“ (4 Instanzen) ist mit 102 % CPU voll ausgelastet und deshalb rot markiert.
  • 5
    DiensteFilterbare Liste aller Dienste mit Instanzen, Version, Speicher, GC-Heap, Threads und Warteschlangen.
Zusammenhang: warum ein Puffer?Ingest nimmt Werte an, so schnell sie kommen, und legt sie in NATS ab; der Writer speichert sie von dort. Stockt die Datenbank kurz, geht deshalb nichts verloren – der Rückstau wächst und baut sich wieder ab. Bleibt er klein (hier 0), ist die Kette gesund. Wächst er dauerhaft, kommen Werte schneller an, als sie gespeichert werden.

Testen, was du gelernt hast

1. Was bewirkt ein Haken bei „Admin“ in der Mitgliederliste?

2. Welche Aufbewahrungsklasse passt zu schnellen Rohdaten, die nur kurz gebraucht werden?

3. Was bedeuten die schraffierten Segmente im Band der Zeitleiste?

4. Du willst einen Sollwert aus einem Dashboard-Schieberegler schreiben lassen. Welche Rechte braucht der Benutzer mindestens am Node?

5. In der Textdefinition steht direction: reinraus. Was passiert beim Speichern?

6. Du stellst auf der Node-Seite die Anzeigeeinheit von kW auf W um. Was ändert sich in der Datenbank?

7. Was passiert, wenn du die Einheit eines Nodes mit Werten in den Eigenschaften von °C auf °F stellst und speicherst?

8. Im 3D-Chart ist nur eine Achse belegt. Was siehst du?

9. Du zoomst mit Strg+Mausrad in ein Chart. Was passiert mit den anderen Tabs?

10. Im 3D-Chart der PV-Anlage erscheinen die Punkte aus einem Blickwinkel als dünner Strich. Was heißt das?

Weiterführend: doc/entwicklung/Web-Oberflaeche.md, doc/entwicklung/CLI.md und doc/entwicklung/API-Ingest.md im Repository.