관제
관제는 센터가 지금 정상인지 한 화면에서 점검하는 곳입니다. 외부 연결 상태, 요원별 현황, 쌓인 기록 수, 연결 창구 로그, 센터 안에서 난 오류를 위에서 아래로 차례로 보여 줍니다.
언제 쓰나요
관제는 “지금 센터가 정상인가?”에 답하는 점검 화면이고, 이상하다 싶을 때 가장 먼저 여는 곳입니다. 요원이 응답이 없거나, 밖에서 센터에 접속이 안 되거나, 같은 오류가 반복될 때 원인이 연결 쪽인지 요원 쪽인지 가려낼 수 있습니다. 사이드바 시스템 줄의 ‘관제’ 버튼으로 엽니다.
화면을 열면 자동으로 한 번 조회하고, 그 뒤 5분마다 저절로 새로 고쳐집니다. 화면을 다른 곳으로 옮기면 갱신도 멈춥니다.
assets/turtlecenter/ui-control-room-1.png · 권장 크기 1600×900맨 위 새로고침 줄, 상태 카드 세 장, 가운데 세 구역(요원 현황 · 업무 데이터 · Edge 로그), 아래 예외 로그가 모두 보이는 화면. 구역마다 번호 표시를 넣을 예정입니다.화면 구성
| 순서 | 구역 | 무엇을 보여 주나요 |
|---|---|---|
| 1 | 맨 위 줄 | 왼쪽에 ‘마지막 조회: 시각’, 오른쪽에 새로고침 버튼 |
| 2 | 상태 카드 3장 | ngrok, 엣지, 터틀게이트의 연결 상태 |
| 3 | 요원 현황 | 센터 요원별 상태, 대기 큐, 현재 작업 |
| 4 | 업무 데이터 | 기록실 항목별 레코드 수 |
| 5 | Edge 로그 | 연결 창구(엣지)가 남긴 최근 기록 |
| 6 | 예외 로그 | 센터 안에서 오류가 났다가 처리된 기록과 상세 칸 |
맨 위 줄: 마지막 조회와 새로고침
‘마지막 조회’는 위 카드들을 마지막으로 확인한 시각이고, 새로고침 버튼은 그것을 바로 다시 확인합니다. 조회가 진행되는 동안에는 버튼이 잠시 눌리지 않습니다. 조회에 실패하면 ‘마지막 조회: 실패 · 잠시 후 다시 시도하세요’로 바뀝니다. 기록실 레코드 수만 실패한 경우에는 같은 줄 끝에 ‘건수 조회 실패 시각’이 덧붙습니다.
상태 카드 3장
카드는 센터가 일하는 데 필요한 연결 세 가지를 하나씩 확인해서 색과 문구로 알려 줍니다. 카드 한 장은 네 줄로 되어 있습니다. 이름, ‘상태 · 세부 문구’, ‘조회 시각’, 그리고 해야 할 조치입니다.
| 카드 | 무엇을 확인하나요 | 확인 방법 |
|---|---|---|
| ngrok | 바깥에서 센터로 들어오는 터널이 열려 있는가 | 공개 주소로 접속 확인 신호를 보내 5초 안에 응답이 오는지 봅니다. 응답이 없으면 ngrok 연결 서비스의 상태를 대신 씁니다. |
| 엣지 | 센터의 연결 창구가 응답하는가 | 같은 컴퓨터의 엣지 창구(포트 5714)에 상태를 묻고, 5초 안에 ‘준비됨’ 답이 오면 정상으로 봅니다. |
| 터틀게이트 | 설치 인증과 등록 창구와 연결돼 있는가 | 확인필요 현재 소스에서는 이 카드가 상태를 조회하지 않고 ‘미확인 · 조회 실패’로 표시됩니다. 연결 조회가 들어가면 갱신합니다. |
카드의 상태와 색
| 상태 | 색 | 뜻 | 카드 맨 아래 조치 문구 |
|---|---|---|---|
| 정상 | 초록 | 문제 없이 동작 중 | 정상 동작 중 |
| 시작 중 | 노랑 | 켜지거나 연결되는 중 | 시작 완료를 기다리는 중 |
| 주의 | 노랑 | 동작은 하지만 확인이 필요함 | 상세 로그를 확인하세요 |
| 중단 | 빨강 | 멈춰 있음 | 서비스 상태를 확인하세요 |
| 지연 | 회색 | 정보가 오래됨 | 새로고침이 필요합니다 |
| 미확인 | 회색 | 아직 확인하지 못함 | 상태 정보를 확인하는 중 |
카드 세부 문구
| 카드 | 상태 · 세부 문구 | 뜻 |
|---|---|---|
| ngrok | 정상 · 연결됨 | 공개 주소가 응답하거나, 연결 서비스가 연결됨으로 보고함 |
| ngrok | 주의 · 연결됨 · 인증 필요 | 터널은 열려 있으나 공개 주소가 인증을 요구함 |
| ngrok | 시작 중 · 연결 중 | 터널을 여는 중 |
| ngrok | 중단 · 연결 안 됨 | 터널이 닫혀 있거나 아직 설정하지 않음 |
| ngrok | 주의 · 인증 필요 | ngrok 쪽 인증이 필요함 |
| ngrok | 주의 · 상태 이상 | 연결에 실패한 상태로 보고됨 |
| 엣지 | 정상 · 응답 정상 | 엣지가 ‘준비됨’으로 답함 |
| 모든 카드 | 미확인 · 조회 실패 | 응답이 없거나 조회 중 오류. 5초 안에 답이 없을 때도 같습니다. |
요원 현황
요원 현황은 센터 요원마다 한 줄로 지금 상태와 밀린 일을 보여 줍니다. 이름순으로 정렬되고, 센터가 직접 운영하는 요원이 대상입니다.
| 열 | 의미 |
|---|---|
| 요원 | 요원 이름 |
| 상태 | 연결 · 작업 중 · 수신 · 한도 도달 · 장애 · 미확인 (아래 표 참조) |
| 대기 큐 | 그 요원의 수신함에 쌓인 처리 전 메시지 수. 알 수 없으면 ‘—’ |
| 현재 작업 | 지금 일을 처리하는 중이면 ‘작업 중’, 아니면 ‘대기’ |
| 상태 값 | 뜻 |
|---|---|
| 연결 | 준비됨. 새 일을 받을 수 있음 (사이드바 불의 파랑에 해당) |
| 작업 중 | 일을 받아 처리하는 중 |
| 수신 | 메시지를 막 받은 상태 |
| 한도 도달 | 사용 중인 AI 서비스의 사용 한도를 다 씀 |
| 장애 | 요원이나 연결에 문제가 있음 |
| 미확인 | 아직 상태를 알 수 없음 |
한 요원의 대기 큐만 계속 늘어난다면 그 요원의 방을 열어 상태를 확인하세요. 사이드바 불의 색 뜻은 화면 개요에 있습니다.
업무 데이터
업무 데이터는 기록실에 쌓인 항목별 레코드 수를 보여 주는 두 열짜리 표입니다. 열은 ‘항목’과 ‘레코드 수’입니다. 처음에는 ‘조회 대기’가 보이고, 조회에 실패하면 ‘조회 실패’로 바뀝니다. 항목 안을 보려면 기록실을 여세요.
Edge 로그
Edge 로그는 연결 창구가 주고받은 일을 시간 역순으로 보여 주는 표입니다. 연결 창구의 로그 파일에서 가장 최근 200건을 읽습니다. 5분마다 자동으로 갱신됩니다.
| 열 | 의미 |
|---|---|
| 발생 시각 | 기록된 시각 |
| 등급 | ERROR는 빨강, WARN은 노랑, 그 밖은 하늘색 |
| 활동 | 어떤 종류의 동작인지 |
| 단계/결과 | 어느 단계에서 어떻게 끝났는지 |
관제에서는 표만 보이고 요원 필터와 새로고침, 비우기 버튼은 보이지 않습니다. 줄을 선택하면 보낸 쪽, 받는 쪽, 내용 미리보기, 상세 내용까지 모은 전체 설명이 아래 예외 로그 구역의 상세 칸에 나타납니다.
assets/turtlecenter/ui-control-room-2.png · 권장 크기 1600×900가운데 세 구역을 확대한 화면. 요원 현황에 ‘작업 중’과 ‘대기’가 함께 보이면 좋습니다.예외 로그
예외 로그는 센터 안에서 오류가 났을 때 센터가 어떻게 대처했는지 남긴 기록표입니다. 오류와 경고만 보여 주고, 단순 정보 기록은 보여 주지 않습니다. 가장 최근 200건을 보여 주고 5분마다 자동 갱신합니다.
| 열 | 의미 |
|---|---|
| 발생 시각 | 오류가 난 시각 |
| 등급 | ERROR는 빨강, WARN은 노랑 |
| 에이전트 | 관련된 요원. 요원과 관계없는 오류는 ‘시스템’ |
| 구성요소 | 오류가 난 센터의 부분 |
| 작업 | 그때 하던 동작 |
| 예외 형식 | 오류의 종류 이름 |
| catch 메시지 | 오류가 남긴 문구 |
| 처리 결과 | 계속 · 취소 · 종료 · 실패 종료 |
| 상세 | 추가 설명 |
| 처리 결과 | 뜻 |
|---|---|
| 계속 | 오류를 처리하고 하던 일을 이어 갔습니다. |
| 취소 | 그 동작만 취소했습니다. |
| 종료 | 해당 동작을 마감하고 닫았습니다. |
| 실패 종료 | 안전을 위해 해당 동작을 실패로 닫았습니다. |
표 위에는 새로고침 버튼과 ‘최신 이벤트 시각 · 갱신 시각 · N건’ 안내가 있습니다. 조회에 문제가 있으면 안내 끝에 ‘DB 조회 실패’, ‘비상 로그 손상 N건’, ‘누락 N건’이 붙습니다. 열 제목을 누르면 정렬하고, 끌어서 열 순서를 바꿀 수 있습니다. 줄을 선택하면 아래 상세 칸에 시각, 등급, 요원, 구성요소/작업, 처리 결과, 예외 형식, 메시지, 상세가 한 번에 나옵니다.
작업 순서
요원이 응답하지 않을 때
- 관제를 열고 새로고침을 눌러 최신 상태로 맞춥니다.
- 요원 현황에서 그 요원의 상태와 대기 큐를 봅니다. 한도 도달이나 장애면 원인이 요원 쪽입니다.
- ‘연결’인데 대기 큐만 쌓이면 통신 모니터에서 메시지가 도착했는지 확인합니다.
- 예외 로그에서 같은 요원 이름이 나오는 줄을 찾아 상세 칸의 메시지를 확인합니다.
밖에서 센터에 접속이 안 될 때
- 상태 카드의 ngrok, 엣지를 봅니다.
- 엣지가 정상이고 ngrok이 ‘중단’이면 터널 문제입니다. 설정의 ‘외부 연결’에서 연결 상태를 확인합니다.
- 엣지가 ‘미확인’이면 센터의 연결 창구부터 확인해야 합니다.
알아 둘 점
- 관제는 보기 전용입니다. 요원을 켜거나 끄는 버튼은 없습니다.
- 5분마다만 갱신되므로 방금 바뀐 상태는 새로고침을 눌러야 보입니다.
- 같은 오류가 반복되면 처음 오류 문구와 발생 시각을 보관한 뒤 문제 해결의 안내를 따라 지원을 요청하세요.