イベントおよびモニタリング

本サービスは、ポート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`	バースグリップがまったく接続されていない
`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*"

イベントのJSON形式​

イベントの種類​

デバイスイベント​

安全イベント​

device-safety-triggered サブタイプ​

device-calibration-failed 理由​

セッションイベント​

システムイベント​

イベントの受信​