모바일 순회 점검 (/m/dashboard)
폰을 들고 현장을 돌면서 수집이 정상인지 확인하는 보기 전용 모바일 화면입니다. 라인·설비를 순회하며 게이트웨이 상태, 연결별 수집 상태, 태그 현재값을 현장 계기판과 대조하고, 방금 난 오류를 확인할 수 있습니다.
폰 브라우저로 로그인하면 자동으로 모바일 상태 화면(/m/dashboard)이 열립니다. PC 브라우저는 기존 데스크톱 화면 그대로입니다.
모바일 화면에서는 아무것도 바꿀 수 없습니다 — 태그 값 쓰기, 수집 시작/정지, 설정 변경, 삭제 모두 불가합니다. 일부러 이렇게 만들었습니다. 폰을 잃어버리거나 주머니 속에서 잘못 눌려도 설비에 영향이 0 이기 때문입니다. 조치가 필요하면 데스크톱 화면에서 하세요.
1. 시작하기 전에 (전제 조건)
| 조건 | 내용 |
|---|---|
| 네트워크 | 폰이 게이트웨이와 같은 공장 망(현장 Wi-Fi)에 있어야 합니다. 플랫폼을 경유한 원격 접속 기능은 없습니다 — 사무실 LTE/5G 로 외부에서 보는 용도가 아닙니다 |
| 계정 | 데스크톱과 같은 계정·같은 로그인입니다. 모바일 전용 계정이나 별도 설정은 없습니다 |
| 주소 | 폰 브라우저에서 https://<게이트웨이 IP>/ 접속 → 로그인 → 자동으로 모바일 화면 |
로그인하지 않은 상태로 접속하면 로그인 화면으로 이동하고, 보던 중 세션이 만료되면 자동으로 로그인 화면으로 돌아갑니다.
2. 인증서 경고 없애기 (최초 1회)
게이트웨이의 HTTPS 는 자체서명(사설) 인증서를 사용합니다. 그래서 폰 브라우저가 "이 연결은 비공개 연결이 아닙니다" / "주의 요함" 경고를 띄웁니다. 고장이 아니며, 아래 두 방법 중 하나로 해결하는 운영 절차입니다.
방법 B(예외 등록)는 빠르지만 브라우저 정책에 따라 경고가 다시 나타날 수 있습니다. 순회에 매일 쓰는 폰이라면 방법 A 를 한 번 해두는 것이 깔끔합니다.
방법 A — 사내 CA 인증서를 폰에 설치 (경고가 사라짐)
먼저 게이트웨이 인증서를 발급한 사내 CA(루트) 인증서 파일(.crt 또는 .pem)을 설치 담당자에게 받아, 메일·메신저·AirDrop 등으로 폰에 전달받으세요.
iOS (Safari)
- 받은 인증서 파일을 탭 → "프로파일이 다운로드됨" 안내가 뜹니다.
- 설정 > 일반 > VPN 및 기기 관리 → 다운로드된 프로파일 → 설치.
- 설정 > 일반 > 정보 > 인증서 신뢰 설정 → 방금 설치한 루트 인증서의 신뢰 스위치를 켭니다. (이 단계를 빼먹으면 경고가 계속 나옵니다)
Android (Chrome)
- 설정 > 보안(보안 및 개인정보 보호) > 기타 보안 설정(또는 "암호화 및 사용자 인증 정보") > 인증서 설치 > CA 인증서 로 이동합니다.
- "그래도 설치" 를 선택하고 받은 인증서 파일을 고릅니다.
iOS/Android 버전과 제조사에 따라 메뉴 이름이 약간 다를 수 있습니다. 설정 검색창에 "인증서" 를 입력하면 해당 메뉴를 바로 찾을 수 있습니다.
방법 B — 브라우저 예외 등록 (빠르지만 경고가 다시 나올 수 있음)
- Android Chrome: 경고 화면에서 고급 → <주소>(으)로 이동(안전하지 않음).
- iOS Safari: 경고 화면에서 세부사항 보기 → 웹 사이트 방문 → 확인.
3. 화면 다섯 개
하단 탭바(상태 / 연결 / 검색 / 로그 / 데스크톱)로 이동합니다.
| 화면 | 경로 | 무엇을 보나요 |
|---|---|---|
| 상태 | /m/dashboard | 게이트웨이 종합 상태 — 전송 속도, 대기 큐, 오늘 오류, CPU/메모리/디스크, PLC 연결/끊김 수 |
| 연결 | /m/opc | 연결(PLC) 목록 — 문제 있는 연결이 맨 위, [전체/문제] 토글 |
| 태그 값 | /m/opc/<연결ID> | 그 연결의 태그 현재값 — 값·단위 크게, 경과시간 항상 동반 |
| 검색 | /m/search | 태그 ID/이름으로 전역 검색 — 결과에 현재값·경과시간 동반 |
| 로그 | /m/log | 최근 ERROR/WARN 기록 — "방금 뭐가 났나" 확인용 |
상태 화면의 문제 지표는 눌러서 바로 이동할 수 있습니다 — 오늘 오류 카드 → 로그 화면, PLC 연결/끊김 숫자 → 연결 목록.
4. 가장 중요한 것 — 값의 나이(경과시간)
값이 보인다고 수집이 살아있는 게 아닙니다. 화면의 값이 10분 전 것이라면 그 사이 수집은 죽어 있었던 겁니다. 순회 점검에서 가장 위험한 오판이 "값이 보이니 정상"입니다.
그래서 모바일 화면은 모든 값 옆에 언제 수집된 값인지(경과시간)를 항상 같이 보여주고, 오래된 값은 눈에 띄게 죽입니다.
| 경과시간 | 표시 |
|---|---|
| 1분 이내 | 값이 선명하게 (정상) |
| 1분 ~ 10분 | 값이 회색으로 — 수집 주기에 비해 오래됐는지 의심 |
| 10분 초과 | 값이 흐리게 + 경과시간이 주황색 — 수집이 멈춘 것으로 간주하고 확인 |
값을 볼 때는 값 → 경과시간 순서로 두 가지를 항상 같이 읽는 습관을 들이세요.
5. 세 가지 상태 구분하기
현장 Wi-Fi 는 통로나 기둥 뒤에서 끊깁니다. "값이 이상하다"가 설비(수집) 문제인지, 내 폰 네트워크 문제인지 구분하지 못하면 멀쩡한 설비를 쫓아다니거나 진짜 이상을 놓칩니다. 화면은 세 상태를 다르게 표시합니다.
| 상태 | 화면 표시 | 해야 할 일 |
|---|---|---|
| 정상 | 값 선명 + 경과시간 짧음. 배너 없음 | 다음 설비로 |
| 수집 이상 (게이트웨이는 응답하지만 데이터가 나쁨) | 배너 없음. ERROR 태그가 목록 맨 위로 + 오류 메시지 표시, 또는 경과시간이 길어 값이 흐려짐. 연결 목록에서 해당 연결이 위로 올라옴 | 연결 화면에서 연결상태/스캔상태 확인 → 데스크톱에서 조치 |
| 통신 두절 (폰이 게이트웨이에 못 닿음) | 화면 상단에 배너 "통신이 끊겼습니다 — 아래 값은 N초 전 데이터입니다" + 화면 전체 값이 일괄 흐려짐. 마지막 값은 지워지지 않고 유지됨 | 설비 문제가 아닐 가능성이 큽니다. 전파가 잘 잡히는 곳으로 이동해 배너가 걷히는지 확인 |
핵심 구분법: 배너가 떠 있으면 폰↔게이트웨이 문제, 배너 없이 특정 태그/연결만 이상하면 수집 문제입니다.
통신이 끊겨도 마지막 값을 흐리게 유지하고 배너에 데이터의 나이를 계속 갱신해 보여줍니다. 화면을 비워버리면 설비가 죽은 것으로 착각하기 쉽기 때문입니다. 배너는 순간적인 끊김에는 뜨지 않고 2회 연속 갱신에 실패했을 때부터 뜨며, 통신이 복구되면 자동으로 사라집니다. (연결·태그 값·검색·로그 화면에서 동작합니다)
6. 각 화면 자세히
상태 (/m/dashboard)
전송 속도(MPS) / 대기 큐 / 오늘 오류 / 전송 포인트 카드, CPU·메모리·스왑·디스크 게이지, PLC 연결/끊김·읽기/쓰기 성공/실패 수, 플랫폼 API·도커 상태를 1초마다 갱신합니다. 우측 상단에 로그아웃 버튼이 있습니다.
연결 (/m/opc)
카드 한 장이 연결 하나입니다 — 연결 이름, 프로토콜·IP:포트, 연결상태/스캔상태/태그 수 뱃지. 끊김·수집정지 연결이 항상 맨 위로 정렬되고, 상단 [전체 N / 문제 N] 버튼으로 문제 연결만 추려 볼 수 있습니다. 카드를 누르면 그 연결의 태그 값 화면으로 들어갑니다. 10초마다 갱신합니다.
연결상태가 정상(CONNECTED)이어도 스캔상태가 수집 중이 아니면(NOT COLLECT) 값은 들어오지 않습니다. 이 상태의 카드는 문제로 분류되어 위로 올라오니, 뱃지 두 개를 모두 확인하세요.
태그 값 (/m/opc/<연결ID>)
태그별로 값과 단위를 크게, 경과시간을 아래에 함께 보여줍니다. ERROR 상태 태그가 맨 위로 오고 오류 메시지가 같이 표시됩니다. 5초마다 갱신합니다.
태그가 아주 많은 연결은 상위 300개까지만 표시하고 화면 상단에 "상위 300개만 표시 — 전체 목록은 데스크톱에서 보세요" 안내가 나옵니다. 안 보이는 태그를 "정상"으로 넘기지 말고, 특정 태그를 봐야 하면 검색을 쓰세요.
검색 (/m/search)
태그 ID 또는 이름 부분일치(대소문자 무관)로 게이트웨이 전체 태그를 검색합니다. 입력하면 자동으로 검색되고, 결과(최대 50건)에 현재값과 경과시간이 함께 나옵니다. 현장 계기판과 특정 태그를 대조할 때 목록을 뒤지는 것보다 빠릅니다.
로그 (/m/log)
최근 24시간의 로그를 최신순으로 50건 보여줍니다. 상단 [ERROR / WARN] 버튼으로 레벨을 고르며 기본은 ERROR, 15초마다 갱신합니다.
WARN 을 누르면 ERROR 는 보이지 않습니다 ("WARN 이상"이 아닙니다). 오류를 보려면 ERROR 버튼인지 확인하세요. 기간 지정·메시지 검색 등 자세한 로그 확인은 데스크톱의 시스템 로그 보기에서 합니다.
7. 조치는 데스크톱에서
수집 시작/정지, 태그 쓰기, 연결·태그 편집, 설정 변경은 모두 데스크톱 화면에서 합니다.
- 폰에서도 하단 탭바의 [데스크톱] 을 누르면 데스크톱 화면(
/ui/main?desktop=1)이 열립니다 — 순회 중 설정을 급히 확인할 때 유용합니다. 다만 데스크톱 화면은 폰 크기에 최적화되어 있지 않으므로 편집 작업은 PC 에서 하시는 걸 권장합니다. - 폰은 원래 모바일 화면으로 자동 이동하므로,
?desktop=1없이/ui/main을 열면 다시 모바일 상태 화면으로 돌아갑니다.
8. 알려진 제한
| 제한 | 내용 |
|---|---|
| 당겨서 새로고침 없음 | 화면을 아래로 당겨도 갱신되지 않습니다. 자동 갱신(위 주기)에 맡기거나 브라우저 새로고침을 쓰세요 |
| 로그는 최근 50건 고정 | "더 보기"가 없습니다. 그 이상은 데스크톱 시스템 로그 보기 |
| 태그 값 화면 상위 300개 | 큰 연결은 잘려서 표시되며 안내문이 나옵니다. 전체 목록은 데스크톱 |
| 연결 200개 / 검색 결과 50건 | 목록·검색도 상한이 있습니다 |
| 화면이 꺼지면 갱신도 멈춤 | 연결·태그 값·로그 화면은 폰 화면을 끄거나 다른 앱으로 가면 갱신을 멈추고(배터리·현장 Wi-Fi 절약), 돌아오면 자동 재개합니다 |
| 알림/푸시 없음 | 이 화면은 능동적으로 돌며 확인하는 용도입니다. 이상을 알아서 알려주지 않습니다 |
9. 자주 빠지는 함정
| 증상 | 원인 / 해결 |
|---|---|
| 접속할 때마다 인증서 경고 | 자체서명 인증서 — 고장 아님. 2. 인증서 경고 없애기 절차로 해결 |
| 폰에서 화면이 아예 안 열림 | 폰이 공장 망(현장 Wi-Fi)에 붙어 있는지 확인 — LTE/5G 로는 접속되지 않습니다 |
| 값이 보이는데 계속 안 변함 | 경과시간을 보세요. 오래됐으면 수집 이상 — 연결 화면에서 상태 확인 |
| 갑자기 모든 값이 흐려지고 상단에 배너 | 통신 두절 — 대개 폰 Wi-Fi 문제. 전파 좋은 곳으로 이동 |
| WARN 을 눌렀는데 ERROR 가 안 보임 | 레벨 버튼은 그 레벨만 표시 — ERROR 버튼으로 |
| 태그가 다 안 보임 | 상위 300개 잘림 — 검색으로 특정 태그를 찾거나 데스크톱에서 |
| 로그인 화면으로 자꾸 튕김 | 세션 만료 — 다시 로그인 (데스크톱과 같은 계정) |
10. 더 알아보기
- 데스크톱에서 실시간 값 보기: 실시간 값 보기
- 연결 목록 / 태그 목록 (데스크톱): 연결 목록 / 태그 목록
- 시스템 로그 상세 검색: 시스템 로그 보기
- 연결이 안 될 때: 문제 해결