시스템
목차
- 개요
- 화면 구성 — System 그룹
- 모니터링 화면 (
/monitoring/index) - 로그 화면 (
/log/index) - 설정 화면 (
/config/index) - 환경정보 화면 (
/env/view) - 활용 시나리오
- 자주 묻는 질문
- 관련 화면
개요
시스템 메뉴는 플랫폼 자체의 운영 상태, 보안 계정, 설정, 로그, 환경정보, 클러스터를 모아 둔 영역입니다. 현재 좌측 메뉴의 System 그룹은 다음 항목을 포함합니다.
| 하위 메뉴 | 내부 URL / 외부 포트 | 용도 |
|---|---|---|
| 사용자 | /user/index | 사용자 계정 관리 |
| 보안 정책 | /security/index | 비밀번호·접근 보안 정책 |
| API 토큰 | /token/index | 외부 연동용 API 토큰 |
| 모니터링 | /monitoring/index | 인프라 헬스·데이터 파이프라인·엔진 메트릭 실시간 대시보드 |
| 진단 | /diagnostic/index | 시스템 진단 이벤트 조회 |
| 로그 | /log/index | 서버 애플리케이션 로그(클래스·메소드·라인 단위)를 시간순 조회 |
| 설정 | /config/index | 시스템 동작 키-값 설정 관리 (재적용/재시작) |
| 환경정보 | /env/view | 프로퍼티 파일별 환경 설정 값을 탭별로 조회 |
| 클러스터 | /cluster/index | 클러스터 노드 상태 |
| HA | /ha/index | 고가용성 구성 상태 |
| 감사 | /audit/index | 감사 로그 |
이 문서는 그중 모니터링 / 로그 / 설정 / 환경정보를 중심으로 설명합니다. 사용자·보안·토큰은 보안 관리, 진단은 진단, 외부 도구는 표준 및 외부 도구 를 함께 참고하세요.
화면 구성 — System 그룹
| 화면 | 주된 사용자 | 한줄 요약 |
|---|---|---|
| 모니터링 | 시스템 관리자 | 인프라 헬스 5칸 + 파이프라인 다이어그램 + 엔진 메트릭 9패널 + 트래픽·클러스터·진단 |
| 진단 | 운영자/관리자 | 시스템 진단 이벤트와 INFO/WARN/ERROR 흐름 |
| 로그 | 운영자/관리자 | 클래스·메소드·라인 정보까지 포함된 상세 애플리케이션 로그 |
| 설정 | 시스템 관리자 | 시스템 키-값 설정 추가·수정·캐시 재적용 |
| 환경정보 | 시스템 관리자 | 프로퍼티 파일(엔진/애플리케이션/메시지큐/스토리지/메일/웹소켓) 조회 (읽기 전용) |
| 클러스터 | 시스템 관리자 | 클러스터 노드, 모드, 지연, 리소스 상태 |
| HA | 시스템 관리자 | 고가용성 구성 상태 |
| 감사 | 시스템 관리자 | 감사 로그 |
모니터링 화면 (/monitoring/index)
플랫폼 자체의 실시간 운영 메트릭을 대시보드 형태로 표시합니다. 부제에 서버가 시작된 시각이 함께 나옵니다 — 방금 재기동했는지 한눈에 확인할 수 있습니다.
| 번호 | 자리 | 무엇 |
|---|---|---|
| ① | 좌측 위 | 인프라 헬스 — 5칸 |
| ② | 좌측 가운데 | 데이터 파이프라인 다이어그램 |
| ③ | 좌측 아래 | 엔진 메트릭 9패널 |
| ④ | 우측 위 | 데이터 트래픽 — 초당 바이트 + 스파크라인 |
| ⑤ | 우측 가운데 | 클러스터 — 노드별 상태·읽기/쓰기 지연·스토리지 |
| ⑥ | 우측 아래 | 시스템 진단 — 헬스 타임라인 + 최근 진단 |
① 인프라 헬스 — 5칸
| 칸 | 라벨 |
|---|---|
| 1 | 캐시 |
| 2 | MQTT |
| 3 | KAFKA |
| 4 | 이벤트 스토어 |
| 5 | 시계열 엔진 |
각 칸에 정상/이상이 표시됩니다. 모두 정상이면 운영이 안정 상태입니다.
부제 문구가 「캐시·웹소켓·MQTT·Kafka·이벤트스토어·시계열엔진」 여섯을 나열하지만, 실제로 그려지는 칸은 다섯입니다. WebSocket/STOMP 는 2026-07 에 퇴역했고 (브라우저 푸시는 SSE 로 바뀌었습니다) 칸만 먼저 빠진 상태입니다 — 부제의 잔재입니다.
② 데이터 파이프라인 다이어그램
데이터소스 → 메시지 버스 → 엔진 → 분석 → 스토리지 다섯 단으로 노드를 늘어놓고, 노드 사이를 흐르는 선으로 실제 경로를 보여 줍니다.
| 단 | 놓이는 노드(예) |
|---|---|
| 데이터소스 | 엣지/파일/API · DB · Modbus · PLC · OPC — 각 노드에 등록 수 |
| 메시지 버스 | 메시징 허브 — MSG/S |
| 엔진 | 파이프라인(처리 수·대기) · CEP(태스크 수) · 인제스션 |
| 분석 | 스케줄러 · 배치 · 스트림(MPS) |
| 스토리지 | 캐시 · 이벤트 스토어 · TSE(WPS) |
노드 아래 작은 글씨가 그 노드의 현재 지표입니다. 막힌 곳을 찾을 때 여기부터 보세요 — 앞 단은 숫자가 오르는데 뒷 단이 멈춰 있으면 그 사이가 병목입니다.
③ 엔진 메트릭 — 9패널
3열 × 3행입니다. 각 패널은 키-값 몇 줄 + 작은 차트로 되어 있습니다.
| 패널 | 보여 주는 값 |
|---|---|
| PPS | 현재 PPS · 최대 PPS (초당 수집 · 최근 1분) |
| JVM 힙 | 사용 · 전체 |
| 파이프라인 | 처리 완료 · 큐 대기 |
| 스토리지 | 버퍼 대기 · 활성 배치 |
| 메세징 | KAFKA · MQTT |
| 스트리밍 | 처리 건수 · 타임아웃 |
| 비동기 실행기 | 활성 · 대기 |
| 진단 | 경고 · 심각 |
| 캐시 | HIT · MISS |
④ 데이터 트래픽
초당 바이트를 큰 숫자로 보여 주고 그 아래 스파크라인이 붙습니다.
⑤ 클러스터
| 열 | 표시 |
|---|---|
| 상태 | 노드 상태 점 |
| 노드 IP | |
| 읽기 | 읽기 | 쓰기 지연 (ops/s) |
| 스토리지 | 노드가 쓰고 있는 용량 |
머리에 총 클러스터 N 노드, 아래에 마지막 갱신 시각이 나옵니다.
⑥ 시스템 진단
헬스 타임라인(정상 · 정보 · 경고 · 심각 네 범례)과 최근 진단 목록이 함께 있습니다.
각 줄에 발생 시각·상대 시각과 출처 뱃지(SERVER / EDGE)가 붙어, 플랫폼에서 난 것인지
현장 엣지에서 올라온 것인지 바로 갈립니다. 자세한 조회는
진단 화면에서 합니다.
예전 이 화면에는 데이터소스별 색 블록을 격자로 늘어놓은 연결 히트맵이 있었지만 지금은 그려지지 않습니다(메시지 문구만 남아 있습니다). 연결별 상태를 격자로 보려면 연결 상태 화면 의 데이터소스 카드 그리드를 쓰세요.
로그 화면 (/log/index)
서버 애플리케이션의 코드 레벨 로그(클래스·메소드·라인)를 시간순으로 조회합니다. /diagnostic/index 의 진단 로그와 달리 개발자/관리자가 디버깅에 사용 하는 상세 로그입니다.
상단 검색 영역
📋 로그 [기간 ▭▭▭▭] [레벨 ▼] [건수 ▼] [조회] [전체 출력] [↻]
| 컨트롤 | 폭 | 설명 |
|---|---|---|
기간 (search_time) | 280px | 시작~종료 (가운데 정렬, 굵은 글씨) |
레벨 (level) | 100px | 전체 레벨/INFO/WARN/ERROR |
메세지 (message) | 250px (숨김 기본) | 키워드 검색. 운영 환경에 따라 노출 |
건수 (limit) | 130px | 50/100/200/300/500/1,000 |
| 조회 | 빨강 + 🔍 | search() |
| 전체 출력 | 빨강 + 📄 | downloadCSV() — 검색 조건의 전체 로그를 CSV |
새로고침 (realtime_icon) | 빨강 + ↻ | refresh() |
hidden 필드
app_name의 기본값은SERVER입니다. 즉 이 화면은 서버 애플리케이션 로그만 조회합니다.
타임라인 + 빠른 시간 범위
진단 화면과 동일한 6 버튼 빠른 시간 범위(10M/30M/1H/6H/12H/ALL) 와 타임라인(alarm_timeline).
로그 테이블 (6컬럼)
진단 화면보다 한 단계 더 깊은 코드 레벨 정보를 표시합니다.
| 컬럼 | 폭 | 설명 |
|---|---|---|
| 레벨 | 80px | INFO/WARN/ERROR 색상 뱃지 |
| 시간 | 160px | 로그 발생 시각 |
| 로그 클래스 | 200px | 자바 클래스 풀네임 |
| 메소드 명 | 120px | 호출된 메소드 |
| 라인 넘버 | 80px | 소스 코드의 라인 번호 |
| 메세지 | 자동 | 로그 본문 + stack trace (있을 때) |
로그 클래스/메소드/라인 정보는 시스템 관리자가 코드 위치를 정확히 짚어 디버깅할 때 유용합니다. 일반 운영 이상 신호 추적은 진단 화면이 더 적합합니다.
설정 화면 (/config/index)
시스템 동작에 필요한 키-값 설정을 추가·수정·삭제하고, 캐시를 재적용하는 화면입니다.
주소 설정
사람이 브라우저에 치는 주소는 플랫폼이 스스로 알 수 없으므로 여기에 넣습니다. 비워서 저장할 수 있습니다.
| 설정 키 | 쓰임 | 비우면 |
|---|---|---|
PP_UI_CONSOLE_URL | 콘솔 주소. 알람 메일의 «알람 확인하러 가기» 링크와 QR 라벨에 들어갑니다 | 메일은 링크 없이 나가고, QR 라벨은 코드를 그리지 않습니다 |
PP_UI_FRONTLINE_URL | 현장 앱 주소. QR 공개 페이지의 «frontline 에서 열기» 버튼이 갑니다 | 버튼을 숨깁니다 |
값은 https://plantpulse.example.com 처럼 http(s) 로 시작하는 절대 주소입니다. 뒤의 / 는 잘려 저장되고, 쿼리나 # 이 붙으면 거절됩니다.
메일 서버 설정(MAIL_*)도 이 화면에서 합니다 — 메일 설정.
상단 도구
🎚️ 시스템 설정 [설정 키 검색 ...] [조회] [↻] | [➕ 설정 추가] [🔄 재적용]
| 컨트롤 | 폭 | 설명 |
|---|---|---|
설정 키 검색 (search_keyword) | 200px | placeholder: "설정 키 검색 ..." |
| 조회 | 빨강 + 🔍 | search() — 키워드 필터 적용 |
| 새로고침 | 빨강 + ↻ | refresh() |
| 설정 추가 | 빨강 + ➕ | addConfig() — 새 설정 추가 폼 열기 |
| 재적용 | 파랑 + 🔄 | refreshCache() — 서버 재시작 없이 설정 캐시 재적용 (툴팁: "서버 재시작 없이 설정 캐시를 재적용합니다.") |
설정 목록 테이블
| 컬럼 | 폭 | 설명 |
|---|---|---|
| 설정 키 | 300px | 시스템이 인식하는 키 (예: engine.timeout.ms) |
| 설정 값 | 600px | 키의 현재 값 |
| 설명 | 자동 | 키 용도 메모 |
| 수정일 | 150px | 마지막 수정 시각 |
| 액션 | 80px | 수정·삭제 버튼 |
페이지 하단에 안내 박스가 표시됩니다.
ℹ️ 시스템 설정 안내 시스템 동작에 필요한 키-값 설정을 관리합니다. 설정 변경 후 일부 항목은 서버 재시작이 필요할 수 있습니다.
설정 추가/수정 양식
상단 설정 추가 또는 목록의 액션으로 설정 양식 화면(/config/form)으로 이동합니다.
| 입력 | 설명 |
|---|---|
| 설정 키 | 영문/숫자/./_ 만 사용. 예: engine.timeout.ms |
| 설정 값 | 텍스트 (숫자·boolean·JSON 모두 가능, 키 정의에 따라 다름) |
| 설명 | 자유 텍스트 (운영자가 식별 용이하도록 메모) |
저장 후 즉시 반영하려면 목록 화면으로 돌아와 재적용 을 누르세요. 일부 설정은 서버 재시작이 필요할 수 있습니다.
환경정보 화면 (/env/view)
플랫폼이 부팅 시 읽어 들이는 프로퍼티 파일들을 그룹별 탭으로 조회하는 읽기 전용 화면입니다.
상단 안내 박스
❓ 시스템 환경 정보 서버 시스템에 설정된 환경 정보를 프로퍼티 파일별로 표시합니다. 환경 설정 변경은 각 파일을 수정하십시오.
- 설정이 변경되면 서버를 재시작해야 합니다.
6 탭 구성
| 탭 | 표시 |
|---|---|
| 엔진 | 엔진 코어 동작 설정 (시간/스레드/큐 한계 등) |
| 애플리케이션 | 웹 애플리케이션 일반 설정 |
| 메시지 큐 | 메시지 채널 연결 설정 (브로커 호스트·인증·토픽 등) |
| 스토리지 | 시계열·이벤트 저장소 연결 설정 |
| 메일 | 이메일 발송 SMTP 설정 |
| 웹소켓 | 실시간 푸시 채널 설정 |
각 탭의 표 (공통)
| 컬럼 | 표시 |
|---|---|
| 키 | 프로퍼티 키 |
| 설정값 | 현재 값 (마스킹된 비밀번호는 *** 로 표시) |
환경정보 화면에서는 값을 수정할 수 없습니다. 변경이 필요하면 시스템 관리자가 서버의 해당 프로퍼티 파일을 직접 수정한 후 서버를 재시작해야 합니다.
활용 시나리오
| 시나리오 | 화면 | 절차 |
|---|---|---|
| PPS가 평소보다 떨어진다 | 모니터링 | PPS 패널 차트 → 인프라 헬스 5칸 → 데이터 파이프라인 다이어그램의 병목 노드 식별 |
| GC가 길다 / 메모리 누수 의심 | 모니터링 | JVM 힙 패널의 GC 시간 추이 → 시스템 관리자 통보 |
| 서버 시작 직후 정상 가동 확인 | 모니터링 | 부제의 시작 시각 + 인프라 헬스 5칸 모두 정상 + 파이프라인 노드에 숫자가 오르는지 |
| 특정 클래스에서 ERROR 추적 | 로그 | 레벨=ERROR + 메시지 검색에 클래스명 키워드 → 라인 번호 포함 로그 분석 |
| 일시적으로 설정 변경 적용 | 설정 | 설정 추가/수정 → 재적용 (재시작 없음) |
| 비밀번호 정책·세션 시간 변경 | 환경정보 | 애플리케이션 탭에서 현재 값 확인 → 시스템 관리자가 파일 수정 → 서버 재시작 |
| 어느 연결이 죽었는지 찾기 | 연결 관리 | 상태 화면 의 데이터소스 카드 그리드 → 카드 클릭 → 상세 |
자주 묻는 질문
Q. 모니터링 화면이 진단 화면과 무엇이 다른가요? A. 모니터링 은 플랫폼 자체의 실시간 운영 메트릭(처리량·메모리·헬스), 진단 은 모듈별 INFO/WARN/ERROR 이벤트 로그입니다. 둘 다 시스템 관리자가 사용하지만 모니터링은 "지금 어떤가?", 진단은 "무슨 일이 있었나?" 에 답합니다.
Q. 모니터링의 인프라 헬스가 한 칸이라도 빨간색입니다. A. 해당 컴포넌트가 응답하지 않거나 헬스 체크 실패 상태입니다. 즉시 진단 화면에서 SERVER 또는 해당 컴포넌트의 ERROR 로그를 확인하시고, 동시에 시스템 관리자에게 통보하세요.
Q. 데이터 파이프라인 다이어그램의 노드가 회색입니다. A. 그 단계가 활성화되지 않았거나 처리 데이터가 없는 상태입니다. 평상시 회색이 정상인 단계도 있고(예: 백업·아카이빙), 인입 시간대인데 회색이면 문제일 수 있습니다.
Q. 예전에 있던 «연결 히트맵» 이 안 보입니다.
A. 모니터링 화면에서 빠졌습니다. 연결별 상태는 연결 관리 > 상태 화면의 데이터소스 카드 그리드에서 보고, 카드를 클릭하면 상세 화면(/connect/view)으로 갑니다.
Q. 로그 화면과 진단 화면은 어느 쪽을 봐야 하나요? A. 이상 신호 추적은 진단, 코드 레벨 디버깅은 로그입니다. 진단에서 ERROR 가 잡혔는데 메시지가 부족하면 같은 시각에 로그 화면에서 그 클래스/메소드의 상세 로그를 추가로 보세요.
Q. 설정 화면의 "재적용" 버튼은 안전한가요? A. 서버 재시작 없이 메모리 캐시만 새로고침합니다. 대부분의 설정에 안전하지만 일부 설정(스레드 풀 크기·DB 연결 풀 등)은 재시작이 필요합니다. 재적용 후 의도한 동작이 안 되면 시스템 관리자에게 문의하세요.
Q. 환경정보의 값을 화면에서 바꾸고 싶어요. A. 환경정보 화면은 읽기 전용입니다. 변경은 서버 측 프로퍼티 파일을 수정 후 서버를 재시작해야 합니다. 화면에서 변경 가능한 키-값은 설정 화면에서 관리합니다.
Q. 로그의 "전체 출력" CSV 가 너무 큽니다. A. 검색 조건의 기간을 짧게(1시간 이내), 레벨을 ERROR/WARN 으로 좁혀 다시 다운로드하세요. 또는 CSV 다운로드 후 외부 분석 도구로 가져가세요.
Q. 모니터링 화면이 자동으로 갱신되나요? A. 모니터링은 실시간 푸시로 자동 갱신됩니다. 메트릭이 멈춰 있다면 헤더의 실시간 연결 상태가 빨강인지 먼저 확인하세요.