미리보기 · 이 페이지 경로: ko/support/screens/control-room/
파람스 포털

관제

관제는 센터가 지금 정상인지 한 화면에서 점검하는 곳입니다. 외부 연결 상태, 요원별 현황, 쌓인 기록 수, 연결 창구 로그, 센터 안에서 난 오류를 위에서 아래로 차례로 보여 줍니다.

언제 쓰나요

관제는 “지금 센터가 정상인가?”에 답하는 점검 화면이고, 이상하다 싶을 때 가장 먼저 여는 곳입니다. 요원이 응답이 없거나, 밖에서 센터에 접속이 안 되거나, 같은 오류가 반복될 때 원인이 연결 쪽인지 요원 쪽인지 가려낼 수 있습니다. 사이드바 시스템 줄의 ‘관제’ 버튼으로 엽니다.

화면을 열면 자동으로 한 번 조회하고, 그 뒤 5분마다 저절로 새로 고쳐집니다. 화면을 다른 곳으로 옮기면 갱신도 멈춥니다.

이미지 자리 1 · 관제 전체파일명 assets/turtlecenter/ui-control-room-1.png · 권장 크기 1600×900맨 위 새로고침 줄, 상태 카드 세 장, 가운데 세 구역(요원 현황 · 업무 데이터 · Edge 로그), 아래 예외 로그가 모두 보이는 화면. 구역마다 번호 표시를 넣을 예정입니다.

화면 구성

순서구역무엇을 보여 주나요
1맨 위 줄왼쪽에 ‘마지막 조회: 시각’, 오른쪽에 새로고침 버튼
2상태 카드 3장ngrok, 엣지, 터틀게이트의 연결 상태
3요원 현황센터 요원별 상태, 대기 큐, 현재 작업
4업무 데이터기록실 항목별 레코드 수
5Edge 로그연결 창구(엣지)가 남긴 최근 기록
6예외 로그센터 안에서 오류가 났다가 처리된 기록과 상세 칸

맨 위 줄: 마지막 조회와 새로고침

‘마지막 조회’는 위 카드들을 마지막으로 확인한 시각이고, 새로고침 버튼은 그것을 바로 다시 확인합니다. 조회가 진행되는 동안에는 버튼이 잠시 눌리지 않습니다. 조회에 실패하면 ‘마지막 조회: 실패 · 잠시 후 다시 시도하세요’로 바뀝니다. 기록실 레코드 수만 실패한 경우에는 같은 줄 끝에 ‘건수 조회 실패 시각’이 덧붙습니다.

상태 카드 3장

카드는 센터가 일하는 데 필요한 연결 세 가지를 하나씩 확인해서 색과 문구로 알려 줍니다. 카드 한 장은 네 줄로 되어 있습니다. 이름, ‘상태 · 세부 문구’, ‘조회 시각’, 그리고 해야 할 조치입니다.

카드무엇을 확인하나요확인 방법
ngrok바깥에서 센터로 들어오는 터널이 열려 있는가공개 주소로 접속 확인 신호를 보내 5초 안에 응답이 오는지 봅니다. 응답이 없으면 ngrok 연결 서비스의 상태를 대신 씁니다.
엣지센터의 연결 창구가 응답하는가같은 컴퓨터의 엣지 창구(포트 5714)에 상태를 묻고, 5초 안에 ‘준비됨’ 답이 오면 정상으로 봅니다.
터틀게이트설치 인증과 등록 창구와 연결돼 있는가확인필요 현재 소스에서는 이 카드가 상태를 조회하지 않고 ‘미확인 · 조회 실패’로 표시됩니다. 연결 조회가 들어가면 갱신합니다.

카드의 상태와 색

상태색뜻카드 맨 아래 조치 문구
정상초록문제 없이 동작 중정상 동작 중
시작 중노랑켜지거나 연결되는 중시작 완료를 기다리는 중
주의노랑동작은 하지만 확인이 필요함상세 로그를 확인하세요
중단빨강멈춰 있음서비스 상태를 확인하세요
지연회색정보가 오래됨새로고침이 필요합니다
미확인회색아직 확인하지 못함상태 정보를 확인하는 중

카드 세부 문구

카드상태 · 세부 문구뜻
ngrok정상 · 연결됨공개 주소가 응답하거나, 연결 서비스가 연결됨으로 보고함
ngrok주의 · 연결됨 · 인증 필요터널은 열려 있으나 공개 주소가 인증을 요구함
ngrok시작 중 · 연결 중터널을 여는 중
ngrok중단 · 연결 안 됨터널이 닫혀 있거나 아직 설정하지 않음
ngrok주의 · 인증 필요ngrok 쪽 인증이 필요함
ngrok주의 · 상태 이상연결에 실패한 상태로 보고됨
엣지정상 · 응답 정상엣지가 ‘준비됨’으로 답함
모든 카드미확인 · 조회 실패응답이 없거나 조회 중 오류. 5초 안에 답이 없을 때도 같습니다.

요원 현황

요원 현황은 센터 요원마다 한 줄로 지금 상태와 밀린 일을 보여 줍니다. 이름순으로 정렬되고, 센터가 직접 운영하는 요원이 대상입니다.

