이력 조회 및 추세 그래프

용도에 따라 조회 방식을 선택합니다. 소량의 원본 상세 데이터는 문제 해결에, 시간 구간별 추세는 변화 확인에 사용하며, 대량 데이터는 비동기 내보내기로 처리합니다.

조회 방식

요구 사항	방식	설명
원본 샘플 확인	이력 상세 조회	데이터 포인트와 시간 범위별 페이지 조회
추세 비교	그래프 조회	시간 버킷을 자동 선택하고 반환 포인트 수 제한
사용자 정의 통계	집계 조회	여러 데이터 포인트에 통계 방식과 시간 단위를 개별 설정
대량 상세 데이터 저장	이력 내보내기	백그라운드에서 CSV 또는 ZIP 생성

수집, 집계 및 공유 이력을 추세 분석에 사용할 수 있습니다. 공유 데이터 포인트에는 장치 코드와 dataKey를 함께 지정하여 다른 장치의 같은 이름 포인트가 혼합되지 않도록 합니다.

추세 그래프의 데이터 처리 방식

• 시간 단위를 자동 선택하거나 단위와 간격을 직접 지정할 수 있습니다.
• 평균, 최댓값, 최솟값, 개수, 첫 값 및 마지막 값 등의 통계를 지원하며 데이터 유형에 따라 선택합니다.
• 지정된 시간대에 맞춰 시간 버킷을 정렬하여 일별 또는 시간별 변화를 쉽게 비교합니다.
• 샘플이 없는 구간은 빈 값으로 유지합니다. 그래프에서는 0으로 그리지 말고 끊어진 구간으로 표시해야 합니다.
• 숫자가 아닌 데이터에는 평균이 적합하지 않으므로 개수, 첫 값 또는 마지막 값을 사용할 수 있습니다. 인터페이스가 반환하는 데이터 경고를 그래프와 함께 표시해야 합니다.

누적 전력량은 첫 값과 마지막 값의 차이 및 계량기 초기화 여부를 함께 분석해야 하며, 누적 검침값을 직접 합산하지 않습니다.

인터페이스 예제

POST /ems-data/chart/query, 요청 헤더에 로그인 token 포함:

{
  "series": [{"dataKey": "demo_temperature", "statistics": ["AVG", "MAX"]}],
  "startTime": "2026-10-01T00:00:00+08:00",
  "endTime": "2026-10-02T00:00:00+08:00",
  "bucketMode": "AUTO",
  "targetPoints": 200,
  "timezone": "Asia/Shanghai"
}

결과의 series[].statistics에는 각 통계 곡선이 포함되며, 실제 버킷 간격과 warnings도 반환됩니다. 예제 데이터 포인트는 장치의 실제 데이터 포인트로 교체해야 합니다.

이력 상세 조회에는 POST /ems-data/history, 사용자 정의 집계에는 POST /ems-data/aggregate/query를 사용합니다. 후자는 data.items[]별로 성공 또는 실패 결과를 반환하며, 그래프 인터페이스의 반환 구조와 동일하게 취급할 수 없습니다.

이력 그래프 Skill로 조회하고 분석할 수도 있습니다. 장기 데이터 보존이 필요하면 주기적 아카이브를 설정하세요.