事件と監視
本サービスは、ポート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 | Wireless Verse Grip はペアリング済みですが、スリープモードになっています |
pen_not_attached | バースグリップは準備完了ですが、ホールセンサーの値がしきい値を下回っています |
会話イベント
| 名称 | レベル | トリガーのタイミング |
|---|---|---|
session-started | notice | WebSocket セッションが作成されました |
session-stopped | notice | 1つの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*"