본문으로 건너뛰기
Documentation

분석 설정

마지막 게시: 2026-07-21 19:00

분석 설정

분석 설정에서는 화면 이름, 고객·사업장 정보, 메뉴 구성과 분석 API 연결 주소를 관리합니다. 대부분의 항목은 애플리케이션 시작 시 읽히므로 저장 후 재시작이 필요합니다.

개요

설정 화면은 현재 구성값을 불러와 편집하고 저장합니다. 값이 잘못되면 분석 화면 전체가 데이터를 불러오지 못할 수 있으므로 변경 전 현재 주소와 적용 대상을 기록하십시오.

설정 항목

항목 설명
애플리케이션 이름 브라우저와 화면에 표시할 서비스 이름입니다.
고객사·사업장 현재 설치 환경을 구분하는 표시값입니다.
메뉴 구성 설치 목적에 맞는 탐색 메뉴 구성을 선택합니다.
ML API Server 예측, 추천과 노드 실행 API 기본 주소입니다.
Echo API Server Echo 서비스 실행 API 기본 주소입니다.

설정 변경

  1. 현재 값을 별도로 기록합니다.
  2. 변경할 항목만 수정합니다.
  3. URL은 프로토콜, 호스트, 포트와 기본 경로를 확인합니다.
  4. 저장을 선택합니다.
  5. 성공 안내와 재시작 필요 표시를 확인합니다.
  6. 운영 중인 작업이 없는 시간에 서비스를 재시작합니다.
  7. 대시보드와 노드 화면에서 연결을 확인합니다.

API 주소 입력

ML API 예시는 http://localhost:5800/api 형식이며, Echo API는 서비스 루트 주소를 사용합니다. 운영 환경에서는 localhost가 아니라 실제 서비스 주소와 인증서 구성을 사용해야 합니다. 주소 끝의 경로와 슬래시 차이로 API가 404를 반환할 수 있으므로 배포 기준과 동일하게 입력합니다.

재시작 적용 시점

메뉴 구성과 API 클라이언트는 시작 시 설정을 읽어 구성됩니다. 저장 성공은 파일에 값이 기록됐다는 의미이며 현재 실행 중인 연결이 즉시 바뀌었다는 뜻은 아닙니다. 재시작 후 새 설정이 로드됐는지 화면에서 다시 확인하십시오.

변경 전 확인

  • Trainer, Loader 또는 장시간 실행 작업이 없는지 확인합니다.
  • 다른 사용자가 분석 화면을 사용 중인지 확인합니다.
  • 되돌릴 수 있도록 기존 설정을 기록합니다.
  • 운영과 시험 서버 주소를 혼동하지 않았는지 확인합니다.

문제 해결

상황 확인할 내용
저장이 실패함 설정 파일 쓰기 권한과 필수값을 확인합니다.
저장했지만 화면이 그대로임 서비스를 재시작했는지 확인합니다.
모든 분석 화면이 연결 실패함 ML API 주소와 서버 상태를 확인합니다.
일부 메뉴가 사라짐 선택한 메뉴 구성이 설치 목적과 맞는지 확인합니다.
인증서 오류가 발생함 HTTPS 인증서와 호스트명이 일치하는지 확인합니다.

수정 이력

이 문서의 변경 내역을 시간순으로 볼 수 있습니다.

표시할 수정 이력이 없습니다.

An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.