> ## 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.

# 오류

> 반복되는 오류를 그룹화하고 관련 세션을 열어봅니다.

오류 페이지는 세션 전반에 걸쳐 실패를 중심으로 보여주는 뷰입니다. 오류 유형, 에이전트, 환경, 모델, 도구, 또는 시간 범위별로 그룹화하여 반복적인 운영 문제를 파악할 수 있습니다.

## 오류 조사하기

<Tabs>
  <Tab title="대시보드">
    1. **Observe → Errors**로 이동합니다.
    2. 환경, 이벤트 유형, 오류 유형, 에이전트, 세션 ID, 또는 검색어로 필터링합니다.
    3. 그룹화된 오류를 펼쳐 발생 내역을 확인합니다. 행을 선택하면 해당 세션에서 정확한 이벤트를 열 수 있습니다.
    4. 대표 오류의 벨 컨트롤을 선택하면 유사한 오류에 대한 알림을 설정할 수 있습니다.

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/errors.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=fb6973d5708bcd6be0dc5a887450dec0" alt="실패 히스토그램, 그룹화된 오류, 알림 생성 컨트롤이 표시된 Errors 페이지." width="3200" height="2000" data-path="images/dashboard/errors.png" />
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp errors --env production --since 24h
    fp errors --error-type TimeoutError --agent-id checkout-agent
    fp errors --aggregate --env production --since 7d
    ```

    오류 요약 뒤의 원시 페이로드가 필요한 경우 `fp events --full --session-id <id>`를 사용하세요.
  </Tab>
</Tabs>

## 오류 페이지가 필요한 경우

* 프로덕션에서 가장 빈번하게 발생하는 오류 클래스를 파악할 때.
* 특정 도구나 모델이 급증의 원인인지 확인할 때.
* 집계 수치에서 대표 세션으로 바로 이동할 때.
* 재발에 대한 알림을 생성할 때.
* 영향을 받은 범위를 감사에 포함시킬 때.

오류는 관찰된 이벤트입니다. 평가 실패는 품질에 대한 판단이며, 감사 결과는 조사된 실패 패턴입니다. 어떤 대응 워크플로를 사용할지 결정할 때 이 구분을 명확히 유지하세요.

<Card title="알림 생성" icon="bell-ring" href="/ko/audits/alerts">
  오류 또는 품질 조건이 임계값을 초과할 때 담당자에게 알림을 보냅니다.
</Card>