SpreadJS 블로그 MESCIUS 기술 블로그 ·

JavaScript로 실시간 에너지 센서 대시보드 만들기 — SpreadJS

웹 애플리케이션을 개발하다 보면 "실시간으로 갱신되는 센서 데이터를 차트·KPI 지표와 함께 한 화면에 보여주는 대시보드"를 구현해달라는 요청을 받게 됩니다. FEMS(에너지관리시스템)처럼 수십 개 센서 값을 1~2초 단위로 갱신해야 하는 경우, DOM 조작이나 Canvas 기반 차트 라이브러리만으로는 실시간 갱신·임계치 알림·Excel 출력을 동시에 처리하기 어렵습니다. SpreadJS는 Excel과 동일한 셀 모델 위에 실시간 갱신·조건부 서식·게이지 스파크라인·차트·Excel 출력을 통합한 JavaScript 스프레드시트 컴포넌트로, 단일 라이브러리로 에너지 대시보드에 필요한 모든 기능을 완성할 수 있습니다.

ActiveX·Flash 기반 설비 모니터링 화면을 순수 웹으로 전환하는 SI 프로젝트가 늘어나면서, 기존 UX를 유지하면서도 현대적인 웹 기술로 재구현해야 하는 과제가 생겼습니다. ESG 보고 의무화로 에너지 사용량 데이터를 실시간 집계하고 Excel 형식 보고서로 출력해야 하는 요구도 함께 급증했습니다.

이 글에서는 setInterval 로 에너지 센서 데이터를 폴링하고 setValue() 로 셀을 갱신하는 실시간 모니터링 패턴부터, 게이지 KPI 스파크라인·조건부 서식·차트를 활용한 FEMS 대시보드 완성까지, 단계별 코드 예제와 함께 설명합니다. React·Vue·Angular 없이 Vanilla JS만으로 구현할 수 있어 사용 중인 프레임워크와 무관하게 적용 가능합니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 setInterval + setValue() 패턴으로 서버 API 데이터를 셀에 직접 써서 1~5초 주기 실시간 대시보드를 구현합니다
02 게이지 KPI 스파크라인으로 kWh·CO₂·전력 피크를 별도 차트 없이 셀 내 반원형 게이지로 즉시 시각화합니다
03 조건부 서식으로 임계값 초과 셀을 자동 빨강 강조해 코드 몇 줄로 이상 감지 알림을 구현합니다
04 xlsx Export로 현재 워크북을 Excel 파일로 내보내 에너지 실적 보고서를 그대로 보존합니다
JavaScript로 실시간 에너지 센서 대시보드 만들기 — SpreadJS — 대표 이미지

FEMS 웹 대시보드에 SpreadJS를 사용하는 이유

SpreadJS는 Excel과 동일한 셀 모델 위에 실시간 갱신·차트·조건부 서식·Excel I/O를 통합해, FEMS 대시보드에 필요한 기능을 별도 BI 툴 없이 브라우저 내에서 완성합니다. FEMS 웹 화면을 순수 JavaScript로 구현할 때 가장 어려운 부분은 ① 실시간 갱신, ② KPI 시각화, ③ 임계치 알림, ④ Excel 출력 네 가지를 동시에 처리하는 것입니다. SpreadJS는 이 네 가지를 하나의 컴포넌트로 해결합니다.

기존 레거시 시스템이 Excel 기반 보고서를 사용하고 있다면 xlsx 내보내기로 데이터 연속성을 그대로 유지할 수 있으며, 담당자의 재교육 없이 보고 체계를 이어갈 수 있습니다.

↗
500+
내장 수식
Excel 호환 계산 엔진
↗
40+
스파크라인 유형
게이지·KPI·면적·WinLoss 등
↗
3,000+
글로벌 기업
엔터프라이즈 검증 완료
ⓘ NOTE
SpreadJS는 WEBSERVICE 함수로 인터넷·인트라넷 웹 서비스에서 데이터를 직접 가져올 수 있어 REST API 기반 에너지 센서 연동에 적합합니다.

setInterval + setValue()로 에너지 센서 데이터 실시간 연동하기

실시간 에너지 모니터링의 핵심은 서버 폴링 → 셀 갱신 → 조건부 서식 재평가 사이클을 빠르게 반복하는 것입니다. SpreadJS는 setValue() 호출만으로 해당 셀의 조건부 서식이 즉시 재평가되기 때문에, setInterval 과 조합하면 실시간 이상 알림 대시보드를 단 몇 줄 코드로 구현할 수 있습니다.

아래 데모는 4개 구역(공장동·본관·창고동·서버실)의 kWh 소비를 1.5초 간격으로 시뮬레이션하고, 임계값(300 kWh) 초과 시 해당 셀을 자동으로 빨강 강조합니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: JavaScript (실시간 폴링 + 조건부 서식)

