MQE UI 사양 가이드 (사용자용)
GIIP 메시지 큐 엔진(MQE)의 대시보드 인터페이스 구성과 사용 방법을 안내합니다.
📋 개요
MQE UI는 인프라와 백엔드 사이를 오가는 물리적 메시지들의 흐름을 시각적으로 모니터링하기 위한 도구입니다. 에이전트의 데이터가 정상적으로 전송되고 있는지, 특정 구간에서 병목이 발생하고 있는지 직관적으로 파악할 수 있습니다.
🔍 주요 인터페이스 구성
1. 실시간 트래픽 대시보드
- TPS (Transactions Per Second): 초당 처리되는 메시지 수를 실시간 그래프로 보여줍니다.
- Queue Depth: 현재 처리 대기 중인 메시지 수를 바 차트로 표시합니다. (임계치 초과 시 Red 강조)
2. 메시지 추적 및 검색 (Message Explorer)
- ID 기반 검색: 특정 메시지 고유 ID를 입력하여 전송 경로와 처리 상태를 추적합니다.
- 본문 자동 파싱: JSON 포맷의 메시지 본문을 읽기 쉬운 형태로 보여주며, 특정 필드 값을 기준으로 필터링이 가능합니다.
3. 노드별 처리 상태 (Node Status)
각 에이전트 노드(Antigravity, Gemini 등)가 현재 MQ 서버와 정상적으로 연결되어 있는지, 마지막으로 메시지를 보낸 시점은 언제인지 확인합니다.
🛠️ 사용 방법
- GIIP [시스템 관리] > [MQE 모니터링] 메뉴로 이동합니다.
- 상단의 [채널 선택] 드롭다운에서 분석하고자 하는 큐(Queue)를 선택합니다.
- [Live Flow] 모드를 활성화하여 실시간으로 유입되는 메시지 샘플을 확인합니다.
- 필요 시 [History Search] 탭에서 특정 시간대의 과거 메시지를 조회합니다.
💡 활용 팁
- 디버깅: 에이전트 설정이 잘못되어 데이터가 올라오지 않을 때, MQE UI에서 실제 패킷이 도달하는지 먼저 확인하세요.
- 알림 설정: 특정 큐의 지연 시간이 5초를 초과할 경우 UI 상단에 경고 배너가 나타나도록 설정할 수 있습니다.
버전: 1.0 최종 업데이트: 2026-03-19 소스 파일:
giipv3/public/help/mqe-ui-spec.ko.md