Einen Stand wiederfinden
Pro Topic und Subject liegt eine vollständige Observation mit den ursprünglichen Bytes. Epoch, Revision, Speicherzeit und SHA-256 stehen daneben und verändern den Inhalt nicht.
Clever Engines Layer · Bausteine und Möglichkeiten
CEL Live
Hält unveränderte Beobachtungen und einen begrenzten Ereignisstrom im Arbeitsspeicher.
Aufgabe
Live bewahrt das, was ein Teilnehmer tatsächlich beobachtet hat. Es interpretiert keine Messwerte und ergänzt keine fehlenden Felder. Dadurch lässt sich eine Anzeige auf genau eine Beobachtung zurückführen.
Möglichkeiten
Ereignisse verfolgen
Ein begrenzter Ring hält Meldungen je Teilnehmer. Wiederholte Event-IDs mit gleichem Inhalt sind idempotent; ein anderer Inhalt unter derselben ID ist ein Konflikt.
Gezielt zurücksetzen
State und Ereignisse können einzeln oder gemeinsam zurückgesetzt werden. Der gemeinsame Reset besitzt eine ID, damit eine Wiederholung denselben Auftrag erkennt.
Zusammenspiel
Controls schreibt und liest über den lokalen HTTP-Vertrag. Ein Topic fasst zusammengehörige Beobachtungen zusammen; das Subject identifiziert den einzelnen Teilnehmer. Die Oberfläche bezieht ihren Stand über Controls, nicht durch einen zweiten direkten Zugriff auf Live.
Bei jedem Live-Neustart beginnt eine neue Epoch. Es gibt keine Wiederherstellung alter Beobachtungen von der Platte. Innerhalb einer Epoch steigt die Revision auch über einen Reset hinweg weiter.
Technik
| Standardadresse | 127.0.0.1:19091 |
|---|---|
| Windows-Dienst | CELLiveObjectCacheObservation |
| Programm | bin/cel_live_1.0.11.exe nach lokalem Go-Build |
| State | PUT / GET / DELETE /v2/state/{topic}/{subject} |
| Sammelabruf | GET /v2/state/{topic}; Subjects stabil sortiert |
| Ereignisse | POST / GET / DELETE /v2/events/{topic}/{subject} |
| Reset | POST /v2/reset/{topic}/{subject} mit reset_id; State und Ereignisse unter einem Lock |
| Grenze je Body | Standard 524288 Byte; konfigurierbarer Bereich 128 KiB bis 4 MiB |
| Ereignisring | 50 Einträge je Subject, neuester zuerst |
| Zeit | RFC3339 mit UTC-Offset; Z und +00:00 werden akzeptiert |
| Konsistenz | stored_at_utc, revision, epoch, payload_sha256 außerhalb der Nutzdaten |
Zustände und Betriebsgrenzen
Eine erreichbare Live-Instanz kann nach einem Neustart leer sein. OBSERVATION_NOT_AVAILABLE beschreibt dann den fehlenden Beobachtungsstand, nicht zwangsläufig einen abgestürzten Prozess. Der nächste erfolgreiche Controls-Poll liefert eine neue vollständige Beobachtung.
Bei einem Paketaustausch bleiben die lokalen Bestände getrennt vom Quell- und Programmstand erhalten: config/, logs/.
Werkzeuge
Alle BAT- und PowerShell-Dateien dieses Pakets, einschließlich der internen Aufrufwege. Die Wirkung unterscheidet reine Abfragen, lokale Prüfungen und Eingriffe. Web-Abfragen sind davon getrennt.
Paketwurzel · 8 Werkzeuge
| Name | Zweck | Aufruf, Ausgabe und Wirkung |
|---|---|---|
build_all.batBuild | Prüft den Quellstand und baut die Komponenten des Pakets. | Buildphasen, Zielpfade und Compiler-/Prüfergebnis; bei Fehlern kein erfolgreicher Abschluss. Wirkung: schreibt BuildausgabenAufrufweg:verify_service.bat |
install_service.batBetrieb | Registriert den Windows-Dienst oder aktualisiert seinen Programmpfad. | Aktions- und Fehlerausgabe; Start/Kopieren ist vom anschließenden Health-Nachweis zu unterscheiden. Wirkung: verändert Zustand |
run_console.batBetrieb | Startet den Paketprozess im Vordergrund; seine Ausgabe bleibt in der Konsole. | Konsolenausgabe des Werkzeugs; Fehler über Exitcode oder benannte Fehlerzeilen. Wirkung: liestAufrufweg:build_all.bat |
start_service.batBetrieb | Startet den bereits registrierten Windows-Dienst. | Aktions- und Fehlerausgabe; Start/Kopieren ist vom anschließenden Health-Nachweis zu unterscheiden. Wirkung: verändert Zustand |
status_service.batDiagnose | Liest Windows-Dienststatus und den lokalen Health-Endpunkt. | Status-, Identitäts- oder Messfelder; ein Fehler bzw. Timeout bleibt als solcher sichtbar. Wirkung: liest |
stop_service.batBetrieb | Fordert das Stoppen des Windows-Dienstes an. | Aktions- und Fehlerausgabe; Start/Kopieren ist vom anschließenden Health-Nachweis zu unterscheiden. Wirkung: verändert Zustand |
uninstall_service.batBetrieb | Stoppt den Windows-Dienst und entfernt seine Registrierung. | Aktions- und Fehlerausgabe; Start/Kopieren ist vom anschließenden Health-Nachweis zu unterscheiden. Wirkung: verändert Zustand |
verify_service.batDiagnose | Prüft Existenz, Dienstregistrierung und Health von CEL Live, ohne den Dienst neu zu starten. | Windows-Dienststatus und Health-JSON; Exit 0 bei erfolgreicher Prüfung, sonst 1/2. Wirkung: liest |
History
Unveränderte Beobachtung
Feldmischungen und parallele Messwertkopien wurden durch einen Rohbyte-Vertrag ersetzt.
Getrennte Ereignisse
Ereignisse erhielten stabile IDs und einen eigenen, begrenzten Ring.
Eindeutige Neustart- und Reset-Semantik
Epoch, Revision und Reset-ID trennen einen neuen Dienstlauf von einem fachlichen Reset.