本文へスキップ
バージョン：3.4.x

イベントチャンネル

デフォルトのイベントウェブソケットURLは ws://localhost:10020.注：ポートはコンフィギュレーションで変更できる。

これは低周波の単方向通信チャンネルで、すべてのシステム・イベントを受信することができます。 入力メッセージはサポートされていません。

このチャンネルは、イベントごとに1つのメッセージを送信することを保証する。

正規フォーマット​

すべてのイベントは以下のような標準的な構成になっている：

{
  "name": "device-connected",
  "category": "device",
  "level": "notice",
  "data": {},
  "message": ""
}

フィールドの説明​

フィールドタイプ説明
namestringイベントの一意識別子。
categorystringフィルタリングや整理に使用されるグループ化ラベル（有効なカテゴリーを参照）。
levelstringイベントの重大性または重要性（有効レベルを参照）。
dataobjectイベント固有の詳細を含むペイロード。
messagestringオプションで、イベントの人間が読める説明またはコンテキスト。

イベントカテゴリー​

について category フィールドはイベントを以下のグループに分類している：

価値説明
systemコアシステムやセントラルシステム、グローバル設定など。
input外部入力処理（コマンドなど）。
session特定のユーザーセッションに関連するイベント。
deviceデバイス管理、コントローラとの相互作用、シリアルポート通信。
moduleサブシステムまたはモジュラーコンポーネントのイベント。
feature特定のサービスの特徴や機能に関連したイベント。

イベントレベル​

イベント level フィールドはイベントの重要度を示す：

価値説明
info情報提供のみ - ログ、メトリクス、または重要でない通知。
notice州の変化や注目すべき出来事
warning何かが間違っている、あるいは外れているように見えるが、システムは安全に継続できる。
errorシステムの動作や安定性に影響を及ぼす可能性のある問題が発生しました。
criticalシステムの機能を著しく停止させる重大なエラー。
panic致命的な故障 - クラッシュや回復不可能な状態に陥る可能性がある。

イベント​

インフォメーション

このリストは、現在システムによって報告されているイベントのリストです。私たちは積極的にイベントの種類と報告を設計し、拡張しています。

インプット​

invalid-io-channel​

I/Oチャンネルがサポートされていない、または意図されていない方法で使用された場合にトリガーされる。

データ

フィールドタイプ説明
received_datastring受信した生データ。
{
  "name": "invalid-io-channel",
  "category": "input",
  "level": "warning",
  "data": {
    "received_data": "<raw_input_here>"
  }
}

command-deprecated​

入力コマンドが非推奨であり、将来のバージョンで削除される場合に発行される。

フィールドタイプ説明
commandstring受信した非推奨コマンド

{
  "name": "command-deprecated",
  "category": "input",
  "level": "warning",
  "data": {
    "command": "example_cmd"
  },
  "message": "The command `example_cmd` is deprecated and is replaced by `this_one`."
}

装置​

device-connected​

デバイスが接続され、完全に動作可能になったことを示す。

フィールドタイプ説明
device_familystringデバイスのタイプ inverse または verse_grip.
device_idstringデバイス固有の識別子。
{
  "name": "device-connected",
  "category": "device",
  "level": "notice",
  "data": {
    "device_family": "inverse",
    "device_id": "04BA"
  }
}

device-disconnected​

以前接続されていたデバイスが切断されたことを示す。

フィールドタイプ説明
device_familystringデバイスのタイプ inverse または verse_grip.
device_idstringデバイス固有の識別子。
{
  "name": "device-disconnected",
  "category": "device",
  "level": "notice",
  "data": {
    "device_family": "verse_grip",
    "device_id": "61548"
  }
}