事件与监控

该服务通过端口10020 上的专用只读 WebSocket发送系统事件。这些事件报告安全触发条件、设备连接、电池警告、会话生命周期变化以及速率异常。

标准网址： ws://localhost:10020

JSON 事件的结构

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

费尔德	Typ	描述
name	字符串	稳定的事件标识符（用于过滤或切换）
category	字符串	device, session, system
level	字符串	info, notice, warning, error, critical, panic
data	反对	特定事件有效载荷
message	字符串	可读描述

事件类型

设备事件

名称	级别	Wann
device-connected	info	已检测到一台新设备，且该设备已准备就绪
device-disconnected	warning	有一台设备已丢失（已断开连接或超时）
device-battery-low	warning	无线VerseGrip的电量低于阈值
device-battery-critical	error	VerseGrip 无线设备的电量已降至危险低位
device-sleep	info	VerseGrip（kabellos）已进入待机模式
device-busy	warning	该设备正在被另一个会话使用
device-connection-loop	warning	检测到某个端口上出现反复的连接和断开循环

安全事件

名称	级别	Wann
device-safety-triggered	因情况而异	固件安全公告（见下文）
device-calibration-failed	warning	已触发墨水壶的校准，但笔无法使用

的亚型 device-safety-triggered

那片田野 safety_type 事件数据中说明了发生了什么：

safety_type	级别	含义
ebrake_triggered	error	紧急制动已触发 — 设备已锁定
ebrake_released	notice	手刹已松开
fod_stage_changed	warning / info	FOD安全等级已超过低风险与高风险之间的临界点
stall_detected	warning	检测到运动阻滞
stability_ceiling	warning	已达到稳定性上限

原因包括 device-calibration-failed

reason	含义
pen_not_connected	根本没有连接任何Verse Grip
pen_asleep	无线 Verse Grip 已配对，但处于待机模式
pen_not_attached	Verse Grip 已准备就绪，但霍尔传感器的读数低于阈值

会议事件

名称	级别	Wann
session-started	notice	已建立一个 WebSocket 会话
session-stopped	notice	一个 WebSocket 会话已结束
device-low-control-rate	warning	该会议的税率已降至推荐阈值以下
device-critical-control-rate	error	税率已降至临界值

系统事件

名称	级别	Wann
system-rate-report	info	关于主循环时钟频率的定期报告

监听事件

请参考“事件”教程，创建一个可立即运行的 Python 监听器，该监听器支持按级别、名称模式和排除项进行过滤：

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