사건과 감시
이 서비스는전용 읽기 전용 WebSocket을 통해 포트 10020에서 시스템 이벤트를 푸시합니다. 이벤트에는 보안 트리거, 장치 연결, 배터리 경고, 세션 수명 주기 변경 및 제어 속도 이상 등이 포함됩니다.
기본 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 | Wireless Verse Grip이 페어링되었으나 절전 모드에 있습니다. |
pen_not_attached | Verse Grip은 준비되었으나, 홀 센서 값이 임계값보다 낮습니다. |
대화 이벤트
| 명칭 | 레벨 | 발동 조건 |
|---|---|---|
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*"