수집데이터 이력
개요
이 화면은 무엇인가요?
수집기가 센서로부터 수집한 시계열 데이터 이력을 조회하는 화면입니다. 태그별, 시간 범위별로 수집된 값과 데이터 품질(good/bad/uncertain)을 확인할 수 있습니다. 수집이 정상적으로 이루어지고 있는지, 데이터 품질에 문제는 없는지 점검할 때 사용합니다.
누가 사용하나요?
- IoT 엔지니어: 수집 상태 점검, 데이터 품질 확인
- 설비 담당자: 특정 설비·태그의 과거 수집값 조회
- 데이터 분석가: 분석 전 원본 데이터 확인
언제 사용하나요?
- 수집기를 설정한 후 데이터가 정상 수집되는지 확인할 때
- 특정 시간대의 센서 값을 원본 수준에서 확인해야 할 때
- 데이터 품질이
bad인 항목을 찾아 원인을 조사할 때
주요 기능
- 시계열 이력 조회: 태그별, 시간 범위별 수집 데이터 목록 표시
- 품질 필터: good/bad/uncertain으로 데이터 품질 필터링
- Raw 값 확인: 스케일링 전 원본 값(
raw_value)과 변환 후 값 비교 - 수집 지연 확인: 소스 타임스탬프와 수집 시각 간 지연(latency) 확인
업무 흐름에서의 위치
목록 화면 설정
표시 컬럼
| 컬럼 | 표시 형태 | 정렬 | 설명 |
|---|---|---|---|
| 태그 | 텍스트 | ✅ | 태그코드 표시 |
| 수집시각 | 날짜/시간 | ✅ | 데이터 수집 시각 |
| 숫자값 | 텍스트 | ✅ | FLOAT/INTEGER 태그의 수집값 |
| 문자값 | 텍스트 | ✅ | STRING 태그의 수집값 |
| 품질 | 배지 (녹/적/노) | ✅ | good(녹) / bad(적) / uncertain(노) |
| 설비자산 | 텍스트 | ✅ | 연결된 설비 코드 |
| 수집지연(ms) | 텍스트 | ✅ | 소스→시스템 간 지연 |
검색/필터
| 필드 | 필터 유형 | 설명 |
|---|---|---|
| 품질 | 드롭다운 선택 | good/bad/uncertain 품질별 필터 |
| 수집시각 | 날짜 범위 | 시작일~종료일 범위 지정 |
자주 묻는 질문 (FAQ)
품질이 'bad'인 데이터가 많이 보입니다. 원인이 뭔가요?
bad 품질의 주요 원인:
- 센서 고장: 센서가 물리적으로 손상되어 비정상 값을 전송
- 통신 오류: 데이터소스와의 통신이 불안정하 여 값이 깨짐
- 범위 초과: 태그에 설정된 min/max 범위를 벗어난 값
- 수집기 오류: 수집기의 전처리 과정에서 변환 실패
대응 방법: 먼저 데이터소스 관리 화면에서 연결상태를 확인하고, 해당 태그의 센서 물리 상태를 점검하세요.
수집 지연(latency)이 높으면 문제가 되나요?
latency_ms가 높다는 것은 센서에서 값이 발생한 시각(source_timestamp)과 시스템에 도달한 시각(timestamp) 사이에 지연이 크다는 의미입니다.
- 10ms 이하: 정상 (로컬 PLC 직접 연결)
- 10~100ms: 양호 (네트워크 경유)
- 100ms~1초: 주의 (네트워크 혼잡 또는 엣지 디바이스 부하)
- 1초 이상: 문제 (네트워크 장애, 수집기 과부하 의심)
실시간 모니터링이나 알람에 영향을 줄 수 있으므로, 지속적으로 높으면 네트워크와 수집기 설정을 점검하세요.
실무 시나리오
야간 생산 중 이상 데이터 조사
상황: 야간 교대 중 알람이 발생했는데, 해당 시간대의 수집 데이터를 원본 수준에서 확인해야 합니다.
처리 순서:
- 수집시각 필터에
2026-03-16 22:00~2026-03-17 06:00범위를 설정합니다 - 알람이 발생한 태그로 필터링합니다
- 품질이
bad인 데이터를 확인하여 시간대별 패턴을 분석합니다 - Raw값과 변환된 값을 비교하여 스케일링 문제가 있는지 확인합니다
- 문제가 확인되면 데이터태그 목록에서 해당 태그의 설정을 점검합니다
참고: 데이터 구조
수집데이터 테이블 (collected_data)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
tag_id | 태그ID | UUID (FK) *필수 | data_tags 참조 |
timestamp | 수집시각 | TIMESTAMP *필수 | - |
value_numeric | 숫자값 | DECIMAL | FLOAT/INTEGER 타입 값 |
value_text | 문자값 | VARCHAR | STRING 타입 값 |
quality | 품질 | ENUM(good, bad, uncertain) *필수 | - |
collector_id | 수집기ID | UUID (FK) | collector_configs 참조 |
value_boolean | 논리값 | BOOLEAN | BOOLEAN 타입 값 |
raw_value | Raw값 | VARCHAR | 스케일링 전 원본 값 |
asset_id | 설비자산ID | UUID (FK) | equipment_assets 참조 (비정규화) |
source_timestamp | 소스타임스탬프 | TIMESTAMP | 데이터소스 측 발생 시각 |
latency_ms | 수집지연(ms) | INT | source_timestamp→timestamp 간 지연 |