4.6. 모니터링 & 분석¶

Squad는 에이전트 팀의 성능을 이해할 수 있도록 실시간 모니터링, 상세 실행 이력, 분석 기능을 제공합니다.

모니터링 대시보드¶

Squad 모니터링 대시보드는 실행 중 제어 센터 역할을 합니다. 다섯 개의 탭으로 정보를 구성합니다:

개요 탭¶

개요 탭은 Squad의 현재 상태 요약을 보여줍니다. 어떤 Squad에서든 에이전트가 도구 실행 승인을 기다리고 있으면, 탭 상단(주요 지표 위)에 승인 대기 중 섹션이 고정 표시됩니다. 이 섹션은 모든 Squad의 대기 중인 요청을 한곳에 집계하므로, 다른 Squad를 보고 있는 동안에도 승인 요청을 놓치지 않을 수 있습니다.

각 행에는 에이전트 ID, 승인을 요청한 도구 이름, 위험 수준 배지(safe, low, medium, high, critical)가 표시됩니다. 행을 클릭하면 해당 요청에 대한 승인 대화상자가 열립니다. 대기 중인 승인이 모두 처리되면 섹션은 자동으로 사라집니다.

주요 지표¶

대시보드 상단에 세 가지 핵심 지표가 한눈에 표시됩니다:

• 활성/전체 에이전트 — 전체 구성된 에이전트 중 현재 실행 중인 수
• 세션 토큰 — 현재 세션에서 모든 에이전트가 소비한 누적 토큰 수
• 실행 단계 — Squad 실행의 현재 단계 (유휴, 계획 중, 실행 중, 집계 중 등)

에이전트 활동¶

주요 지표 아래에 에이전트 활동 섹션이 있으며, 모든 Squad의 활성 에이전트 세션을 단일 목록으로 나열합니다. 각 행에는 Squad 이름, 에이전트 이름, 상태 배지, 에이전트의 현재 작업 미리보기가 표시됩니다. 행은 긴급도 순으로 정렬되는데, 실행 중인 에이전트가 먼저, 승인 대기 중인 에이전트, 오류 상태의 에이전트, 유휴 에이전트 순입니다.

목록 위에 두 가지 필터가 있습니다:

• 이름 필터 — 에이전트 이름이나 Squad 이름으로 행을 필터링합니다 (150ms 디바운스 적용).
• 상태 칩 — Running, Waiting, Error 칩을 클릭하면 해당 상태의 에이전트만 표시됩니다. 칩에는 해당 상태의 에이전트 수가 표시되며, 해당 상태의 에이전트가 없으면 칩 자체가 사라집니다.

행을 클릭하면 /squad/{squadId}/agent/{agentId} 경로의 에이전트 상세 뷰로 이동합니다. 활성 세션이 없으면 목록 대신 빈 상태 메시지가 표시됩니다.

활동 피드¶

Squad 이벤트의 시간순 로그로, 다음을 포함합니다:

• 에이전트 세션 시작/중지
• 태스크 할당, 시작, 완료 또는 실패
• 메모리 업데이트
• 워크스페이스 파일 변경
• 예산 경고 및 초과

피드는 실시간으로 업데이트되며 최근 200개 항목을 유지합니다. 피드에 나타나는 이벤트 유형:

• 에이전트 시작, 완료 또는 오류
• 태스크 생성 또는 완료
• 전체 실행 완료

예산 미터¶

예산 미터(개요 탭 상단에 표시)는 Squad에 구성된 토큰 및 비용 한도에 대한 실시간 진행률을 표시합니다. Squad가 실행 중일 때 애니메이션됩니다. 한도 설정에 대한 자세한 내용은 예산 & 안전을 참조하세요.

채팅 탭¶

채팅 탭은 Squad와 대화형으로 상호작용하기 위한 인터페이스를 제공합니다. 다음 용도로 사용합니다:

• Squad에 새 태스크 또는 질문 전송
• 에이전트 실행 중 스트리밍 응답 모니터링
• 현재 세션의 대화 이력 검토

태스크 보드¶

태스크 보드 탭은 현재 실행의 모든 태스크를 칸반 스타일로 보여줍니다:

각 태스크 카드에 표시되는 정보:

• 태스크 제목과 할당된 에이전트
• 우선순위 수준 (색상 코드)
• 다른 태스크에 대한 의존성
• 결과 요약 또는 오류 메시지 (해당하는 경우)

태스크 카드를 클릭하면 전체 설명, 출력, 로그, 토큰 사용량이 포함된 태스크 상세 패널이 열립니다.

워크스페이스 탭¶

워크스페이스 탭은 Squad 워크스페이스 디렉터리의 파일 탐색기를 제공합니다. 다음을 수행할 수 있습니다:

• 에이전트가 생성한 디렉터리와 파일 탐색 및 미리보기
• 로그, 플랜, 태스크 출력, 생성된 산출물 확인

분석 탭¶

분석 탭은 실행 이력과 분석 대시보드를 함께 제공합니다.

실행 이력¶

실행 이력 패널은 Squad의 모든 과거 실행을 나열합니다:

• 요청 텍스트 또는 플랜 제목으로 검색
• 상태별 필터 (완료, 실패, 취소)
• 요약 표시: 요청, 태스크 수, 토큰 사용량, 소요 시간

항목을 클릭하면 실행 상세 드로어가 확장되어 표시됩니다:

• 원래 요청과 생성된 플랜
• 태스크별 결과와 산출물
• 에이전트별 토큰 사용량 분석
• 에이전트와 심각도로 필터링 가능한 실행 로그
• 시작부터 완료까지의 소요 시간

리포트 생성¶

모든 실행에서 리포트 생성을 클릭하면 다음을 포함하는 마크다운 요약이 생성됩니다:

• 실행 개요 (요청, 상태, 소요 시간)
• 태스크 목록이 포함된 플랜 요약
• 각 태스크의 결과
• 토큰 사용 통계
• 생성된 산출물

리포트는 워크스페이스에 저장되며 팀과 공유할 수 있습니다.

분석 대시보드¶

분석 대시보드는 여러 실행의 데이터를 집계하여 성능 트렌드를 보여줍니다.

사용 가능한 지표¶

• 총 실행 수 — 완료, 실패, 취소된 실행의 수
• 성공률 — 성공적으로 완료된 실행의 비율
• 평균 소요 시간 — 밀리초 단위의 평균 실행 시간
• 총 토큰 — 누적 토큰 소비량

에이전트별 토큰 사용량¶

토큰이 에이전트 간에 어떻게 분배되는지 보여주는 분석. 어떤 에이전트가 가장 많은 리소스를 소비하는지, 분배가 기대에 부합하는지 확인할 수 있습니다.

일별 사용량¶

일별 실행 수와 토큰 사용량을 보여주는 막대 차트로, 시간에 따른 사용 트렌드를 파악하는 데 유용합니다.

기간 선택¶

기간별로 분석을 필터링합니다:

• 일 — 최근 24시간
• 주 — 최근 7일
• 월 — 최근 30일
• 전체 — 기록된 모든 이력