에이전트 모니터링

에이전트 모니터링에서는 배포된 에이전트의 동작 상태와 요청 처리 현황을 한 화면에서 확인할 수 있습니다. [에이전트] > [모니터링] 메뉴로 이동하며, 다음 세 화면으로 구성됩니다.

• 모니터링 : 에이전트 상태 현황과 기간별 집계 현황을 보여주는 기본 화면입니다.
• 에이전트 관리 : 등록된 전체 에이전트를 표 형태로 조회합니다.
• 에이전트 실행 이력 : 에이전트별 실행 건과 요청·응답 내용을 조회하고 실행을 중지합니다.

⚠️ 모니터링 대상은 배포되어 외부 호출 주소가 부여된 에이전트입니다. 빌더에서 작성만 하고 배포하지 않은 에이전트는 집계에 포함되지 않습니다.

에이전트 상태 현황

에이전트의 현재 동작 상태를 카드 형태로 보여줍니다. 카드에는 에이전트명과 상태, 생성일, 배포일이 표시됩니다.

섹션 상단에는 전체 개수와 상태별 개수가 함께 표시됩니다.

상태	설명
활성	배포되어 정상적으로 동작 중인 에이전트입니다.
에러	배포되었으나 실행할 수 없는 상태의 에이전트입니다.
비활성	배포되지 않았거나 동작하지 않는 에이전트입니다.

카드는 최근 수정된 순서로 최대 10개까지 표시됩니다. 에이전트가 10개를 넘으면 우측에 [에이전트 관리] 버튼이 나타나며, 클릭하면 전체 목록을 표로 조회할 수 있습니다.

집계 현황

선택한 기간 동안의 요청 처리 실적을 집계하여 보여줍니다.

조회 조건
상단 도구 모음에서 집계 단위와 기간, 대상 에이전트를 지정합니다.

• 집계 단위 : 일, 주, 월 중에서 선택하며, 선택 시 기간이 오늘을 기준으로 각각 당일, 최근 1주, 최근 1개월로 자동 설정됩니다.
• 기간 : 달력에서 시작·종료 일시를 직접 지정합니다. 최대 3개월 범위까지 조회할 수 있으며, 날짜를 직접 바꾸면 집계 단위 선택 표시가 해제됩니다.
• 에이전트 : 전체 에이전트 또는 특정 에이전트를 선택합니다.

우측의 [실행 이력] 버튼을 클릭하면 현재 지정한 조건(기간·에이전트)이 그대로 유지된 상태로 실행 이력 화면이 열립니다.

요약 지표
조회 조건에 해당하는 실적을 세 가지 지표로 요약합니다.

지표	세부 항목
총 요청 건수	성공 건수, 실패 건수를 함께 표시합니다. 실패 건수는 중지된 건과 오류로 종료된 건의 합계이며, 마우스를 올리면 각각의 건수를 확인할 수 있습니다.
평균 응답 시간	최소·최대 응답 시간을 함께 표시합니다. 값의 크기에 따라 ms, sec, min 단위로 표기되며, 마우스를 올리면 원래의 ms 값을 확인할 수 있습니다.
총 토큰 수	입력 토큰 수와 출력 토큰 수를 함께 표시합니다. 큰 수는 축약하여 표기하며, 마우스를 올리면 전체 숫자를 확인할 수 있습니다.

에이전트별 요청 비율 / 요청 건수 Top 5
전체 에이전트 를 선택하여 조회한 경우에만 표시됩니다. 요청이 어느 에이전트에 집중되는지 도넛 차트로 확인하고, 요청 건수가 많은 상위 5개 에이전트의 요청·성공·실패 건수를 표로 확인할 수 있습니다.

차트
기간별 추이를 세 가지 차트로 보여줍니다.

• 총 요청 현황 : 요청·성공·실패 건수의 추이입니다. 범례를 클릭하면 해당 항목만 강조하여 볼 수 있습니다.
• 평균 응답 속도 : 평균 응답 시간의 추이입니다.
• 토큰 사용량 : 입력 토큰과 출력 토큰을 누적 막대로 보여줍니다.

에이전트 관리

