이벤트 및 모니터링

이 서비스는 포트 10020의전용 읽기 전용 WebSocket을통해 시스템 이벤트를 전송합니다. 이벤트에는 안전 트리거, 장치 연결, 배터리 경고, 세션 수명 주기 변경, 제어 주기 이상 등이 포함됩니다.

기본 URL: 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"
}

필드	유형	설명
name	문자열	안정적인 이벤트 식별자 (필터링 및 전환에 사용)
category	문자열	device, session, system
level	문자열	info, notice, warning, error, critical, panic
data	객체	이벤트별 페이로드
message	문자열	사람이 읽을 수 있는 설명

이벤트 유형

장치 이벤트

이름	수준	발생 시점
device-connected	info	새 장치가 감지되어 사용할 준비가 되었을 때
device-disconnected	warning	장치 연결이 끊겼을 때 (분리되었거나 시간 초과됨)
device-battery-low	warning	무선 VerseGrip 배터리의 잔량이 임계값 이하로 떨어졌을 때
device-battery-critical	error	무선 VerseGrip 배터리가 위험할 정도로 부족할 때
device-sleep	info	무선 VerseGrip이 절전 모드로 전환되었을 때
device-busy	warning	장치가 다른 세션에서 사용 중인 경우
device-connection-loop	warning	포트에서 연결 및 연결 해제가 반복적으로 감지되었을 때

안전 행사

이름	수준	발생 시점
device-safety-triggered	상황에 따라 다름	펌웨어에서 전송된 안전 알림 (아래 참조)
device-calibration-failed	warning	Inkwell 보정이 실행되었지만 펜을 사용할 수 없는 경우

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	무선 버즈 그립이 페어링되어 있지만 절전 모드 상태입니다.
pen_not_attached	버스 그립은 준비되었으나 홀 센서 값이 임계값 미만입니다.

세션 이벤트

이름	수준	발생 시점
session-started	notice	WebSocket 세션이 생성되었습니다.
session-stopped	notice	WebSocket 세션이 삭제되었습니다.
device-low-control-rate	warning	세션의 제어 주기가 권장 임계값 아래로 떨어졌습니다.
device-critical-control-rate	error	제어 주기가 위험 수준까지 떨어짐

시스템 이벤트

이름	수준	발생 시점
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*"