분석 설정
분석 설정에서는 화면 이름, 고객·사업장 정보, 메뉴 구성과 분석 API 연결 주소를 관리합니다. 대부분의 항목은 애플리케이션 시작 시 읽히므로 저장 후 재시작이 필요합니다.
개요
설정 화면은 현재 구성값을 불러와 편집하고 저장합니다. 값이 잘못되면 분석 화면 전체가 데이터를 불러오지 못할 수 있으므로 변경 전 현재 주소와 적용 대상을 기록하십시오.
설정 항목
| 항목 | 설명 |
|---|---|
| 애플리케이션 이름 | 브라우저와 화면에 표시할 서비스 이름입니다. |
| 고객사·사업장 | 현재 설치 환경을 구분하는 표시값입니다. |
| 메뉴 구성 | 설치 목적에 맞는 탐색 메뉴 구성을 선택합니다. |
| ML API Server | 예측, 추천과 노드 실행 API 기본 주소입니다. |
| Echo API Server | Echo 서비스 실행 API 기본 주소입니다. |
설정 변경
- 현재 값을 별도로 기록합니다.
- 변경할 항목만 수정합니다.
- URL은 프로토콜, 호스트, 포트와 기본 경로를 확인합니다.
- 저장을 선택합니다.
- 성공 안내와 재시작 필요 표시를 확인합니다.
- 운영 중인 작업이 없는 시간에 서비스를 재시작합니다.
- 대시보드와 노드 화면에서 연결을 확인합니다.
API 주소 입력
ML API 예시는 http://localhost:5800/api 형식이며, Echo API는 서비스 루트 주소를 사용합니다. 운영 환경에서는 localhost가 아니라 실제 서비스 주소와 인증서 구성을 사용해야 합니다. 주소 끝의 경로와 슬래시 차이로 API가 404를 반환할 수 있으므로 배포 기준과 동일하게 입력합니다.
재시작 적용 시점
메뉴 구성과 API 클라이언트는 시작 시 설정을 읽어 구성됩니다. 저장 성공은 파일에 값이 기록됐다는 의미이며 현재 실행 중인 연결이 즉시 바뀌었다는 뜻은 아닙니다. 재시작 후 새 설정이 로드됐는지 화면에서 다시 확인하십시오.
변경 전 확인
- Trainer, Loader 또는 장시간 실행 작업이 없는지 확인합니다.
- 다른 사용자가 분석 화면을 사용 중인지 확인합니다.
- 되돌릴 수 있도록 기존 설정을 기록합니다.
- 운영과 시험 서버 주소를 혼동하지 않았는지 확인합니다.
문제 해결
| 상황 | 확인할 내용 |
|---|---|
| 저장이 실패함 | 설정 파일 쓰기 권한과 필수값을 확인합니다. |
| 저장했지만 화면이 그대로임 | 서비스를 재시작했는지 확인합니다. |
| 모든 분석 화면이 연결 실패함 | ML API 주소와 서버 상태를 확인합니다. |
| 일부 메뉴가 사라짐 | 선택한 메뉴 구성이 설치 목적과 맞는지 확인합니다. |
| 인증서 오류가 발생함 | HTTPS 인증서와 호스트명이 일치하는지 확인합니다. |
