시계열 데이터

시계열 데이터는 HMI 장치가 보내거나 플랫폼이 계산한, 타임스탬프가 붙은 키-값 쌍의 연속입니다. 센서 측정값, 카운터, 상태 변화처럼 계속 바뀌는 측정값을 나타내며, 최신 값만이 아니라 모든 데이터 포인트가 중요합니다.

속성과 비교하면 다음과 같습니다.

시계열 항목은 다음으로 이루어집니다.

• Key — 측정값 이름(예: temperature)
• Value — 문자열, boolean, integer, double 또는 JSON
• Timestamp — Unix epoch 밀리초. HMI 장치가 보내지 않으면 서버가 자동으로 붙임

기본 페이로드:

{ "temperature": 26.5, "humidity": 78, "pressure": 1013.2 }

타임스탬프를 직접 지정할 때:

{ "ts": 1745000000000, "values": { "temperature": 26.5, "humidity": 78 } }

HMI 장치는 MQTT로 시계열 데이터를 보냅니다. MQTT 프로토콜은 다른 페이로드 형식을 쓸 수 있지만 같은 내부 JSON 형식으로 변환되며, 전송 방식만 다릅니다. 프로토콜별 자세한 내용은 HMI 장치 연결 방법을 참고하세요.

많은 프로토콜이 한 메시지에 타임스탬프가 다른 여러 측정값을 담을 수 있습니다. 오프라인 데이터를 묶어 보내거나 측정 주기가 짧은 센서에 유용합니다.

[
  { "ts": 1745000000000, "values": { "temperature": 25.1 } },
  { "ts": 1745000060000, "values": { "temperature": 25.4 } },
  { "ts": 1745000120000, "values": { "temperature": 26.0 } }
]