통신 모니터
통신 모니터는 메시지가 센터에 접수됐는지, 상대 요원의 대화에 실제로 나타났는지를 따로 보여 주는 화면입니다. “보냈는데 반응이 없다”는 의문을 풀 때 씁니다.
언제 쓰나요
통신 모니터는 보낸 메시지가 어디까지 갔는지 확인하는 화면입니다. 센터가 메시지를 받은 것(접수)과 상대 요원의 대화에 그 메시지가 실제로 나타난 것(착지)은 다른 일이기 때문에, 이 화면은 둘을 나눠서 보여 줍니다. 사이드바 시스템 줄의 ‘통신 모니터’ 버튼으로 엽니다.
assets/turtlecenter/ui-communication-monitor-1.png · 권장 크기 1600×900위쪽 탭 두 개(통신 흐름 · ngrok 모니터), 가운데 표, 아래 상세 칸이 보이는 화면. 초록 줄과 노랑 줄이 함께 보이면 좋습니다.접수와 착지, 무엇이 다른가요
접수는 센터가 메시지를 받아 순서표에 올린 단계이고, 착지는 상대 요원의 대화에 그 메시지가 사용자 입력으로 나타난 것을 센터가 확인한 단계입니다. 접수만 됐다고 상대가 읽은 것은 아닙니다. 메시지가 지나가는 순서는 다음과 같습니다.
| 단계 | 뜻 | 화면 표시 |
|---|---|---|
| 1. 접수 | 센터가 메시지를 받아 큐에 올렸습니다. | 센터 접수 · 착지 미확인 |
| 2. 전송 | 센터가 상대 요원의 방 입력창으로 메시지를 보냈습니다. | SENT 확인필요 |
| 3. 착지 | 상대 요원의 대화에 그 메시지가 실제 입력으로 나타난 것을 확인했습니다. | 최종 착지 확인 (초록) |
| 실패 | 전달 중 실패가 확인됐습니다. | 실패 (빨강) |
통신 흐름 탭
통신 흐름 탭은 최근 메시지를 한 줄씩 보여 주는 표와 그 아래 상세 칸으로 되어 있습니다. 화면을 열면 자동으로 조회하고, 열려 있는 동안 5분마다 갱신합니다. 이 탭에는 새로고침 버튼이 없습니다. 표에는 센터가 이번에 켜진 뒤에 오간 메시지 가운데 가장 최근 20건이 최신순으로 나옵니다. 센터를 다시 켜면 목록은 비워진 상태에서 시작합니다.
메시지가 하나도 없으면 아래 칸에 “현재 process generation에서 메시지 흐름이 관찰되지 않았습니다.”라고 나옵니다. 센터를 방금 켰거나 아직 메시지를 보내지 않았다는 뜻입니다.
표의 열
| 열 | 의미 |
|---|---|
| 시각 | 그 메시지에서 마지막으로 기록된 일의 시각 |
| 보낸 요원 | 보낸 쪽 이름. 알 수 없으면 ‘미확인’, 등록되지 않은 대상이면 ‘미등록’ |
| 받는 요원 | 받는 쪽 이름. 표시 규칙은 보낸 요원과 같음 |
| 센터 처리 | 센터가 그 메시지를 어디까지 처리했는지 |
| 최초 실패 | 실패가 있었다면 처음 실패한 지점의 코드. 없으면 ‘—’ |
| 큐 번호 | 메시지에 붙은 순번. 문의할 때 이 번호를 알려 주세요. |
| 최종 착지 | 착지 확인 또는 착지 미확인 |
열 제목을 누르면 정렬하고, 끌어서 열 순서를 바꿀 수 있습니다.
색 읽는 법
| 센터 처리 / 최종 착지 | 색 | 뜻 | 할 일 |
|---|---|---|---|
| 최종 착지 확인 / 착지 확인 | 초록 | 상대 대화에 메시지가 나타났습니다. | 없음. 요원 방에서 진행을 봅니다. |
| 센터 접수 · 착지 미확인 / 착지 미확인 | 노랑 | 센터는 받았지만 상대에게 나타났는지는 아직 모릅니다. | 잠시 기다린 뒤 다시 엽니다. 계속 노랑이면 받는 요원의 불과 관제의 요원 현황을 확인합니다. |
| 실패 / 착지 미확인 | 빨강 / 노랑 | 전달 과정에서 실패했습니다. | ‘최초 실패’ 코드를 보관하고 받는 요원의 상태를 확인합니다. |
상세 칸
표에서 줄을 선택하면 아래 칸에 그 메시지의 큐 번호와 패킷 ID, 보낸 쪽 → 받는 쪽, 센터 처리, 최종 착지가 한 번에 정리됩니다. 실패가 있었다면 끝에 ‘최초 실패 코드’가 붙습니다. 화면을 열면 첫 줄이 자동으로 선택됩니다. 지원을 요청할 때 이 내용을 복사해 붙이면 원인을 찾기가 빨라집니다.
assets/turtlecenter/ui-communication-monitor-2.png · 권장 크기 1600×900표에서 한 줄을 선택했을 때 아래 상세 칸에 큐 번호 · 패킷 ID와 처리 결과가 나온 모습.ngrok 모니터 탭
ngrok 모니터 탭은 바깥에서 센터로 들어온 요청의 사용량과 개별 요청 내용을 보는 곳입니다. 외부 연결(ngrok)이 설정된 센터에서만 탭이 나타납니다. 확인필요 탭이 없는 센터의 정확한 조건은 배포 화면 기준으로 확인합니다. 탭을 열고 있는 동안 5분마다 자동으로 갱신합니다.
| 구역 | 내용 |
|---|---|
| 제목 줄 | ‘사용 통계 · 요청 모니터’ |
| 기간 선택 | ‘시작’과 ‘종료’ 날짜·시각. 처음에는 최근 하루로 잡혀 있고, 시작이 종료보다 늦으면 “시작 시각은 종료 시각보다 빨라야 합니다.”라고 알려 줍니다. |
| 새로고침 / Inspector 열기 | 새로고침은 선택한 기간으로 다시 조회합니다. Inspector 열기는 ngrok 자체의 요청 확인 화면을 브라우저로 엽니다. |
| 상태 줄 | 정상(초록) · 부분 자료(노랑) · 조회 불가 · 캡처 없음. 아래에 현재 누적 요청 수, 선택 기간의 터널 시작 횟수, MCP 호출 수(성공/실패)와 평균·최대 응답 시간이 한 줄로 나옵니다. |
| 요원별 표 | 요원 · 호출 · 성공 · 실패 · 평균 ms |
| 요청 표 | 가장 최근 요청 50건: 시각 · 메서드 · 경로 · 상태 · ms |
| 요청 상세 | 요청 줄을 선택하면 오른쪽에 요청 헤더·본문, 응답 헤더·본문이 나옵니다. 길면 ‘[일부만 표시]’가 붙습니다. |
요청 상세에는 주고받은 헤더와 본문이 그대로 나옵니다. 이 화면을 화면 캡처로 다른 사람에게 보내기 전에 내용을 확인하세요. 외부 연결 설정은 설정의 ‘외부 연결’ 탭에서 합니다.
작업 순서: 보냈는데 답이 없을 때
- 통신 모니터를 열고 통신 흐름 표에서 보낸 시각과 받는 요원이 맞는 줄을 찾습니다. 줄이 없으면 센터가 그 메시지를 받지 못한 것입니다.
- 초록(최종 착지 확인)이면 상대가 받았습니다. 답이 없다면 요원 방에서 진행 상황을 봅니다.
- 노랑(센터 접수 · 착지 미확인)이면 잠시 기다린 뒤 다시 확인합니다. 오래 노랑이면 받는 요원의 불 색깔을 봅니다.
- 빨강(실패)이면 ‘최초 실패’ 코드와 큐 번호를 보관합니다. 받는 요원의 상태는 관제의 요원 현황에서 확인합니다.
알아 둘 점
- 통신 모니터는 보기 전용입니다. 다시 보내기나 취소 버튼은 없습니다. 다시 보내는 판단은 직접 합니다.
- 목록은 센터를 켠 뒤의 기록이라서 센터를 다시 켜면 비워진 상태에서 시작합니다.
- ‘센터 처리’ 열에 SENT나 UNKNOWN처럼 영어가 그대로 보일 수 있습니다. 확인필요 표시 문구는 다듬을 예정입니다.
- ‘착지 미확인’은 실패가 아니라 아직 확인되지 않았다는 뜻입니다.