Veranstaltungen & Überwachung

Der Dienst überträgt Systemereignisse über einen dedizierten, schreibgeschützten WebSocket auf Port 10020. Die Ereignisse umfassen Sicherheitsauslöser, Geräteverbindungen, Akkuwarnungen, Änderungen im Sitzungslebenszyklus und Anomalien bei der Steuerungsrate.

Standard-URL: ws://localhost:10020

Struktur der Ereignis-JSON-Daten

{
  "name": "device-safety-triggered",
  "category": "device",
  "level": "warning",
  "data": { "device_family": "inverse", "device_id": "049D", … },
  "message": "FOD stage changed: guard -> hard"
}

Feld	Typ	Beschreibung
name	String	Stabile Ereignis-ID (zum Filtern/Umschalten verwenden)
category	String	device, session, system
level	String	info, notice, warning, error, critical, panic
data	Objekt	Ereignisspezifische Nutzlast
message	String	Für Menschen lesbare Beschreibung

Veranstaltungstypen

Geräteereignisse

Name	Stufe	Wenn
device-connected	info	Ein neues Gerät wurde erkannt und ist betriebsbereit
device-disconnected	warning	Ein Gerät ist ausgefallen (vom Stromnetz getrennt oder die Zeitüberschreitung ist abgelaufen)
device-battery-low	warning	Akku des kabellosen VerseGrip unterhalb des Schwellenwerts
device-battery-critical	error	Der Akku ist fast leer
device-sleep	info	Der kabellose VerseGrip ist in den Ruhemodus gewechselt
device-busy	warning	Das Gerät wird gerade von einer anderen Sitzung verwendet
device-connection-loop	warning	An einem Port wurden wiederholte Verbindungsaufbau- und -abbruchzyklen festgestellt

Sicherheitsvorfälle

Name	Stufe	Wenn
device-safety-triggered	variiert	Sicherheitshinweis aus der Firmware (siehe unten)
device-calibration-failed	warning	Die Kalibrierung des Tintenbehälters wurde ausgelöst, aber der Stift ist nicht einsatzbereit

device-safety-triggered Untertypen

Die safety_type Das Feld in den Ereignisdaten gibt Aufschluss darüber, was passiert ist:

safety_type	Stufe	Bedeutung
ebrake_triggered	error	Notbremse betätigt – Vorrichtung verriegelt
ebrake_released	notice	Notbremse gelöst
fod_stage_changed	warning / info	Die FOD-Sicherheitsstufe hat die Grenze zwischen niedrigem und hohem Risiko überschritten
stall_detected	warning	Motorstillstand erkannt
stability_ceiling	warning	Die Obergrenze der Stabilität ist erreicht

device-calibration-failed Gründe

reason	Bedeutung
pen_not_connected	Es ist überhaupt kein Versgriff angeschlossen
pen_asleep	Der kabellose Verse-Griff ist gekoppelt, befindet sich jedoch im Ruhemodus
pen_not_attached	Der Vers-Griff ist bereit, aber der Hall-Sensor liegt unterhalb des Schwellenwerts

Sitzungsereignisse

Name	Stufe	Wenn
session-started	notice	Es wurde eine WebSocket-Sitzung erstellt
session-stopped	notice	Eine WebSocket-Sitzung wurde beendet
device-low-control-rate	warning	Die Kontrollrate der Sitzung ist unter den empfohlenen Schwellenwert gefallen
device-critical-control-rate	error	Die Kontrollrate ist auf ein kritisches Niveau gesunken

Systemereignisse

Name	Stufe	Wenn
system-rate-report	info	Regelmäßiger Bericht zur Taktfrequenz der Hauptschleife

Ereignissen lauschen

Nutzen Sie das Tutorial zu „Events“, um einen sofort einsatzbereiten Python-Listener mit Filterung nach Pegel, Namensmustern und Ausschlüssen zu erhalten:

# All events
python 10-haply-inverse-events.py

# Only warnings and above
python 10-haply-inverse-events.py --level warning

# Only device events
python 10-haply-inverse-events.py --name "device-*"

# Exclude battery noise
python 10-haply-inverse-events.py --exclude "*battery*"