> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 성능 지표

> FailproofAI Observability 성능 지표 문서입니다.

모델, 도구, 훅이 느려지거나 비용이 증가하는 순간을 즉시 포착하고, 사용자가 체감하기 전에 꼬리 지연(tail-latency) 급등을 미리 잡아내세요. 세 개의 전용 페이지가 원시 타이밍 데이터를 한눈에 읽을 수 있는 p50, p95, p99로 변환해 줍니다.

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/models.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=507909b97d5996be97345b3cb59bc38a" alt="모델 페이지에 지연 히트맵, 백분위수 밴드, 모델별 토큰·비용·컨텍스트 윈도우 수치가 표시된 화면" width="3200" height="2000" data-path="agenteye/images/models.png" />

*Models 페이지: 지연 히트맵, 백분위수 밴드, 모델별 토큰 사용량, 예상 비용, 컨텍스트 윈도우 사용률.*

## 평균값이 최악의 실행을 가리지 못하게 하세요

평균 지연 수치는 안심감을 주지만 실질적으로는 무용합니다. 50번 중 한 번 멈춰서 새벽 2시에 온콜을 깨우는 호출을 그냥 뭉개버리기 때문입니다. Models, Tools, Hooks 페이지는 그런 식으로 작동하지 않습니다. 세 페이지 모두 동일한 구조를 공유하므로 한 번만 익히면 됩니다.

* **24구간 스파크라인**: 추세를 한눈에 파악 — 상황이 악화되고 있나요?
* **바이탈 스트립**: p50, p95, p99 지연값을 나란히 표시해 일반적인 실행과 꼬리 지연을 함께 확인합니다.
* **지연 히트맵**: 24개 시간 구간과 지연 버킷으로 구성되어 느린 호출이 언제 집중됐는지 보여줍니다.
* **백분위수 밴드**: p50 라인을 기준으로 p25~~p75, p10~~p90 음영 리본과 p99 점이 표시되어 분산이 평균 뒤에 숨지 않고 그대로 드러납니다.

공유 호버 크로스헤어가 히트맵과 밴드를 연결하므로, 꼬리 급등 지점이 단일 평균선 뒤에 숨지 않고 두 차트에서 시간적으로 일치하여 표시됩니다. 세 페이지 모두 대시보드의 **observe** 섹션에서 찾을 수 있으며, 조직 단위로 범위가 지정되고 날짜 범위, 환경, 에이전트, 세션별로 필터링할 수 있습니다.

## Models: 각 모델의 정확한 비용 파악

Models 페이지(위 이미지 참조)는 청구서를 받았을 때 항상 드는 두 가지 질문에 답합니다. 어떤 모델이, 얼마나 사용됐는지. 공유 지연 뷰 외에도 **모델별 토큰 소비량**, **예상 비용**, **컨텍스트 윈도우 사용률**이 추가되어, 프롬프트가 걷잡을 수 없이 커지거나 컴팩션이 임박한 상황을 미리 발견할 수 있습니다.

FailproofAI Observability는 일반적인 모델 ID를 자동으로 인식합니다. 윈도우 수치가 잘못 표시되거나 자체 프라이빗 모델을 운영하는 경우, **Settings**의 **model context windows**에서 수정하거나 새로 추가하면 사용률 수치가 자동으로 반영됩니다.

## Tools: 느린 것과 고장난 것을 구별하세요

도구 호출은 느릴 수도 있고, 조용히 실패하고 있을 수도 있습니다. 로그를 뒤지는 데 시간을 낭비하지 않고 수 초 만에 어느 쪽인지 알 수 있어야 합니다.

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/tools.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=3f91782420c31a7f32a3572aa4fda266" alt="Tools 페이지에 공유 지연 히트맵과 백분위수 밴드, 성공·실패 분류 현황, 도구 분포 바가 표시된 화면" width="3200" height="2000" data-path="agenteye/images/tools.png" />

*Tools 페이지: 동일한 히트맵과 백분위수 밴드, 그리고 성공·실패 분류 현황과 도구 분포 바.*

공유 지연 뷰 외에도 Tools 페이지는 **성공·실패 분류 현황**과 **도구 분포 바**를 추가해, 어떤 도구를 가장 많이 사용하는지, 그리고 어떤 도구가 에러 버짓을 갉아먹고 있는지를 한눈에 파악할 수 있습니다.

## Hooks: 정확한 훅과 트리거 지점 찾기

라이프사이클 훅이 실행을 지연시킬 때, "훅이 느리다"는 말만으로는 조치를 취할 수가 없습니다. Hooks 페이지는 문제가 되는 바로 그 훅을 찾아줍니다.

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/hooks.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=4ad9229477b0fe9df9fade7ea2ff37ee" alt="Hooks 페이지에 공유 히트맵과 백분위수 밴드 위에 훅 이름 및 트리거 이벤트별로 분류된 지연 정보가 표시된 화면" width="3200" height="2000" data-path="agenteye/images/hooks.png" />

*Hooks 페이지: 훅 이름과 트리거 이벤트별로 분류된 지연 정보.*

동일한 지연 히트맵과 백분위수 밴드 위에서 Hooks 페이지는 활동을 **훅 이름**과 **트리거 이벤트**별로 세분화하여, 주의가 필요한 단 하나의 훅과 단 하나의 이벤트를 바로 찾아낼 수 있게 합니다.

## 관련 문서

* [이벤트 스트림](/ko/agenteye/event-stream): 모든 이벤트의 실시간 컬러 코딩 흔적.
* [세션](/ko/agenteye/sessions): 이벤트를 실행 단위별로 하나의 행으로 집계하고 실행 그래프를 열어봅니다.
* [에러 추적](/ko/agenteye/error-tracking): 대시보드에서 빨간색으로 표시된 모든 항목을 한 곳에서 트리아지합니다.
* [대시보드](/ko/agenteye/dashboards): 전체 플릿에 걸친 롤업 뷰.
