MQE UI 사양 가이드 (사용자용)

GIIP 메시지 큐 엔진(MQE)의 대시보드 인터페이스 구성과 사용 방법을 안내합니다.

🔔 메시지 큐 UI 설정 페이지로 이동 →

📋 개요

MQE UI는 인프라와 백엔드 사이를 오가는 물리적 메시지들의 흐름을 시각적으로 모니터링하기 위한 도구입니다. 에이전트의 데이터가 정상적으로 전송되고 있는지, 특정 구간에서 병목이 발생하고 있는지 직관적으로 파악할 수 있습니다.

🔍 주요 인터페이스 구성

1. 실시간 트래픽 대시보드

• TPS (Transactions Per Second): 초당 처리되는 메시지 수를 실시간 그래프로 보여줍니다.
• Queue Depth: 현재 처리 대기 중인 메시지 수를 바 차트로 표시합니다. (임계치 초과 시 Red 강조)

2. 메시지 추적 및 검색 (Message Explorer)

• ID 기반 검색: 특정 메시지 고유 ID를 입력하여 전송 경로와 처리 상태를 추적합니다.
• 본문 자동 파싱: JSON 포맷의 메시지 본문을 읽기 쉬운 형태로 보여주며, 특정 필드 값을 기준으로 필터링이 가능합니다.

3. 노드별 처리 상태 (Node Status)

각 에이전트 노드(Antigravity, Gemini 등)가 현재 MQ 서버와 정상적으로 연결되어 있는지, 마지막으로 메시지를 보낸 시점은 언제인지 확인합니다.

🛠️ 사용 방법

1. GIIP [시스템 관리] > [MQE 모니터링] 메뉴로 이동합니다.
2. 상단의 [채널 선택] 드롭다운에서 분석하고자 하는 큐(Queue)를 선택합니다.
3. [Live Flow] 모드를 활성화하여 실시간으로 유입되는 메시지 샘플을 확인합니다.
4. 필요 시 [History Search] 탭에서 특정 시간대의 과거 메시지를 조회합니다.

💡 활용 팁

• 디버깅: 에이전트 설정이 잘못되어 데이터가 올라오지 않을 때, MQE UI에서 실제 패킷이 도달하는지 먼저 확인하세요.
• 알림 설정: 특정 큐의 지연 시간이 5초를 초과할 경우 UI 상단에 경고 배너가 나타나도록 설정할 수 있습니다.

문제 해결

증상	원인	해결
대시보드에 메시지가 표시되지 않는다	에이전트 설정 오류로 패킷이 도달하지 않음	MQE UI에서 실제 패킷 도달 여부를 확인한 뒤 에이전트 설정을 점검한다
Queue Depth 바 차트가 빨간색으로 강조된다	처리 대기 메시지가 임계치를 초과함	노드 연결 상태와 컨슈머 처리 속도를 확인한다
상단에 지연 경고 배너가 나타난다	특정 큐의 지연 시간이 5초를 초과함	[History Search]로 해당 시간대 병목 구간을 분석한다
특정 노드가 연결 끊김으로 표시된다	마지막 전송 이후 MQ 서버와 재연결되지 않음	Node Status에서 마지막 전송 시점을 확인하고 에이전트를 재시작한다

---

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일: giipv3/public/help/mqe-ui-spec.ko.md