イベントと監視

このサービスは、ポート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	ストリング	人間が読み取れる説明文

イベントの種類

デバイスに関連するイベント

ノム	レベル	Quand
device-connected	info	新しいデバイスが検出され、使用可能な状態になりました
device-disconnected	warning	1台の機器が接続解除されたか、タイムアウトとなったため、接続が失われました
device-battery-low	warning	敷居の下に設置されたVerseGripコードレスバッテリー
device-battery-critical	error	VerseGrip コードレスバッテリーの残量が危険なレベルに達しています
device-sleep	info	ワイヤレスVerseGripのスタンバイモードへの移行
device-busy	warning	このデバイスは別のセッションで使用されています
device-connection-loop	warning	あるポートで接続と切断の繰り返しサイクルが検出されました

セキュリティインシデント

ノム	レベル	Quand
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	バーズグリップの準備は整っていますが、ホール効果センサーの値が閾値を下回っています

セッションのイベント

ノム	レベル	Quand
session-started	notice	WebSocketセッションが作成されました
session-stopped	notice	WebSocketセッションが閉じられました
device-low-control-rate	warning	セッションのチェック頻度が推奨値を下回りました
device-critical-control-rate	error	検査の頻度が危機的な水準まで低下した

システムイベント

ノム	レベル	Quand
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*"