본문으로 건너뛰기

상태 코드 정의

목차​

개요​

플랫폼 화면 곳곳에 표시되는 상태 뱃지·아이콘·색상의 의미를 한 페이지에 모아 둔 레퍼런스입니다. 운영 중 마주치시는 색이나 코드의 의미가 헷갈리실 때 이 문서를 펼쳐 확인하시면 됩니다.

이 문서는 화면이 아닌 상태 코드 레퍼런스 문서로, 다음 화면 곳곳에 표시되는 코드를 매핑합니다.

알람 우선순위​

알람의 심각도를 나타내는 3단계 레벨입니다.

코드한국어색상HEX설명권장 조치
INFO정보녹색#5eb561정보성 알람즉각 조치 불필요, 참고용
WARN경고주황#eb7f0a주의 필요추이 확인, 임계 근접 시 점검 준비
ERROR심각빨강#d9534f즉각 조치 필요발생 자산 점검 또는 시스템 관리자 통보

알람 밴드와 우선순위 매핑​

알람 밴드(임계값 구간)는 자동으로 우선순위에 매핑됩니다.

알람 밴드매핑 우선순위
NORMAL알람 미발생
HIGH / LOWINFO (정보)
HIGH-HIGH / LOW-LOWWARN (경고)
TRIP-HIGH / TRIP-LOWERROR (심각)

알람 활성·확인 상태​

필드값의미
is_onY알람 활성 (발생 중)
is_onN알람 해제 (복구됨)
is_readY확인됨 (Acknowledged)
is_readN미확인 (Unread)

운영자가 알람을 확인했어도 (is_read=Y) 아직 복구되지 않았다면 (is_on=Y) 화면에서는 활성 알람으로 표시됩니다.

진단 레벨​

진단 화면에 표시되는 시스템 진단 로그의 심각도입니다.

코드한국어색상HEX설명
INFO정보파랑#5bc0de정상 동작 정보 (시작/종료 알림 등)
WARN경고주황#f0ad4e잠재적 문제, 모니터링 필요
ERROR심각빨강#d9534f심각 상황, 즉시 점검 필요

화면 색상은 운영 환경의 테마 설정에 따라 다소 다를 수 있습니다.

통신 연결 상태 (OPC/엣지)​

OPC 서버·엣지 디바이스의 데이터 수신 상태를 마지막 수신 시각 기준으로 판단합니다.

코드한국어색상HEX임계값설명
OK연결됨녹색#2e7d3210분 미만데이터 수신 정상
WARN연결지연주황#e6510010분 ~ 60분데이터 미수신, 주의
ERROR연결이상빨강#b71c1c60분 ~ 24시간1시간 이상 미수신
DISCONNECTED연결끊김회색#88824시간 초과24시간 이상 미수신
UNKNOWN미관측옅은 회색#ccc—최종 수신 이력 없음

임계값 10분·60분·24시간은 StatusThresholds 가 정하는 값입니다. 자산 트리 범례처럼 오래된 화면 몇 곳은 OK 를 "정상연결", UNKNOWN 을 "미연결" 로 적기도 합니다 — 이름만 다르고 같은 상태입니다.

빠른 식별 팁​

상황의미
신규 OPC 등록 직후UNKNOWN (한 번도 수신 안 됨)
수집 정상 운영OK
잠시 단절 (네트워크/재시작)WARN
1시간 이상 단절ERROR (즉시 연결 관리 점검)
하루 이상 단절DISCONNECTED (디바이스/네트워크 점검)

통신 지연 상태 (OPC 레이턴시)​

지연에는 기준이 두 벌 있습니다. 어느 화면을 보고 있느냐에 따라 적용되는 것이 다릅니다.

① 상태 판정용 — 평균 지연 기준​

자산 건강 상태를 매길 때 쓰는 기준입니다(StatusEvaluator).

코드한국어색상임계값 (평균 지연)설명
OK정상녹색1초 미만응답 지연 없음
WARN지연주황1초 ~ 10초응답 지연 발생
ERROR심각지연빨강10초 이상심각한 응답 지연
UNKNOWN알수없음회색—레이턴시 측정 데이터 없음

② 트렌드 차트용 — 구간 최대 지연 기준​

연결 상태 화면의 통신 지연 상태 트렌드 차트는 위 기준이 아니라 그 시간 구간의 최대 지연(max_latency) 으로 셉니다.

막대임계값 (구간 최대 지연)
🟢 정상10초 미만
🟠 지연10초 ~ 60초
🔴 심각 지연60초 이상
차트 위 툴팁은 ①의 숫자를 보여줍니다

그 차트의 ⓘ 도움말은 "평균 지연 1초 미만 / 1~10초 / 10초 이상" 이라고 적혀 있지만, 막대를 만드는 계산은 ②(최대 10초/60초)입니다. 툴팁의 숫자와 막대가 서로 다른 기준이니 차트를 읽을 때는 ②로 해석하세요.

평균 3초짜리 연결이 차트에서 녹색으로 보이는 것은 고장이 아니라 이 차이 때문입니다.

건강 상태 (사이트/구역/라인/설비)​