열의미
요원요원 이름
상태연결 · 작업 중 · 수신 · 한도 도달 · 장애 · 미확인 (아래 표 참조)
대기 큐그 요원의 수신함에 쌓인 처리 전 메시지 수. 알 수 없으면 ‘—’
현재 작업지금 일을 처리하는 중이면 ‘작업 중’, 아니면 ‘대기’
상태 값뜻
연결준비됨. 새 일을 받을 수 있음 (사이드바 불의 파랑에 해당)
작업 중일을 받아 처리하는 중
수신메시지를 막 받은 상태
한도 도달사용 중인 AI 서비스의 사용 한도를 다 씀
장애요원이나 연결에 문제가 있음
미확인아직 상태를 알 수 없음

한 요원의 대기 큐만 계속 늘어난다면 그 요원의 방을 열어 상태를 확인하세요. 사이드바 불의 색 뜻은 화면 개요에 있습니다.

업무 데이터

업무 데이터는 기록실에 쌓인 항목별 레코드 수를 보여 주는 두 열짜리 표입니다. 열은 ‘항목’과 ‘레코드 수’입니다. 처음에는 ‘조회 대기’가 보이고, 조회에 실패하면 ‘조회 실패’로 바뀝니다. 항목 안을 보려면 기록실을 여세요.

Edge 로그

Edge 로그는 연결 창구가 주고받은 일을 시간 역순으로 보여 주는 표입니다. 연결 창구의 로그 파일에서 가장 최근 200건을 읽습니다. 5분마다 자동으로 갱신됩니다.

열의미
발생 시각기록된 시각
등급ERROR는 빨강, WARN은 노랑, 그 밖은 하늘색
활동어떤 종류의 동작인지
단계/결과어느 단계에서 어떻게 끝났는지

관제에서는 표만 보이고 요원 필터와 새로고침, 비우기 버튼은 보이지 않습니다. 줄을 선택하면 보낸 쪽, 받는 쪽, 내용 미리보기, 상세 내용까지 모은 전체 설명이 아래 예외 로그 구역의 상세 칸에 나타납니다.

이미지 자리 2 · 요원 현황과 업무 데이터파일명 assets/turtlecenter/ui-control-room-2.png · 권장 크기 1600×900가운데 세 구역을 확대한 화면. 요원 현황에 ‘작업 중’과 ‘대기’가 함께 보이면 좋습니다.

예외 로그

예외 로그는 센터 안에서 오류가 났을 때 센터가 어떻게 대처했는지 남긴 기록표입니다. 오류와 경고만 보여 주고, 단순 정보 기록은 보여 주지 않습니다. 가장 최근 200건을 보여 주고 5분마다 자동 갱신합니다.

열의미
발생 시각오류가 난 시각
등급ERROR는 빨강, WARN은 노랑
에이전트관련된 요원. 요원과 관계없는 오류는 ‘시스템’
구성요소오류가 난 센터의 부분
작업그때 하던 동작
예외 형식오류의 종류 이름
catch 메시지오류가 남긴 문구
처리 결과계속 · 취소 · 종료 · 실패 종료
상세추가 설명
처리 결과뜻
계속오류를 처리하고 하던 일을 이어 갔습니다.
취소그 동작만 취소했습니다.
종료해당 동작을 마감하고 닫았습니다.
실패 종료안전을 위해 해당 동작을 실패로 닫았습니다.

표 위에는 새로고침 버튼과 ‘최신 이벤트 시각 · 갱신 시각 · N건’ 안내가 있습니다. 조회에 문제가 있으면 안내 끝에 ‘DB 조회 실패’, ‘비상 로그 손상 N건’, ‘누락 N건’이 붙습니다. 열 제목을 누르면 정렬하고, 끌어서 열 순서를 바꿀 수 있습니다. 줄을 선택하면 아래 상세 칸에 시각, 등급, 요원, 구성요소/작업, 처리 결과, 예외 형식, 메시지, 상세가 한 번에 나옵니다.

작업 순서

요원이 응답하지 않을 때

  1. 관제를 열고 새로고침을 눌러 최신 상태로 맞춥니다.
  2. 요원 현황에서 그 요원의 상태와 대기 큐를 봅니다. 한도 도달이나 장애면 원인이 요원 쪽입니다.
  3. ‘연결’인데 대기 큐만 쌓이면 통신 모니터에서 메시지가 도착했는지 확인합니다.
  4. 예외 로그에서 같은 요원 이름이 나오는 줄을 찾아 상세 칸의 메시지를 확인합니다.

밖에서 센터에 접속이 안 될 때

  1. 상태 카드의 ngrok, 엣지를 봅니다.
  2. 엣지가 정상이고 ngrok이 ‘중단’이면 터널 문제입니다. 설정의 ‘외부 연결’에서 연결 상태를 확인합니다.
  3. 엣지가 ‘미확인’이면 센터의 연결 창구부터 확인해야 합니다.

알아 둘 점

  • 관제는 보기 전용입니다. 요원을 켜거나 끄는 버튼은 없습니다.
  • 5분마다만 갱신되므로 방금 바뀐 상태는 새로고침을 눌러야 보입니다.
  • 같은 오류가 반복되면 처음 오류 문구와 발생 시각을 보관한 뒤 문제 해결의 안내를 따라 지원을 요청하세요.

관련 화면

통신 모니터 · 기록실 · 설정 · 화면 개요