주요 콘텐츠로 건너뛰기
버전: 3.4.x

이벤트 채널

기본 이벤트 웹소켓 URL은 ws://localhost:10020. 참고: 포트는 구성에서 변경할 수 있습니다.

모든 시스템 이벤트를 수신할 수 있는 저주파 단방향 통신 채널입니다. 입력 메시지는 지원되지 않습니다.

이 채널은 각 이벤트에 대해 하나의 메시지를 보내도록 보장합니다.

표준 형식​

모든 이벤트는 아래와 같은 표준 구조를 따릅니다:

{
  "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"
  }
}