Veranstaltungen und Überwachung

Der Dienst überträgt Systemereignisse über einen dedizierten , schreibgeschützten WebSocket auf Port 10020. Die Ereignisse melden Sicherheitsauslöser, Geräteverbindungen, Akkuwarnungen, Änderungen im Lebenszyklus von Sitzungen und Anomalien bei der Überprüfungshäufigkeit.

Standard-URL: ws://localhost:10020

Struktur der JSON-Ereignisdaten

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

Champ	Typ	Beschreibung
name	String	Stabile Ereignis-ID (zur Filterung oder zum Failover)
category	String	device, session, system
level	String	info, notice, warning, error, critical, panic
data	Objekt	Veranstaltungsspezifische Nutzlast
message	String	Für Menschen lesbare Beschreibung

Veranstaltungsarten

Gerätebezogene Ereignisse

Nom	Niveau	Wann
device-connected	info	Ein neues Gerät wurde erkannt und ist einsatzbereit
device-disconnected	warning	Ein Gerät ist ausgefallen (vom Netz getrennt oder Zeitüberschreitung)
device-battery-low	warning	Kabellose VerseGrip-Batterie unter der Schwelle
device-battery-critical	error	Akku des kabellosen VerseGrip auf einem kritischen Niveau
device-sleep	info	Umschalten des kabellosen VerseGrip in den Standby-Modus
device-busy	warning	Das Gerät wird gerade von einer anderen Sitzung genutzt.
device-connection-loop	warning	An einem Port wurden wiederholte Verbindungsaufbau- und -abbauzyklen festgestellt

Sicherheitsvorfälle

Nom	Niveau	Wann
device-safety-triggered	Variable	Sicherheitshinweis der Firmware (siehe unten)
device-calibration-failed	warning	Die Kalibrierung von „Inkwell“ wurde ausgelöst, aber der Stift ist nicht einsatzbereit.

Untertypen von device-safety-triggered

Das Feld safety_type Die Daten des Vorfalls geben Aufschluss darüber, was geschehen ist:

safety_type	Niveau	Bedeutung
ebrake_triggered	error	Notbremse aktiviert – Gerät verriegelt
ebrake_released	notice	Notbremse gelöst
fod_stage_changed	warning / info	Die FOD-Sicherheitsstufe hat die Grenze zwischen geringem und hohem Risiko überschritten
stall_detected	warning	Motorversatz erkannt
stability_ceiling	warning	Stabilitätsgrenze erreicht

Gründe für device-calibration-failed

reason	Bedeutung
pen_not_connected	Es ist kein Verse-Grip angeschlossen
pen_asleep	Der kabellose Verse-Griff ist gekoppelt, befindet sich jedoch im Standby-Modus
pen_not_attached	Der Versus-Grip ist bereit, aber der Hall-Sensor liegt unterhalb des Schwellenwerts

Sitzungsveranstaltungen

Nom	Niveau	Wann
session-started	notice	Eine WebSocket-Sitzung wurde erstellt
session-stopped	notice	Eine WebSocket-Sitzung wurde geschlossen
device-low-control-rate	warning	Die Überprüfungshäufigkeit der Sitzung ist unter den empfohlenen Schwellenwert gefallen
device-critical-control-rate	error	Die Kontrollhäufigkeit ist auf ein kritisches Niveau gesunken

Systemereignisse

Nom	Niveau	Wann
system-rate-report	info	Regelmäßiger Bericht über die Frequenz der Zyklen der Hauptschleife

Die Ereignisse verfolgen

Nutzen Sie das Tutorial zu Ereignissen, um einen einsatzbereiten Python-Listener zu erhalten, der nach Pegel, Namensmustern und Ausschlüssen filtert:

# 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*"