이벤트 채널
기본 이벤트 웹소켓 URL은 ws://localhost:10020.
설정에서 포트를 변경할 수 있습니다.
모든 시스템 이벤트를 수신할 수 있는 저주파 단방향 통신 채널입니다. 입력 메시지는 지원되지 않습니다.
이 채널은 각 이벤트에 대해 하나의 메시지를 보내도록 보장합니다.
표준 형식
모든 이벤트는 아래와 같은 표준 구조를 따릅니다:
{
"name": "device-connected",
"category": "device",
"level": "notice",
"data": {},
"message": ""
}
필드 설명
| 필드 | 유형 | 설명 |
|---|---|---|
name | string | 이벤트의 고유 식별자입니다. |
category | string | 필터링 및 구성에 사용되는 그룹화 레이블입니다(유효한 카테고리 참조). |
level | string | 이벤트의 심각도 또는 중요도(유효한 수준 참조). |
data | object | 이벤트별 세부 정보가 포함된 페이로드입니다. |
message | string | 이벤트에 대한 사람이 읽을 수 있는 설명 또는 컨텍스트(선택 사항)입니다. |
이벤트 카테고리
그리고 category 필드는 이벤트를 다음과 같은 그룹으로 구성합니다:
| 가치 | 설명 |
|---|---|
system | 코어 또는 중앙 시스템, 전역 설정 등 |
input | 외부 입력 처리(예: 명령어 또는 기타). |
session | 특정 사용자 세션과 관련된 이벤트. |
device | 장치 관리, 컨트롤러 상호 작용, 직렬 포트 통신. |
module | 서브시스템 또는 모듈형 컴포넌트 이벤트. |
feature | 특정 서비스 기능 또는 기능에 연결된 이벤트. |
이벤트 레벨
이벤트 level 필드는 이벤트의 심각도 또는 중요성을 나타냅니다:
| 가치 | 설명 |
|---|---|
info | 정보 제공 전용 - 로그, 메트릭 또는 중요하지 않은 알림. |
notice | 상태 변경 또는 주목할 만한 이벤트. |
warning | 무언가 잘못되었거나 문제가 발생했지만 시스템이 안전하게 계속 작동할 수 있습니다. |
error | 시스템 동작 또는 안정성에 영향을 줄 수 있는 문제가 발생했습니다. |
critical | 시스템 기능을 심각하게 방해하는 심각한 오류입니다. |
panic | 치명적인 장애 - 충돌 또는 복구 불가능한 상태로 이어질 수 있습니다. |
이벤트
정보
이 목록은 현재 시스템에서 보고되는 이벤트의 현재 목록입니다. 저희는 이벤트 유형과 보고를 적극적으로 설계하고 확장하고 있습니다.
입력
invalid-io-channel
I/O 채널이 지원되지 않거나 의도하지 않은 방식으로 사용될 때 트리거됩니다.
데이터
| 필드 | 유형 | 설명 |
|---|---|---|
received_data | string | 수신된 원시 데이터입니다. |
{
"name": "invalid-io-channel",
"category": "input",
"level": "warning",
"data": {
"received_data": "<raw_input_here>"
}
}
http-route-deprecated
HTTP 경로가 더 이상 사용되지 않으며 향후 버전에서 제거될 예정일 때 표시됩니다.
데이터
| 필드 | 유형 | 설명 |
|---|---|---|
route | string | 더 이상 사용되지 않는 경로. |
substitute | string | 권장 대체품. |
{
"name": "http-route-deprecated",
"category": "input",
"level": "warning",
"data": {
"route": "/the/old/way",
"substitute": "/the/new/way"
}
}
settings-invalid-key
설정 키가 유효하지 않을 때 발생합니다.
데이터
| 필드 | 유형 | 설명 |
|---|---|---|
key | string | 찾지 못한 열쇠. |
{
"name": "settings-invalid-key",
"category": "input",
"level": "warning",
"data": {
"key": "devices/none-existent/key"
}
}
command-deprecated
수신 명령이 더 이상 사용되지 않으며 향후 버전에서 제거될 때 발생합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
command | string | 수신된 더 이상 사용되지 않는 명령 |
{
"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_family | string | 장치 유형: inverse 또는 verse_grip. |
device_id | string | 디바이스의 고유 식별자입니다. |
{
"name": "device-connected",
"category": "device",
"level": "notice",
"data": {
"device_family": "inverse",
"device_id": "04BA"
}
}
device-disconnected
이전에 연결되었던 디바이스의 연결이 끊어졌음을 나타냅니다.
| 필드 | 유형 | 설명 |
|---|---|---|
device_family | string | 장치 유형: inverse 또는 verse_grip. |
device_id | string | 디바이스의 고유 식별자입니다. |
{
"name": "device-disconnected",
"category": "device",
"level": "notice",
"data": {
"device_family": "verse_grip",
"device_id": "61548"
}
}
세션
device-low-control-rate
장치의 수신 직접 제어 명령이 너무 낮은 속도에 도달하여 안전 한계치에 도달했을 때 발생합니다. 이는 속도가 차단 속도에 근접하고 있음을 알리는 경고입니다.
| 필드 | 유형 | 설명 |
|---|---|---|
session_id | int | 대상 시뮬레이션 세션 ID. |
device_family | string | 장치 유형: inverse 또는 verse_grip. |
device_id | string | 디바이스의 고유 식별자입니다. |
frequency | int | 현재 제어 주파수(헤르츠). |
{
"name": "device-low-control-rate",
"category": "session",
"level": "warning",
"data": {
"session_id": 3,
"device_family": "inverse",
"device_id": "1A2B",
"frequency": 260
},
"message": ""
}
device-critical-control-rate
장치의 수신 직접 제어 명령이 너무 낮은 전송 속도에 도달하여 안전 한계치에 도달했을 때 발생합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
session_id | int | 대상 시뮬레이션 세션 ID. |
device_family | string | 장치 유형: inverse 또는 verse_grip. |
device_id | string | 디바이스의 고유 식별자입니다. |
frequency | int | 현재 제어 주파수(헤르츠). |
{
"name": "device-critical-control-rate",
"category": "session",
"level": "error",
"data": {
"session_id": 3,
"device_family": "inverse",
"device_id": "1A2B",
"frequency": 82
},
"message": ""
}
주요 기능
sdf-sdf_hfx-created
SDF 엔티티 FX가 생성될 때 발행됩니다.
| 필드 | 유형 | 설명 |
|---|---|---|
session_id | int | 대상 시뮬레이션 세션 ID. |
device_id | string | 디바이스의 고유 식별자입니다. |
hfx_id | string | 이 항목을 생성할 때 사용된 FX ID. |
{
"name": "sdf-sdf_hfx-created",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}
sdf-sdf_hfx-deleted
SDF 엔티티 FX가 삭제될 때 발생합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
session_id | int | 대상 시뮬레이션 세션 ID. |
device_id | string | 디바이스의 고유 식별자입니다. |
hfx_id | string | 삭제된 FX ID. |
{
"name": "sdf-sdf_hfx-deleted",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}
sdf-sdf_hfx-updated
SDF 엔티티 FX가 업데이트될 때 발생합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
session_id | int | 대상 시뮬레이션 세션 ID. |
device_id | string | 디바이스의 고유 식별자입니다. |
hfx_id | string | 업데이트된 FX ID. |
{
"name": "sdf-sdf_hfx-updated",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}
sdf-sdf_hfx-range-entered
지정된 장치의 커서가 SDF 엔티티 범위에 진입할 때 발생합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
session_id | int | 대상 시뮬레이션 세션 ID. |
device_id | string | 디바이스의 고유 식별자입니다. |
hfx_id | string | FX ID. |
{
"name": "sdf-sdf_hfx-range-entered",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}
sdf-sdf_hfx-range-exited
지정된 장치의 커서가 SDF 엔티티 범위를 벗어날 때 발생합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
session_id | int | 대상 시뮬레이션 세션 ID. |
device_id | string | 디바이스의 고유 식별자입니다. |
hfx_id | string | FX ID. |
{
"name": "sdf-sdf_hfx-range-exited",
"category": "feature",
"level": "notice",
"data": {
"session_id": 3,
"device_id": "1A2B",
"hfx_id": "my_fx_name"
},
"message": ""
}