계층별 건강 상태입니다. 해당 계층 하위에 발생한 알람의 최고 레벨로 결정됩니다.

코드한국어색상HEX설명
NORMAL정상녹색#3d8b40알람 없음
WARN주의주황#eb7f0a경고 알람 1건 이상
ERROR위험빨강#d9534f심각 알람 1건 이상
UNKNOWN미상옅은 회색#ccc평가 데이터 없음 (신규 등록 직후 등)

판정 로직: 심각 알람 1건 이상 → ERROR, 경고 알람 1건 이상 → WARN, 그 외 → NORMAL. 평가 자체가 없으면 UNKNOWN.

연결 상태 집계 (계층 단위)​

사이트/구역/라인/설비 같은 계층의 연결 상태는 그 계층에 속한 모든 OPC/엣지의 상태를 집계해 결정됩니다.

코드한국어색상설명
NORMAL연결됨녹색하위 모두 OK
WARN연결지연주황하위에 WARN 1건 이상
ERROR연결이상빨강하위에 ERROR 1건 이상
DISCONNECTED연결끊김진한 빨강 (#4a0e0e)하위에 DISCONNECTED 1건 이상
UNKNOWN미관측옅은 회색하위에 평가 데이터가 없음

판정 로직(우선순위 높음 → 낮음): DISCONNECTED → ERROR → WARN → NORMAL → UNKNOWN.

시스템 헬스 상태​

플랫폼 전체 건강 상태입니다. 진단 로그 카운트로 결정됩니다.

코드한국어색상설명
NORMAL정상녹색진단 로그 없음
INFO정보파랑정보성 진단만 발생
WARN경고주황경고 진단 발생
ERROR위험빨강심각 진단 발생, 시스템 점검 필요

부하 워치독은 대시보드 헬스 레일·진단 의 HEALTHY/DEGRADED/CRITICAL 3단계 상태머신을 별도로 운영합니다.

워치독 상태의미발행
HEALTHY정상 부하(회복 시 1줄 기록)
DEGRADED임계 1단계 초과가 30초 이상 지속진단 로그 1줄 (WARN)
CRITICAL임계 2단계 초과가 30초 이상 지속진단 로그 1줄 (ERROR)

헬스체크 상태 (인프라 컴포넌트)​

대시보드 헬스 레일 의 "인프라" 섹션에 표시됩니다.

결과 코드​

코드한국어의미
NORMAL정상컴포넌트 정상 동작
ABNORMAL비정상컴포넌트 이상 감지
UNKNOWN알수없음헬스체크 결과 미수신

헬스체크 대상 (대시보드 헬스 레일 라벨 기준)​

라벨역할
인-메모리 캐시운영 데이터 캐시
웹소켓실시간 푸시 채널
MQTTMQTT 메시지 채널
KAFKAKAFKA 메시지 채널
이벤트 스토어이벤트·시계열 영구 저장소
시계열 엔진시계열 데이터 처리 엔진

컴포넌트 라벨은 운영 화면에 그대로 표시되는 명칭입니다. 내부 구현 변경이 있어도 화면 라벨은 유지됩니다.

설비 운전 상태 (OEE)​

OEE(설비 종합 효율) 기반 설비 운전 상태입니다.

코드한국어색상HEX설명
RUN가동녹색#15803D정상 생산 가동 중
IDLE유휴주황#D97706대기 (원자재 부족·지시 대기 등)
FAULT고장빨강#B91C1C설비 고장/이상으로 비가동
STOP정지진한 회색#374151작업자 의도적 정지
SETUP셋업파랑#1D4ED8준비/셋업 (금형 교체·워밍업)
PLANNED_STOP계획정지파랑#1D4ED8계획된 정지 (점심·정기점검·휴무)
PLANNED_START계획시작파랑#1D4ED8계획된 가동 시작
DOWN비가동회색#4B5563비가동 상태
UNKNOWN알수없음회색#888상태 불명

가동/비가동 분류​

분류포함 코드
가동(Operating)RUN, SETUP (생산 준비), PLANNED_START
비가동(Non-operating)IDLE, FAULT, STOP, PLANNED_STOP, DOWN, UNKNOWN

OEE 의 가동률(Availability) 은 가동 시간 ÷ 계획 운전 시간으로 계산됩니다(계획 정지는 분모에서 제외).

작업지시 상태 (전체 라이프사이클)​

작업지시(WorkOrder) 의 상태머신입니다. 여기 다섯 가지가 실제로 저장되는 값입니다.

워크오더 화면에는 두 가지가 더 보입니다

워크오더 목록은 지연과 취소를 더해 7종을 보여주는데, 그 둘은 저장되는 상태가 아니라 대기 상태를 지금 시각과 비교해 화면이 계산한 것입니다. 판정 규칙은 그 문서에 있습니다.

코드한국어색상HEX설명
WAIT대기회색#888작업 지시 대기 (생성 직후 기본 상태)
START진행중녹색#15803D작업 지시 실행 중
PAUSED일시정지주황#D97706작업 일시 중단 (재개 가능)
END완료진한 회색#374151작업 정상 완료
ABORTED중단진한 빨강#7f1d1d작업 비정상 종료 (품질 이상·라인 격리 등)

상태 전이 다이어그램​

WAIT  ─[start]─▶  START  ─[pause]─▶  PAUSED
                    │  ▲              │
                    │  └─[resume]─────┘
                    │
                    ├─[end]──────▶  END
                    │
                    └─[abort]────▶  ABORTED
                          ▲
            PAUSED ───[abort]──┘
            PAUSED ───[end]────▶ END
전이자동화 노드
WAIT → STARTflow_start_work_order
START → PAUSEDflow_pause_work_order
PAUSED → STARTflow_resume_work_order
START/PAUSED → ENDflow_end_work_order
START/PAUSED → ABORTEDflow_abort_work_order (abort_code/notes 옵션)

자동화 노드 상세는 플로우 — 작업지시 상태 전이 참고.

캘린더(시프트) 상태​

근무표(시프트) 일정의 상태입니다.

코드한국어색상HEX설명
UPCOMING예정회색#888미래 일정
PROGRESS진행중녹색#15803D현재 진행 중인 시프트
DONE완료진한 회색#374151종료된 시프트

태그 알람밴드 코드​

태그가 어떤 알람밴드 구간에 있는지를 나타내는 코드입니다.

수치형 (Numeric)​

코드한국어의미
NORMAL정상알람 미발생 구간
HIGH상한사용자 정의 상한 초과
LOW하한사용자 정의 하한 미만
HIGH-HIGH상상한심각 상한 초과
LOW-LOW하하한심각 하한 미만
TRIP-HIGH트립상한트립 상한 초과 (즉시 정지 권고)
TRIP-LOW트립하한트립 하한 미만 (즉시 정지 권고)

불린형 (Boolean)​

코드한국어설명
BOOL_TRUE참태그 값이 true 일 때
BOOL_FALSE거짓태그 값이 false 일 때

각 불린값마다 우선순위(bool_true_priority / bool_false_priority)와 메시지(bool_true_message / bool_false_message)를 별도로 정의할 수 있습니다.

엔티티 라이프사이클 이벤트​

도메인 엔티티(자산·태그·작업지시·시프트 등)의 변경 이벤트 타입입니다.

이벤트발생 시점
ENTITY_CREATED엔티티 신규 생성 직후
ENTITY_UPDATED엔티티 메타 수정 직후
ENTITY_DELETED엔티티 삭제 직후

플로우 의 flow_on_entity_event 트리거가 이 이벤트들을 받습니다.

자산 단위 이벤트​

이벤트발생
ASSET_DATA자산 텔레메트리 인입
ASSET_EVENT자산 도메인 이벤트
ASSET_ALARM자산 알람 발생
ASSET_COMMAND자산 명령 발행
ASSET_AGGREGATION자산 집계(예: 6시간 평균)
ASSET_CONTEXT자산 컨텍스트
ASSET_HEALTH_STATUS자산 헬스 주기 평가 결과
ASSET_CONNECTION_STATUS자산 연결 주기 평가 결과

플로우 노드 관계 (Relations)​

플로우 화면에서 노드 간 와이어에 표기되는 관계 라벨입니다. 모두 대문자입니다.

코드의미
SUCCESS정상 처리 완료
FAILURE처리 실패 (보통 에러 핸들러로 분기)
TRUE조건 필터의 참
FALSE조건 필터의 거짓
MATCHSwitch 노드의 일치 분기
NO_MATCHSwitch 노드의 불일치
DEFAULTSwitch 노드의 모든 case 미매칭
THROTTLEDThrottle 노드 차단
EXHAUSTEDRetry 최대 시도 초과
SKIPPED트리거 패턴 미매칭 (실행 카운트 미포함)

공통 색상 팔레트​

기본 3단계 상태 색상​

상태색상명HEX
정상녹색#5eb561
경고주황#eb7f0a
심각/위험빨강#d9534f
비활성/미상회색#888
매우 위험(연결끊김)진한 빨강#4a0e0e / #7f1d1d

설비 상태 색상 (OEE)​

상태색상명HEX
가동녹색#15803D
유휴주황#D97706
고장빨강#B91C1C
정지진한 회색#374151
셋업/계획파랑#1D4ED8
비가동회색#4B5563
알수없음회색#888

알람 우선순위 색상 (별도 팔레트)​

우선순위HEX
정보 (INFO)#5bc0de (사이드 패널) / #5eb561 (목록 뱃지)
경고 (WARN)#f0ad4e (사이드 패널) / #eb7f0a (목록 뱃지)
심각 (ERROR)#d9534f (공통)

같은 의미의 색상이라도 화면 영역에 따라 미세하게 다른 톤이 사용됩니다. 표시 일관성은 같은 화면 내에서 유지됩니다.

차트 시리즈 기본 색상 순서​

차트의 다중 시리즈는 다음 순서로 색이 부여됩니다.

파랑 → 녹색 → 주황 → 보라 → 청록 → 빨강 → 노랑 → 회색 → ...

차트별 시리즈 수가 많을 때 일부 색상이 반복될 수 있습니다.