실행 결과
💡 TIP
실제 FEMS 환경에서는 setInterval 콜백 안에서 fetch('/api/sensor/realtime') 로 서버 데이터를 받아온 뒤 setValue() 로 갱신합니다. 폴링 주기는 설비 응답 속도에 맞게 2~5초로 설정하는 것이 일반적입니다.
setInterval + setValue()로 에너지 센서 데이터 실시간 연동하기 — SpreadJS 개념도

게이지 KPI 스파크라인으로 kWh·CO₂·전력피크를 시각화하는 방법

SpreadJS는 게이지 KPI 스파크라인으로 KPI 기준값 대비 지표 성능을 셀 내에서 시각화할 수 있습니다. FEMS 대시보드에서 kWh 소비량, CO₂ 배출량, 전력 피크를 반원형 게이지로 표현하면 현재 값이 목표 범위 내에 있는지 한눈에 파악할 수 있습니다.

GAUGEKPISPARKLINE 수식은 목표값·현재값·최소/최대·색상 구간을 인수로 받아 셀 내에 게이지를 렌더링합니다. 녹색(정상)→주황(주의)→빨강(위험) 3단계 구간 설정이 핵심입니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: Gauge KPI 스파크라인 데모

실행 결과
⭐ IMPORTANT
GAUGEKPISPARKLINE 의 색상 구간은 {최소, 최대, "색상코드"} 형식으로 최대 3개까지 지정합니다. 녹색(정상)→주황(주의)→빨강(위험) 3단계로 설정하면 에너지 임계값 도달 여부를 한눈에 확인할 수 있습니다.
게이지 KPI 스파크라인으로 kWh·CO₂·전력피크를 시각화하는 방법 — SpreadJS 개념도

에너지 소비 차트 구현과 Excel 보고서 다운로드 기능 추가하기

에너지 소비 트렌드를 시간대별로 시각화하고 Excel 보고서로 다운로드하는 기능은 FEMS의 필수 요구사항입니다. SpreadJS는 sheet.charts.add() 로 Line 차트를 삽입하고, spread.export() 로 현재 워크북을 xlsx 형식으로 내보낼 수 있습니다. 데이터·스타일·조건부 서식·차트가 모두 Excel 파일에 그대로 담깁니다.

STEP 1: CDN 참조 (차트·IO 플러그인 포함)

STEP 2: HTML 구조

STEP 3: 에너지 소비 Line 차트 + xlsx 내보내기

실행 결과
⭐ BEST PRACTICE
spread.export() 는 현재 워크북의 데이터·스타일·조건부 서식·차트를 그대로 xlsx에 담아줍니다. 에너지 실적 보고서를 Excel에서 열어 추가 분석하거나 상급자 보고 자료로 활용하는 데 바로 사용할 수 있습니다.

개발자가 자주 묻는 질문

Q01

에너지 설비 모니터링 화면을 웹으로 전환할 때 SpreadJS를 사용하면 어떤 점이 좋은가요?

SpreadJS는 게이지 스파크라인·조건부 서식·차트를 하나의 컴포넌트로 묶어 FEMS 대시보드에 필요한 실시간 갱신·Excel 출력·대용량 데이터 처리를 브라우저 안에서 모두 구현할 수 있습니다. ActiveX·Flash 전환 프로젝트에서 동일한 수준의 UX를 순수 웹으로 재현하는 데 적합합니다.

Q02

setInterval로 에너지 센서 데이터를 가져와서 SpreadJS 셀에 표시하려면 어떻게 하나요?

setInterval 콜백 안에서 sheet.setValue(row, col, value) 를 호출하면 됩니다. fetch API로 서버 데이터를 받아온 뒤 setValue() 로 갱신하면 조건부 서식도 즉시 재평가됩니다.

Q03

SpreadJS에서 kWh가 임계값을 넘으면 셀 색상을 자동으로 빨간색으로 바꾸려면?

SpreadJS 조건부 서식 API를 사용합니다. sheet.conditionalFormats.addCellValueRule(ComparisonOperators.greaterThan, threshold, 0, redStyle, ranges) 를 설정하면 setValue() 호출 즉시 서식이 재평가되어 임계값 초과 셀이 자동으로 강조됩니다.

Q04

같은 시트에 에너지 소비 데이터 표와 차트를 함께 넣을 수 있나요?

네. SpreadJS는 동일한 시트에 데이터 테이블과 sheet.charts.add() 로 삽입한 Line·Area 차트를 함께 배치할 수 있습니다. 데이터가 갱신되면 차트도 자동으로 업데이트됩니다.

Q05

SpreadJS로 에너지 사용량 보고서를 Excel 파일로 다운로드하게 만들려면 어떻게 하나요?

IO 플러그인을 로드한 뒤 spread.export(callback, errorCallback, { fileType: GC.Spread.Sheets.FileType.excel }) 을 호출하면 현재 워크북이 xlsx 파일로 다운로드됩니다. 스타일·차트·조건부 서식이 모두 Excel에서 그대로 열립니다.

MESCIUS SpreadJS

지금 바로 SpreadJS 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

SpreadJS 무료 체험판 다운로드