이벤트 및 모니터링
이 서비스는 포트 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 | 문자열 | 읽기 쉬운 설명 |
이벤트 유형
기기 이벤트
| 이름 | 레벨 | 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
Das Feld 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 | 세션의 세율(Steuerrate)이 권장 기준치 아래로 떨어졌습니다. |
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*"