등록된 전체 에이전트의 배포 현황을 표로 조회합니다. 상태 현황 섹션의 [에이전트 관리] 버튼으로 진입하며, 상단에는 전체·활성·에러·비활성 개수가 표시됩니다.

항목	설명
에이전트명	에이전트 유형 아이콘과 이름이 표시됩니다. 이름 옆의 아이콘을 클릭하면 해당 에이전트를 빌더에서 새 창으로 엽니다.
설명	에이전트 설명입니다.
작성자	에이전트를 생성한 사용자입니다.
작성일	에이전트를 생성한 날짜입니다.
배포일	마지막으로 배포한 날짜입니다. 배포 이력이 없으면 미배포 로 표기됩니다.
배포	현재 배포 여부(배포됨 / 미배포)입니다.
상태	활성 / 에러 / 비활성 상태입니다.

에이전트 유형은 아이콘으로 구분되며, Flow 에이전트 와 내부 에이전트 위임, 외부 endpoint 가 있습니다.

목록 상단에서 에이전트명으로 검색하거나, 필터에서 유형과 작성자를 지정하여 조회 범위를 좁힐 수 있습니다.

⚠️ 내부 에이전트 위임 유형은 별도의 배포 시각이 남지 않으므로 배포일이 - 로 표기됩니다.

에이전트 실행 이력

에이전트가 처리한 개별 실행 건을 조회합니다. 집계 현황의 [실행 이력] 버튼으로 진입하며, 상단 조회 조건(집계 단위·기간·에이전트)은 집계 현황과 동일합니다.

검색과 필터

• 검색 : 요청 내용을 대상으로 검색합니다.
• 필터 : 상태와 사용자로 조회 범위를 좁힐 수 있습니다. 상태는 여러 개를 함께 선택할 수 있으며, 아무것도 선택하지 않으면 전체를 조회합니다.

목록

항목	설명
요청 시각	요청이 접수된 시각입니다.
요청	사용자가 입력한 요청 내용입니다. 추적 모드로 실행된 건에는 앞쪽에 추적 아이콘이 표시되며, 클릭하면 추적 로그를 새 창으로 조회합니다.
에이전트	요청을 처리한 에이전트입니다. 삭제된 에이전트는 삭제된 에이전트 로 표기됩니다.
사용자	요청을 실행한 사용자입니다.
사용량	해당 실행에서 사용한 토큰 수입니다. 큰 수는 축약하여 표기하며, 마우스를 올리면 전체 숫자를 확인할 수 있습니다.
상태	실행 상태입니다. 오류 또는 실행중 상태에서 마우스를 올리면 상태 메시지를 확인할 수 있습니다.

실행 상태는 다음과 같습니다.

상태	설명
실행중	에이전트가 요청을 처리하고 있습니다.
응답 대기	사용자의 회신을 기다리는 중입니다.
완료	정상적으로 처리되었습니다.
중지	사용자 요청으로 중지되었습니다.
오류	처리 중 오류가 발생했습니다.
중지중	중지를 요청하여 처리하고 있는 중입니다.

연결된 실행 이력
목록은 대화 한 건(세션)의 첫 요청을 기준으로 표시됩니다. 이어지는 회신이나 재개 요청이 있는 건은 요청 내용 뒤에 화살표가 표시되며, 클릭하면 같은 세션에 속한 전체 실행 내역이 펼쳐집니다. 목록의 사용량은 세션 전체의 토큰 합계입니다.

실행 중지
처리 시간이 길어지는 요청은 중지할 수 있습니다.

• 개별 중지 : 실행중 상태인 행의 상태 옆에 있는 중지 버튼을 클릭합니다.
• 전체 중지 : 목록 상단의 [전체 중지] 버튼을 클릭하면 현재 조회 조건(기간·에이전트)에 해당하는 실행중 건을 모두 중지합니다.

중지는 요청 접수 후 백그라운드로 처리되므로, 상태가 중지중 을 거쳐 중지 로 바뀝니다. 중지에 실패한 건은 다시 실행중 으로 표시되며 상태 메시지에서 원인을 확인할 수 있습니다.

⚠️ 실행 중지는 에이전트 모니터링 쓰기 권한이 있는 사용자만 사용할 수 있습니다. 권한이 없으면 중지 버튼이 비활성화됩니다.