failproofai 1.0.1-beta.1 → 1.0.2-beta.0

package/.next/standalone/docs-old/ko/agenteye/cli.mdx

@@ -0,0 +1,350 @@
+---
+title: "CLI"
+description: "터미널이나 스크립트에서 Failproof AI Observability를 완전히 제어하세요: 대시보드를 오갈 필요가 없습니다."
+---
+
+
+터미널이나 스크립트에서 Failproof AI Observability를 완전히 제어하세요: 대시보드를 오갈 필요가 없습니다. `agenteye` CLI는 데이터(세션, 이벤트 로그, 평가)를 조회하고 조직(API 키, 사용자, 설정, 알림, 인시던트, 저장된 쿼리)을 관리합니다. 자동화된 검사를 실행하거나, Observability를 CI에 연동하거나, 코딩 에이전트가 프로덕션을 점검하도록 할 때 활용하세요. 모든 커맨드는 `--json` 플래그를 지원하므로, 터미널에서 직접 사용하거나 코딩 에이전트(Claude Code, Cursor)가 셸을 호출해 결과를 파싱할 때 모두 동일하게 작동합니다.
+
+하나의 바이너리로 다음을 수행할 수 있습니다:
+
+- **데이터 조회**: `sessions`, `events`, `evals`, `errors` (시간, 에이전트, 환경, 점수로 필터링).
+- **조직 관리**: `keys`, `users`, `settings`, `alerts`, `incidents`.
+- **분석 실행**: 저장된 SQL 및 임시 쿼리 실행기 (`query`).
+- **AI 어시스턴트 질의**: 대시보드에서 사용하는 것과 동일한 읽기 전용 분석 도구 (`agent`).
+
+> **참고:** 이것은 `agenteye` CLI로, 컬렉터 데몬(`agenteye-collector`)과는 별개의 도구입니다. CLI는 대시보드와 통신하고, 컬렉터는 이벤트를 서버로 전송합니다.
+
+---
+
+## 빠른 시작
+
+처음부터 첫 번째 결과까지 네 줄이면 충분합니다. CLI가 대시보드를 가리키도록 설정하고, 로그인하고, 본인 확인 후, 최근 하루치 실행 기록을 가져옵니다:
+
+```bash
+pipx install agenteye
+agenteye --base-url https://agenteye.example.com login --email you@example.com   # 이메일로 6자리 코드 발송
+agenteye whoami                                                                  # 현재 사용자 + 활성 조직 확인
+agenteye --json sessions --since 24h                                             # 에이전트 실행 기록, 최근 24시간
+```
+
+마지막 커맨드는 가장 최근 세션의 JSON 객체를 출력합니다(최신순, 기본값 최대 50개). `jq`로 파이프해서 원하는 데이터를 추출하거나, `--json`을 생략하면 박스 형태의 컬러 테이블로 볼 수 있습니다. 각 행에는 실행 상태와, 평가자가 점수를 매겼다면 해당 메트릭 점수가 포함됩니다(여기서는 일부 생략):
+
+```json
+{
+  "sessions": [
+    {
+      "session_id": "run-8f2a",
+      "agent_id": "checkout-bot",
+      "environment": "prod",
+      "status": "error",
+      "scores": { "helpfulness": 0.42, "tool_efficiency": 0.55 },
+      "event_count": 37,
+      "started_at": "2026-07-16T09:14:02Z",
+      "last_event_at": "2026-07-16T09:14:48Z"
+    }
+  ],
+  "next_cursor": null
+}
+```
+
+이 페이지의 나머지 부분에서 각 구성 요소를 설명합니다: [설치](#installation), [로그인](#authentication), [설정](#configuration), 모든 커맨드에 공통으로 적용되는 [전역 규칙](#global-options--conventions), 그리고 [전체 커맨드 참조](#command-reference).
+
+---
+
+## 설치
+
+CLI는 **`agenteye`**라는 이름의 공개 PyPI 패키지입니다. 의존성이 충돌하지 않도록 격리된 환경에 설치하세요:
+
+```bash
+pipx install agenteye
+# 또는
+uv tool install agenteye
+```
+
+Python 3.10 이상이 필요합니다. 설치 후 커맨드는 **`agenteye`**입니다:
+
+```bash
+agenteye --version
+agenteye --help
+```
+
+> **참고:** Failproof AI Observability Python SDK도 `agenteye` 배포 이름을 사용합니다. `pipx` 또는 `uv tool`로 CLI를 설치하면(공유 가상 환경에 `pip install`하는 것과 달리) 두 패키지가 충돌하지 않습니다. 동일한 환경에 SDK가 설치되어 있지 않다면 `pip install agenteye`도 괜찮습니다.
+
+---
+
+## 인증
+
+CLI는 이메일로 전송되는 일회용 코드를 사용해 **대시보드**에 인증합니다:
+
+```bash
+agenteye login --email you@example.com
+# 이메일로 6자리 코드가 전송됩니다; 프롬프트에 붙여 넣으세요.
+```
+
+세션 토큰은 `~/.agenteye/cli.json`에 저장됩니다(본인만 읽을 수 있도록 `0600` 권한). 기본적으로 24시간 동안 유효하며, 만료되면 `agenteye login`을 다시 실행하세요.
+
+```bash
+agenteye whoami     # 현재 사용자, 활성 조직, 권한 표시
+agenteye logout     # 세션을 취소하고 저장된 토큰 삭제
+```
+
+`whoami`는 세션이 없거나 만료된 경우에도 오류를 발생시키지 않으며, 대신 `logged_in: false`를 반환합니다. 스크립트나 에이전트가 인증 상태를 안전하게 확인할 수 있습니다(다만 base URL이 설정되지 않았거나 대시보드에 접근할 수 없으면 여전히 비정상 종료될 수 있습니다).
+
+**요구 사항:** 이메일이 대시보드 로그인 허용 목록에 있어야 하며(Failproof AI Observability 관리자에게 문의), 대시보드가 base URL에서 접근 가능해야 합니다([설정](#configuration) 참조). 코드를 요청했는데 도착하지 않는다면 이메일이 아직 대시보드 접근 권한이 없는 것일 수 있습니다.
+
+---
+
+## 조직 선택 (멀티 테넌트)
+
+계정이 여러 조직에 속해 있다면 **로그인 시** 활성 조직을 선택하세요; 선택한 조직은 저장되어 이후 모든 커맨드에 사용됩니다:
+
+```bash
+agenteye login --org acme           # 인증과 활성 테넌트 설정을 한 번에
+agenteye orgs list                  # 접근 가능한 조직 목록 (활성 조직 표시됨)
+agenteye orgs switch globex         # 저장된 기본 조직 변경
+agenteye --org globex sessions      # 단일 커맨드에서 조직 재정의
+```
+
+정확히 하나의 조직에만 속해 있다면 자동으로 선택되므로 `--org`를 무시해도 됩니다. 여러 조직에 속해 있는데 선택하지 않으면, CLI가 조직 목록을 보여주고 `--org <slug>`를 붙여 다시 실행하도록 요청합니다. 활성 조직은 모든 요청에 포함되며, 권한은 **조직별로** 확인됩니다; `agenteye whoami`는 활성 조직, 해당 조직에서의 권한, 모든 멤버십을 표시합니다.
+
+---
+
+## 설정
+
+| 설정 | 플래그 | 환경 변수 | 기본값 |
+|---|---|---|---|
+| 대시보드 base URL | `--base-url` | `AGENTEYE_DASHBOARD_URL` | **필수** (기본값 없음) |
+| 활성 조직/테넌트 | `--org` | `AGENTEYE_ORG` | 로그인 시 선택; `~/.agenteye/cli.json`에 저장 |
+| 세션 토큰 | `--token` | `AGENTEYE_CLI_TOKEN` | `~/.agenteye/cli.json`에서 로드 |
+| JSON 출력 | `--json` | `AGENTEYE_CLI_JSON` | 꺼짐 |
+| TLS 검증 건너뛰기 | `--insecure` / `--secure` | `AGENTEYE_INSECURE` | 꺼짐 (로그인 시 저장) |
+| 요청 타임아웃 (초) | `--timeout` | _(없음)_ | 30 |
+| 사용량 텔레메트리 비활성화 | _(없음)_ | `AGENTEYE_ANALYTICS_DISABLED` (또는 `DO_NOT_TRACK`) | 텔레메트리는 현재 비활성화; 아무것도 전송되지 않음 |
+
+우선순위는 **플래그 → 환경 변수 → 설정 파일** 순입니다. 기본값이 없으므로 CLI가 대시보드를 가리키도록 설정해야 합니다. 커맨드마다 지정하거나(`--base-url https://agenteye.example.com`), 환경 변수로 한 번만 설정하면 됩니다(첫 `login` 후에도 저장됩니다):
+
+```bash
+export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com
+```
+
+설정 디렉터리는 `AGENTEYE_HOME` 환경 변수를 따릅니다(SDK 및 컬렉터와 동일한 규칙). 설정된 경우 `cli.json`은 `$AGENTEYE_HOME/cli.json`에 위치합니다.
+
+### 자체 서명 또는 내부 TLS
+
+대시보드가 자체 서명 또는 내부 인증서로 HTTPS를 제공하는 경우(예: 원시 로드 밸런서 호스트명), TLS 검증이 `CERTIFICATE_VERIFY_FAILED` 오류로 실패합니다. `--insecure`를 전달해 인증서 검증을 건너뛰세요:
+
+```bash
+agenteye --base-url https://agenteye.internal --insecure login
+```
+
+`--insecure`는 **로그인 시 `cli.json`에 저장**되므로 이후 커맨드는 자동으로 검증을 건너뜁니다; 매번 플래그를 반복할 필요가 없습니다. 일회성 검증 호출에는 `--secure`를 전달하거나, 다음 로그인 시 검증을 다시 활성화할 수도 있습니다. 검증이 비활성화된 상태에서 대시보드에 접촉하는 모든 커맨드 전에 CLI가 stderr에 경고를 출력합니다. 검증을 건너뛰면 중간자 공격에 대한 보호가 제거됩니다; 이를 사용하기 전에 대시보드까지의 네트워크 경로(VPN, 프라이빗 서브넷 등)를 신뢰할 수 있는지 확인하세요.
+
+---
+
+## 텔레메트리 및 개인정보
+
+> **참고:** 현재 배포된 CLI는 **사용량 텔레메트리를 전혀 전송하지 않습니다.** 마스터 킬 스위치가 활성화되어 있어 환경에 관계없이 아무것도 전송되지 않습니다. 아래 섹션은 텔레메트리가 향후 활성화될 경우를 대비한 옵트아웃 방법을 설명합니다.
+
+활성화되더라도 텔레메트리는 **익명 사용량 분석만** 수집하며, 에이전트·세션·이벤트 데이터는 절대 포함되지 않습니다:
+
+- **에이전트, 세션, 이벤트 데이터는 절대 인프라 외부로 나가지 않습니다.** CLI 사용 정보만 보고됩니다: 커맨드와 서브커맨드 이름(예: `keys create`), 사용한 플래그의 **이름**(값은 포함하지 않음), 성공/종료 상태, 실행 시간, 그리고 변경 작업에 대한 이벤트(예: `api_key_created`, `query_run`)로 정적 이름/열거형과 개략적인 카운트만 포함됩니다. 대시보드 URL, 세션 토큰, 이메일, 조직 슬러그, 리소스 ID, SQL, 키 시크릿, 쿼리 필터는 **절대 전송되지 않습니다.** 운영자는 불투명한 내부 ID로만 식별되며 이메일로는 식별되지 않습니다.
+- **미리 옵트아웃**하려면 CLI 환경에서 `AGENTEYE_ANALYTICS_DISABLED=1`을 설정하세요(CLI는 범용 `DO_NOT_TRACK=1` 규칙도 지원합니다). 텔레메트리가 활성화되는 순간부터 적용되므로, 개인정보를 중시하는 환경에서 영구적으로 옵트아웃 상태를 유지할 수 있습니다.
+- 텔레메트리가 활성화된다면 CLI는 PostHog(`https://us.i.posthog.com`)로 직접 전송할 것입니다; 해당 호스트가 차단된 환경에서는 아무것도 전송되지 않으며 CLI 동작에는 영향을 주지 않습니다.
+
+---
+
+## 전역 옵션 및 규칙
+
+한 번만 읽어두세요; 모든 커맨드에 적용됩니다.
+
+- **전역 옵션은 커맨드 앞에 위치해야 합니다.** `agenteye --json sessions`는 올바르지만, `agenteye sessions --json`은 사용 오류입니다. 전역 옵션은 `--json`, `--base-url`, `--org`, `--token`, `--insecure`/`--secure`, `--timeout`, `--quiet`, `--no-color`입니다.
+- **`--json`은 순수 JSON만 stdout에 출력합니다.** 사람이 읽는 상태 메시지, 경고, 오류는 **stderr**로 출력되므로, `--json` stdout 캡처는 상태 메시지가 표시되더라도 `jq`로 파이프할 수 있을 만큼 깔끔합니다. `--json` 없이는 사람이 보기 좋은 박스 형태의 컬러 뷰로 표시됩니다.
+- **`--help`으로 탐색하세요.** 모든 커맨드와 서브커맨드에는 `--help`(및 `-h` 별칭)가 있습니다: `agenteye -h`, `agenteye sessions -h`, `agenteye keys create -h`. 최상위 도움말에는 종료 코드와 전역 옵션도 나열됩니다. 전역 머신 가독 표면 덤프는 없으며, 커맨드별 `--help`와 두 레지스트리에 특화된 `agenteye query schema`, `agenteye settings schema`를 사용하세요.
+- **스크립트와 에이전트에서는 확인 프롬프트가 자동으로 건너뜁니다.** 생성/수정/삭제 커맨드는 인터랙티브 터미널에서 "정말 하시겠습니까?" 프롬프트를 표시하지만, **`--json`이거나 stdin이 TTY가 아닐 때는 자동으로 건너뜁니다**(TTY는 인터랙티브 터미널 세션; 파이프나 CI 러너는 TTY가 아님). 명시적으로 건너뛰려면 `--yes`/`-y`를 전달하세요. 에이전트에게는 프롬프트가 표시되지 않으므로, 에이전트는 파괴적인 작업을 수행하기 전에 먼저 사람에게 확인해야 합니다.
+- **페이지네이션:** 결과는 최신순으로 커서 페이지네이션됩니다(각 페이지는 다음 페이지를 가져올 때 사용하는 토큰을 반환). `--limit N`(별칭 `-n`)은 행 수를 제한하며 **기본값은 50**입니다; `--all`은 자동으로 페이지네이션(200행 단위)하지만 **`--limit`까지만** 처리하므로 `--all`만 사용하면 여전히 50개에서 멈춥니다. 전체를 가져오려면 큰 상한값을 명시적으로 지정하세요: `--all --limit 1000`. `--page-size N`은 요청당 청크 크기를 제어합니다(최대 200); `--cursor <id>`는 이전 페이지의 `next_cursor`에서 재개합니다.
+- **시간 필터:** `--since`는 상대적 구간을 받습니다: `15m`, `1h`, `6h`, `24h`, `7d`, 또는 `all`(대시보드 프리셋). 더 길거나 사용자 정의 범위(예: 최근 30일)에는 `--from`/`--to`를 사용하세요: `--since`를 재정의하는 명시적 ISO-8601 UTC 타임스탬프로 **`T`와 타임존이 포함**되어야 합니다(예: `2026-06-01T00:00:00Z`). 공백으로 구분되거나 타임존이 없는 값은 사용 오류입니다.
+- **`--fields a,b,c`**(`events`, `sessions`, `evals`, `errors`에서)는 테이블과 `--json` 모두에서 출력을 해당 키로 제한합니다. 알 수 없는 이름은 유효한 목록과 함께 거부되므로, 필드 이름을 확인하는 간편한 방법이기도 합니다.
+- **`--file payload.json`**(또는 stdin을 읽으려면 `--file -`)은 리소스가 복잡한 형태를 가질 때 전체 JSON 요청 본문을 제공합니다(`alerts create/update`, `settings set`, `users create/update`에서). 저장된 쿼리 SQL은 대신 `--sql @file.sql`을 사용합니다.
+- **다중값 필터**는 쉼표로 구분되며 집합으로 매칭됩니다(한 필터 내에서는 합집합, 필터 간에는 AND): `--event-type tool_use,tool_result`. Click 옵션은 가변 인수가 아니므로 `--add a b`는 작동하지 않습니다. `--add a,b`를 사용하거나, 플래그를 반복하거나(`--add a --add b`), 따옴표로 묶으세요(`--add "a b"`).
+
+---
+
+## 커맨드 참조
+
+### 가장 자주 사용하는 5가지 커맨드
+
+대부분의 일상 작업은 몇 가지 읽기 커맨드로 해결됩니다. 여기서 시작하고, 필요할 때 아래의 전체 목록을 참조하세요:
+
+| 커맨드 | 기능 | 예시 |
+|---|---|---|
+| `sessions` | 에이전트 실행 기록 한 줄씩: 시간, 환경, 에이전트, 상태, 최신 점수. | `agenteye --json sessions --since 24h --status error` |
+| `events` | 실행 내 단계별 원시 추적 데이터(페이로드는 `--full` 추가). | `agenteye --json events --session-id run-001 --all` |
+| `evals` | 평가 결과와 점수; `--aggregate`로 집계. | `agenteye --json evals --aggregate --since 7d --env prod` |
+| `errors` | 오류가 발생한 이벤트만; `--aggregate`로 유형별 카운트. | `agenteye --json errors --since 24h --aggregate` |
+| `list` | 유효한 필터값 탐색(에이전트, 환경, 모델 등). | `agenteye list agents` |
+
+### CLI가 할 수 있는 모든 것
+
+전체 목록입니다. CLI에는 **18개의 최상위 커맨드**가 있습니다. 모든 읽기 커맨드는 `--json`과 위의 전역 옵션을 지원합니다; 특정 커맨드의 전체 플래그 목록과 JSON 형태는 `agenteye <command> -h`(또는 `<command> <subcommand> -h`)를 실행하세요.
+
+### 신원: `login` · `logout` · `whoami` · `orgs` · `version` · `help`
+
+```bash
+agenteye login --email you@example.com [--org acme]   # 이메일 일회용 코드; 세션 저장
+agenteye logout                                       # 이 기기의 저장된 세션 삭제
+agenteye whoami                                       # 현재 사용자, 활성 조직, 권한
+agenteye version                                      # CLI 버전 출력 (--version과 동일)
+agenteye help                                         # 최상위 도움말 (--help와 동일)
+```
+
+`orgs`는 활성 테넌트를 확인하고 전환합니다:
+
+```bash
+agenteye orgs list        # 내 조직 + 각 역할 (활성 조직 표시됨)
+agenteye orgs switch acme # 저장된 활성 조직 변경 (슬러그 생략 시 TTY에서 목록 선택)
+agenteye orgs current     # 활성 조직의 정보
+agenteye orgs perms       # 활성 조직에서의 권한 (리소스별 그룹화)
+```
+
+### 관찰 (읽기 전용): `events` · `sessions` · `evals` · `errors` · `list`
+
+이 커맨드들은 확인이 필요하지 않습니다. 공통 필터: `--session-id`, `--agent-id`, `--env`(**`--environment`가 아님**), 시간 범위(`--since` / `--from` / `--to`).
+
+```bash
+# events (별칭: 단계별 원시 추적 데이터), 최신순
+agenteye --json events --session-id run-001 --event-type tool_use,tool_result --all --limit 1000
+agenteye --json events --since 1h --search timeout --all | jq '.events[].payload'
+
+# sessions: 에이전트 실행 기록 한 줄씩 (시간/환경/에이전트/세션/상태; 점수 필터링 없음)
+agenteye --json sessions --since 24h --status error
+agenteye --json sessions --agent-id checkout-bot --env prod --all --limit 1000
+
+# evals: 평가 결과 + 점수; --score는 메트릭 필터, --aggregate는 집계
+agenteye --json evals --score helpfulness:0.5..0.8 --score tool_efficiency:..0.3
+agenteye --json evals --aggregate --since 7d --env prod        # 상태 분포 + 키별 점수 통계
+
+# errors: 오류 이벤트만; --aggregate로 카운트/세션/에이전트/마지막 발생 시간 확인
+agenteye --json errors --since 24h --aggregate
+agenteye --json errors --since 24h --error-type timeout --all --limit 1000
+
+# list: 필터링 전에 유효한 필터값 탐색
+agenteye list envs        # 또한: agents event_types score_filters models hooks tools error_types
+```
+
+`--score KEY:MIN..MAX`(`sessions`이 아닌 **`evals`**에서)는 반복 가능하며 AND로 결합됩니다; 각 경계는 선택사항입니다(`..0.5`는 ≤ 0.5, `0.9..`는 ≥ 0.9). 요청당 최대 20개의 점수 필터. `evals --scores-full`은 **사람이 보는 테이블 전용** 표시 플래그로, 처음 몇 개와 `+N` 카운트 대신 모든 점수 쌍을 보여줍니다. `--json`에서는 효과가 없으며, `--json`은 항상 완전한 점수 객체를 반환합니다. **하나의 세션을 처음부터 끝까지 읽으려면** 이벤트 추적과 평가를 결합하세요:
+
+```bash
+agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'
+agenteye --json evals  --session-id run-001                       # 해당 세션의 점수 + 상태
+```
+
+### 관리 (권한 필요): `keys` · `users` · `settings` · `alerts` · `incidents`
+
+**`keys`**: API 키. 시크릿은 로컬에서 생성되어 서버로 전송되고(서버는 해시만 저장), 생성/재생성 시 **한 번만 표시**됩니다; 그 자리에서 저장하세요. `--json` 사용 시 `key` 필드에만 나타납니다. **이름**으로 참조됩니다.
+
+```bash
+agenteye keys list                                   # 활성 키 먼저, 그 다음 취소된 키
+agenteye keys show ci-bot
+agenteye keys create ci-bot --add events:read.add    # 필요한 범위만 지정; 시크릿은 한 번만 출력
+agenteye keys create ops --permission-set standard --remove queries:run   # 프리셋으로 시작 후 조정
+agenteye keys update ci-bot --add evaluations:read --yes
+agenteye keys regenerate ci-bot --yes                # 시크릿 교체 (이전 시크릿은 즉시 무효화)
+agenteye keys disable ci-bot --yes                   # 취소
+```
+
+권한은 `(permission-set ∪ --add) − --remove`로 계산됩니다. 토큰 형식은 `slug:action`(예: `events:read`) 또는 `slug:action.action`으로 하나의 리소스에 여러 액션을 지정합니다(`events:read.add` → `events:read`, `events:add`). 프리셋: `read-only`, `standard`, `admin`. 사람 전용 권한(`keys:update`)은 키에 부여할 수 없습니다.
+
+**`users`**: 조직 멤버, **이메일**로 참조됩니다(UUID id도 허용).
+
+```bash
+agenteye users list [--active-only]
+agenteye users show dev@corp.com
+agenteye users create dev@corp.com --permission-set standard
+agenteye users update dev@corp.com --add alerts:write --remove queries:delete   # 예측 + 확인
+agenteye users disable dev@corp.com --yes            # 보호된 계정/본인 계정 보호 기능 있음
+agenteye users enable dev@corp.com
+```
+
+**`settings`**: 고정된 레지스트리(기존 키를 읽고 변경만 가능; 새 키는 생성 불가).
+
+```bash
+agenteye settings list                               # 키 · 값 · 타입 · 업데이트 시간 (시크릿 마스킹)
+agenteye settings schema                             # 각 키가 허용하는 값 (타입 · 범위 · 설명)
+agenteye settings set session_ttl_secs --value 86400 --yes
+```
+
+**`alerts`**: 알림 정의, **이름**으로 참조됩니다. `create`는 위치 인수 NAME과 플래그 또는 `--file`로 전달하는 전체 JSON 본문을 받습니다.
+
+```bash
+agenteye alerts list
+agenteye alerts show high-errors
+agenteye alerts create high-errors --file alert.json          # NAME은 필수 (위치 인수)
+agenteye alerts update high-errors --severity critical --yes
+agenteye alerts test high-errors --yes                        # 테스트 알림 발송
+agenteye alerts delete high-errors --yes
+```
+
+**`incidents`**: 알림 인시던트, id로 참조됩니다(짧은 id 허용). `show`는 전체 활동 로그를 출력합니다; 조치 전에 읽어보세요.
+
+```bash
+agenteye incidents list --state firing                # 또한: acknowledged, resolved
+agenteye incidents count
+agenteye incidents show <id>
+agenteye incidents ack <id>
+agenteye incidents assign <id> you@corp.com           # 담당자는 운영자여야 함
+agenteye incidents resolve <id> --yes
+agenteye incidents open --alert-id <id> --severity critical    # 알림에 대해 수동으로 생성
+agenteye incidents comment-add <id> "root cause: upstream 5xx"
+agenteye incidents comment-list <id> ; agenteye incidents comment-delete <id> <comment-id>
+agenteye incidents subscribe <id> ; agenteye incidents unsubscribe <id> ; agenteye incidents subscribers <id>
+```
+
+### 분석 및 어시스턴트: `query` · `agent`
+
+**`query`**: 분석 스토어에 대한 저장된 SQL과 임시 실행기. 저장된 쿼리는 **이름**으로 참조됩니다; SQL은 서버 측에서 검증됩니다(SELECT/WITH만 허용, 구문 타임아웃, 행 수 제한).
+
+```bash
+agenteye query schema [TABLE]                         # 분석 뷰의 컬럼 레이아웃
+agenteye query run --sql "select count(*) from analytics.events"
+agenteye query run errs --arg prod --limit 100        # 저장된 쿼리 실행 + 위치 인수 $1
+agenteye query list ; agenteye query show errs
+agenteye query create errs --sql @errs.sql --description "errored events (24h)"
+agenteye query update errs --sql @errs.sql --yes ; agenteye query delete errs --yes
+```
+
+**`agent`**: 내장 **AI 어시스턴트**와 대화합니다(대시보드에서 채팅할 수 있는 것과 동일한 읽기 전용 분석 도구). 채팅은 짧은 chat-id로 참조됩니다(접두사로 확인).
+
+```bash
+agenteye agent health                                 # AI 어시스턴트 설정/접근 가능 여부 확인
+agenteye agent models                                 # --model에 전달할 수 있는 모델 목록 (기본값 표시)
+agenteye agent ask "which agents errored most in the last day?"    # 채팅 시작; 짧은 id 출력
+agenteye agent ask --chat <short-id> "and which tools did they call?"   # 이어서 대화
+agenteye agent chats ; agenteye agent show <short-id>
+agenteye agent rename <short-id> --title "error triage" ; agenteye agent delete <short-id>
+```
+
+---
+
+## 종료 코드
+
+| 코드 | 의미 |
+|---|---|
+| 0 | 성공 |
+| 1 | 예기치 않은 오류 (예: 대시보드가 5xx 응답) |
+| 2 | 사용 오류 (잘못된 인수, 알 수 없는 커맨드/플래그, 이름 충돌) |
+| 3 | 대시보드에 접근할 수 없음 |
+| 4 | 로그인하지 않았거나 세션이 만료됨; `agenteye login` 실행 필요 |
+| 5 | 인증은 됐지만 계정에 필요한 권한이 없음 (메시지에 권한 이름 표시) |
+| 6 | 요청한 리소스를 찾을 수 없음 (예: 알 수 없는 세션 또는 인시던트 id) |
+
+종료 코드 덕분에 CLI를 안전하게 스크립트화할 수 있습니다: 코딩 에이전트는 `4`가 반환되면 재인증을 요청하거나, `5`가 반환되면 누락된 권한을 표시하도록 분기할 수 있습니다. 종료 코드 처리 패턴과 JSON 출력 형태는 [에이전트를 위한 CLI 레시피](/ko/agenteye/cli-recipes)를 참조하세요.
+
+---
+
+## 다음 단계
+
+- **[에이전트를 위한 CLI 레시피](/ko/agenteye/cli-recipes)**: 복사해서 바로 쓸 수 있는 쿼리 패턴, `jq` 원라이너, `--fields` 프로젝션, 종료 코드 처리, JSON 출력 형태 — 코딩 에이전트가 CLI를 구동하는 것을 염두에 두고 작성되었습니다.
+- **[CLI 에이전트 스킬](/ko/agenteye/cli-skill)**: 이 CLI를 설치 가능한 Claude Code / Codex *스킬*로 패키징하여 코딩 에이전트가 자연어로 Failproof AI Observability를 제어할 수 있게 합니다.
+- **[API 키](/ko/agenteye/api-keys)**: `keys create --add …` 뒤에 있는 권한 모델.
+- **[AI 어시스턴트](/ko/agenteye/assistant)**: `agent ask`가 사용하는 어시스턴트 활성화 방법.

package/.next/standalone/docs-old/ko/agenteye/codex-capture.mdx

@@ -0,0 +1,55 @@
+---
+title: "Codex 세션 캡처"
+description: "팀의 로컬 OpenAI Codex 세션을 AgentEye에 일반 세션 및 이벤트로 수집합니다 — Codex 실행 방식을 변경할 필요가 없습니다."
+---
+
+엔지니어들은 이미 매일 OpenAI Codex를 사용하고 있습니다. Codex 세션 캡처는 해당 코딩 세션을 AgentEye에 일반 세션 및 이벤트로 가져와, 다른 모든 관측 데이터와 함께 검색하고, 재생하고, 평가할 수 있게 합니다. 이 기능은 [Python SDK](/ko/agenteye/python-sdk)를 보완합니다. SDK는 직접 작성한 에이전트를 계측하는 반면, Codex 세션 캡처는 팀이 이미 사용 중인 Codex 작업을 수집합니다 — 실행 방식을 변경할 필요가 없습니다.
+
+소형 백그라운드 수집기가 Codex의 로컬 세션 트랜스크립트를 작성되는 즉시 읽어 AgentEye로 전송합니다. 머신당 하나의 수집기로 모든 로컬 Codex 서피스를 한 번에 캡처할 수 있으며, 서피스별 설정은 필요하지 않습니다.
+
+동일한 수집기로 다른 에이전트도 캡처할 수 있습니다 — [OpenClaw](/ko/agenteye/openclaw-capture) 및 [Hermes](/ko/agenteye/hermes-capture)를 참조하세요. 사용하는 항목마다 활성화하면 단일 수집기로 여러 항목을 동시에 캡처할 수 있습니다.
+
+---
+
+## 캡처 대상
+
+**로컬**에서 실행되는 모든 Codex 서피스는 동일한 온디스크 세션 트랜스크립트를 생성하며, 수집기가 이를 모두 수집합니다:
+
+- Codex **CLI** 및 `codex exec`
+- **VS Code / IDE 확장 프로그램**
+- **데스크톱 앱** (로컬에서 세션을 실행할 경우)
+
+각 Codex 세션은 AgentEye [세션](/ko/agenteye/sessions)이 되고, 사용자 및 어시스턴트 메시지, 추론, 도구 호출, 도구 결과, 토큰 사용량은 해당하는 [이벤트](/ko/agenteye/event-stream)가 됩니다. 각 세션이 발생한 서피스(CLI, IDE, 데스크톱)가 기록되므로 구분이 가능합니다.
+
+> **클라우드 세션은 캡처되지 않습니다.** 데스크톱 앱은 점점 더 많은 세션을 Codex 클라우드에서 실행하며 머신에는 메타데이터만 저장합니다 — 읽을 수 있는 로컬 트랜스크립트가 없습니다. 로컬에서 실행된 세션만 캡처됩니다.
+
+---
+
+## 활성화 방법
+
+캡처는 활성화하기 전까지 비활성 상태입니다. `events:add` 권한이 있는 API 키([API keys](/ko/agenteye/api-keys) 참조)로 수집기를 설치하고, Codex 캡처를 활성화합니다:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \
+  | sh -s -- --key <YOUR_API_KEY> --codex-enabled
+```
+
+이 명령으로 수집기가 설치되고, 백그라운드 서비스로 등록되며, 캡처가 시작됩니다. 실행 여부를 확인합니다:
+
+```bash
+agenteye-collector health
+```
+
+최초 실행 시 기존 Codex 세션이 한 번 백필되며, 이후 새로운 활동은 몇 초 이내에 스트리밍됩니다. Codex의 파일은 읽기만 할 뿐 수정, 이동, 삭제되지 않으며, 재시작 여부와 관계없이 각 세션은 정확히 한 번만 전송됩니다.
+
+---
+
+## 확인 위치
+
+캡처된 세션은 **Sessions**에, 이벤트는 **Events** 스트림에 표시됩니다. 다른 에이전트와 동일하게 표시되므로 [세션 재생](/ko/agenteye/sessions), [검색](/ko/agenteye/queries), [평가](/ko/agenteye/evaluations), [알림](/ko/agenteye/alerts) 모두 사용 가능합니다. Codex 에이전트로 필터링하면 해당 항목만 확인할 수 있습니다.
+
+---
+
+## 개인정보 보호
+
+Codex 트랜스크립트에는 명령 출력, 파일 내용, Codex가 읽거나 쓴 모든 내용을 포함한 전체 세션이 담겨 있으며, 시크릿 정보가 포함될 수 있습니다. 캡처된 세션은 그대로 전송되므로, AgentEye에 해당 콘텐츠를 중앙화하는 것이 적절한 머신과 팀에 대해서만 캡처를 활성화하고, 수집기에는 `events:add`만 범위로 지정된 키를 사용하세요. 데이터 격리 방법에 대한 자세한 내용은 [Security](/ko/agenteye/security)를 참조하세요.

package/.next/standalone/docs-old/ko/agenteye/concepts.mdx

@@ -0,0 +1,87 @@
+---
+title: "개념"
+description: "Failproof AI Observability의 핵심 용어 — 이벤트, 세션, 평가, 감사, 발견 사항, 인시던트 — 를 한곳에서 정의합니다."
+---
+
+
+이 페이지는 Failproof AI Observability에서 사용하는 용어를 정의합니다. 다른 가이드에서 낯선 용어를 만나면 여기에서 확인하세요. 처음부터 끝까지 읽을 필요는 없습니다. 훑어보거나, 특정 용어가 궁금할 때 다시 돌아오세요.
+
+---
+
+## 데이터 모델
+
+**이벤트(Event)**
+데이터의 최소 단위입니다. 하나의 이벤트는 에이전트가 수행한 단일 단계를 기록합니다: `tool_use`, `model_request`, `hook_completed`, `error` 등. 에이전트는 [Python SDK](/ko/agenteye/python-sdk)를 통해 이벤트를 내보내며, **Events** 페이지에서 실시간으로 확인할 수 있습니다.
+
+**세션(Session)**
+`session_id`로 식별되는 하나의 에이전트 실행 단위입니다. 세션은 동일한 id를 공유하는 모든 이벤트를 묶어 **Sessions** 페이지의 단일 행으로 표시하고, 세부 페이지에서는 실행 그래프로 나타냅니다. 세션은 보통 `agent_start`로 시작하고 `agent_end`로 종료됩니다.
+
+**에이전트(Agent)**
+`agent_id`로 식별되는 실행 내 행위자입니다. 하나의 실행에 여러 에이전트가 관여할 수 있습니다. 예를 들어, 요약 서브 에이전트를 생성하는 플래너 에이전트가 있을 수 있습니다. 서브 에이전트는 `parent_id`를 가지며, Failproof AI Observability는 이를 기반으로 실행 그래프에서 각각의 레인에 표시합니다.
+
+**환경(Environment)**
+실행이 발생한 위치를 나타내는 레이블입니다: `production`, `staging`, `dev`. SDK를 구성할 때 한 번 설정합니다. 거의 모든 대시보드 페이지에서 환경별로 필터링할 수 있습니다.
+
+**컨텍스트 윈도우 사용률(Context-window fill)**
+응답이 모델의 컨텍스트 윈도우를 얼마나 사용했는지를 나타내는 백분율입니다. Failproof AI Observability는 인식된 모델의 `model_response` 이벤트에 이 값을 기록하므로, 프롬프트 증가와 임박한 컴팩션을 이벤트 스트림에서 바로 확인할 수 있습니다.
+
+---
+
+## 품질
+
+**평가(Evaluation)**
+완료된 세션에 대해 사용자가 운영하는 스코어링 서비스가 생성하는 품질 점수입니다. 평가는 선택 사항입니다. 평가자를 연결하기 전까지는 세션이 기록되지만 점수는 매겨지지 않습니다. 각 평가에는 여러 개의 명명된 점수(예: `helpfulness`, `factuality`, `tool_efficiency`)가 포함될 수 있으며, 각각에 간단한 이유 설명이 붙습니다. [평가 스위트](/ko/agenteye/evaluation-suite)를 참고하세요.
+
+**점수 키(Score key)**
+평가자가 보고하는 하나의 차원 이름으로, 예를 들어 `helpfulness`가 있습니다. 알림과 감사는 특정 점수 키를 시간에 따라 모니터링할 수 있습니다.
+
+**평가자(Evaluator)**
+사용자의 스코어링 서비스입니다. Failproof AI Observability는 완료된 실행의 전사 내용을 평가자에게 POST하고, 반환된 점수를 저장합니다. 기본 평가자는 제공되지 않으며, 스코어링 로직은 사용자가 직접 구현합니다.
+
+---
+
+## 실패 탐지 및 수정
+
+**훅(Hook)**
+에이전트 프레임워크가 단계 전후로 실행하는 가드레일 또는 부수 효과입니다: 콘텐츠 안전 검사, PII 제거, 예산 제한 등. 훅은 `outcome`(allow, deny, modify)이 포함된 `hook_triggered` / `hook_completed` 이벤트를 내보내며, 별도의 관찰 페이지를 가집니다.
+
+**알림 규칙(Alert rule)**
+지정한 임계값을 지표가 초과할 때 실행되는 규칙입니다: 오류율, p95 레이턴시, 토큰 비용, 또는 평가자 점수 등. 규칙이 실행되면 인시던트가 생성되고 선택한 채널(이메일, Slack, 웹훅, 대시보드 내)로 알림이 전송됩니다. [알림](/ko/agenteye/alerts)을 참고하세요.
+
+**인시던트(Incident)**
+알림 규칙이 실행될 때 생성되는 오픈 이슈입니다. 인시던트는 수명 주기(확인, 할당, 해결)와 모든 작업을 기록하는 활동 타임라인을 가집니다. 수동으로 직접 열 수도 있습니다.
+
+**감사(Audit)**
+규칙을 별도로 정의하지 않은 실패 패턴을 찾기 위해 세션 전체에 걸쳐 로그를 주기적으로(시간별~주간) 분석하는 조사입니다: 오류 클러스터, 낮은 점수, 레이턴시 이상값, 도구 호출 루프, 완료되지 않은 실행 등. 알림이 이미 알고 있는 지표를 감시한다면, 감사는 다음에 무엇을 살펴봐야 할지 알려줍니다. [감사](/ko/agenteye/audits)를 참고하세요.
+
+**발견 사항(Finding)**
+감사 실행에서 나온 순위가 매겨진 증거 기반의 결과입니다. 발견 사항은 패턴을 명명하고, 그 배후의 정확한 세션을 링크하며, 트리아지 수명 주기(확인, 해결, 음소거, 기각)를 가집니다. Failproof AI Observability는 실행이 반복되어도 이미 알려진 패턴은 새로 쌓이지 않고 업데이트되도록 발견 사항을 중복 제거합니다.
+
+**AI 어시스턴트(The AI assistant)**
+사용자 자신의 데이터를 기반으로 에이전트에 대한 질문에 자연어로 답하는 대시보드 내 채팅입니다. 기본적으로 읽기 전용이며, 어시스턴트가 생성하는 것(저장된 쿼리, 대시보드)은 승인 절차를 거쳐야 하고, 삭제는 절대 할 수 없습니다. [AI 어시스턴트](/ko/agenteye/assistant)를 참고하세요.
+
+---
+
+## 운영
+
+**조직(Organization, 테넌트)**
+격리된 워크스페이스입니다. 하나의 Failproof AI Observability 인스턴스는 각자의 사용자, 키, 데이터를 가진 여러 조직을 호스팅할 수 있습니다. 모든 대시보드 URL은 조직 슬러그(`/<org-slug>/…`) 아래에 범위가 지정됩니다.
+
+**컬렉터(Collector)**
+`agenteye-collector`는 각 에이전트 머신에서 실행되는 경량 데몬으로, SDK가 디스크에 기록하는 이벤트를 배치로 묶어 서버로 전송합니다.
+
+**API 키(API key)**
+클라이언트를 서버에 인증하는 범위가 지정된 토큰입니다. 키는 세분화된 권한을 가집니다(예: 컬렉터를 위한 `events:add`, 대시보드 키를 위한 읽기 전용 범위). [API 키](/ko/agenteye/api-keys)를 참고하세요.
+
+**서버(Server)**
+수집 및 API 서비스입니다. 이벤트를 수집하고, 데이터베이스에 운영 상태를 저장하며, 대시보드와 CLI를 제공합니다.
+
+**대시보드(Dashboard)**
+웹 UI입니다. 모든 페이지는 조직 범위로 지정되며 서버의 API를 통해 데이터를 읽습니다.
+
+---
+
+## 다음 단계
+
+- [개요](/ko/agenteye/overview): 이 구성 요소들이 어떻게 맞물리는지 확인하세요.
+- [Observability](/ko/agenteye/observability): 관찰 화면(Events, Sessions, Models, Tools, Hooks, Errors).

package/.next/standalone/docs-old/ko/agenteye/dashboards.mdx

@@ -0,0 +1,46 @@
+---
+title: "대시보드"
+description: "실시간 에이전트 데이터를 팀 전체가 함께 보는 하나의 화면으로 만드세요."
+---
+
+
+실시간 에이전트 데이터를 팀 전체가 함께 보는 하나의 화면으로 만드세요. 중요한 쿼리를 차트로 고정해 두면, 누구나 단 한 번의 쿼리 재실행 없이 동일한 수치를 한눈에 확인할 수 있습니다.
+
+![저장된 쿼리로 구성된 대시보드: 시간당 이벤트 라인 차트, 유형별 오류 막대 차트, 지연 시간 영역 차트, 모델별 토큰 수](/agenteye/images/dashboard-fleet.png)
+
+*하나의 보드, 네 개의 저장된 쿼리: 시간당 이벤트, 유형별 오류, 지연 시간, 모델별 토큰 수.*
+
+## 모두가 같은 현실을 본다
+
+스크린샷을 채팅에 붙여넣거나 같은 쿼리를 하루에 다섯 번씩 다시 실행하는 일은 이제 그만하세요. 대시보드는 팀 내 누구나 동일한 화면을 열 수 있는 조직 공유 보드입니다. 기반 데이터가 변하면 차트도 함께 변하기 때문에 보드는 항상 최신 상태를 유지하고, 오래된 수치를 두고 다툴 일이 없습니다.
+
+위의 플릿 대시보드는 일상적인 운영에 적합한 기본 구성입니다:
+
+- **시간당 이벤트** 라인 차트 — 처리량을 모니터링하고 급격한 감소를 포착할 수 있습니다
+- **유형별 오류** 막대 차트 — 주요 장애 범주를 한눈에 파악할 수 있습니다
+- **지연 시간** 영역 차트 — 사용자가 불편을 느끼기 전에 속도 저하를 미리 확인할 수 있습니다
+- **모델별 토큰 수** 분석 — 비용을 항상 시야에 두고 관리할 수 있습니다
+
+보드는 `/<org-slug>/dashboards`에서 찾을 수 있습니다.
+
+## 이미 저장한 쿼리를 고정하세요
+
+모든 타일은 저장된 쿼리에서 시작합니다. [쿼리](/ko/agenteye/queries) 라이브러리(기본 제공 프리셋과 이벤트 및 평가 데이터를 기반으로 한 직접 작성 쿼리 포함)에서 원하는 쿼리를 빌드하고 저장한 다음, 데이터에 맞는 차트 형식으로 대시보드에 고정하세요. 시간에 따른 추세에는 **라인**, 카테고리 비교에는 **막대**, 볼륨에는 **영역**, 구성 비율에는 **파이** 차트가 적합합니다.
+
+타일은 저장된 쿼리를 차트로 렌더링한 것에 불과하기 때문에 수동으로 동기화할 필요가 없습니다. 쿼리를 한 번 업데이트하면 해당 쿼리를 사용하는 모든 대시보드가 자동으로 업데이트됩니다.
+
+## 단순한 양이 아닌 품질을 모니터링하세요
+
+양은 에이전트가 바쁘다는 것을 알려줍니다. 품질은 에이전트가 실제로 제대로 역할을 하고 있는지를 알려줍니다. [평가 점수](/ko/agenteye/evaluations)를 대시보드에 연결하면 실행 품질이 시간에 따라 어떻게 변하는지 추적할 수 있어, 품질 저하가 고객의 불만으로 이어지기 전에 차트의 하락으로 먼저 나타납니다.
+
+![저장된 평가 쿼리로 구성된 품질 중심 대시보드](/agenteye/images/dashboard-quality.png)
+
+*품질 보드는 운영 지표 바로 옆에 평가 점수를 전면에 배치합니다.*
+
+운영 보드와 품질 보드를 나란히 유지하면, 팀이 "제대로 작동하고 있는가?"와 "잘 하고 있는가?" 두 질문에 하나의 공간에서 답할 수 있습니다. 쿼리를 다시 실행할 필요도 없습니다.
+
+## 관련 항목
+
+- [쿼리](/ko/agenteye/queries): 타일의 기반이 되는 쿼리를 빌드하고 저장하세요.
+- [평가](/ko/agenteye/evaluations): 실행을 채점하여 시간에 따른 품질을 차트로 확인하세요.
+- [알림](/ko/agenteye/alerts): 이러한 지표의 임계값을 알림으로 전환하세요.

package/.next/standalone/docs-old/ko/agenteye/error-tracking.mdx

@@ -0,0 +1,40 @@
+---
+title: "오류 추적"
+description: "에이전트에서 발생하는 모든 실패를 한 곳에서 확인하세요. 동일한 오류가 연속으로 발생해도 하나의 문제로 묶어서 보여줍니다."
+---
+
+에이전트에서 발생하는 모든 실패를 한 곳에서 확인하세요. 동일한 오류가 연속으로 발생해도 하나의 문제로 묶어서 보여줍니다. 라이브 피드를 스크롤하지 않아도, "뭔가 빨간색이다"에서 문제가 발생한 정확한 실행까지 클릭 한 번으로 이동할 수 있습니다.
+
+![오류 페이지: 시간별 실패 히스토그램 아래에 빨간색 오류 행이 그룹으로 표시되며, 각 행에는 원클릭 "+ alert" 버튼이 있습니다](/agenteye/images/errors.png)
+*오류 페이지: 시간별 실패 히스토그램과 반복 실패를 인시던트 단위로 하나의 행으로 묶어서 표시합니다.*
+
+## 모든 실패를 자동으로 수집
+
+에이전트가 중단되었을 때, 빨간색 행이 사라지기 전에 잡으려고 라이브 이벤트 스트림을 스크롤할 필요가 없어야 합니다. **오류** 페이지가 대신 수집해 드립니다. 대시보드에서 빨간색으로 표시될 모든 항목을 하나의 트리아지 화면으로 모아주기 때문에, 처음 보는 화면에서 바로 무엇이 실패하고 있는지 확인할 수 있습니다.
+
+또한 명확한 오류뿐만 아니라 조용한 실패도 포착합니다. 명시적인 `error` 이벤트 외에도, Failproof AI Observability는 `tool_result`, `hook_completed`, `agent_end`의 페이로드에 실패가 포함된 경우도 모두 여기에 표시합니다. 오류를 반환한 도구나 비정상 종료된 훅도, 큰 예외를 던지지 않았다는 이유만으로 그냥 지나치지 않습니다.
+
+페이지 상단에는 히스토그램이 시간에 따른 오류를 시각화합니다. 한 눈에 보면 현재 상황이 지속적인 백그라운드 오류인지, 아니면 몇 분 전에 시작된 급증인지 즉시 파악할 수 있어 지금 당장 대응해야 할지 판단할 수 있습니다.
+
+다른 모든 관찰 화면과 마찬가지로, 오류 페이지는 조직 범위로 한정되며 날짜 범위, 환경, 에이전트, 세션별로 필터링할 수 있습니다. 전체 목록에서 실제로 관심 있는 특정 에이전트나 환경으로 좁혀볼 수 있습니다.
+
+## 수백 개의 동일한 행이 아닌 하나의 인시던트
+
+단일 의존성 오류 하나가 분당 수백 번 동일한 오류를 발생시킬 수 있습니다. 그대로 두면 거의 동일한 줄이 벽처럼 쌓여 실제로 확인해야 할 중요한 정보가 묻혀버립니다.
+
+Failproof AI Observability는 동일한 세션과 오류 유형을 공유하는 반복 실패를 하나의 행으로 묶습니다. 연속 발생은 하나의 인시던트로 읽힙니다. 로그 라인이 아닌 문제 수를 세게 되고, 중요한 신호가 자체 볼륨에 묻히는 대신 상단에 유지됩니다.
+
+## "뭔가 빨간색이다"에서 정확한 이벤트로
+
+행을 클릭하면 해당 실행의 세션으로 바로 이동하며, 실패한 정확한 이벤트에 위치가 맞춰집니다. 세션 ID를 복사하거나 문제가 발생한 순간을 찾아 스크롤할 필요가 없습니다. 에이전트가 중단되기 직전에 무엇을 했는지 한눈에 볼 수 있도록 전체 실행 그래프와 함께 바로 해당 지점에 도착합니다.
+
+`alerts:write` 권한이 있다면, 모든 행에 **+ alert** 버튼도 표시됩니다. 클릭하면 Observability가 동일한 실패를 다시 포착하도록 이미 설정이 채워진 새 알림 규칙을 엽니다. 방금 트리아지한 인시던트가 다음에도 예고 없이 놀라게 하는 대신, 다음 번에는 알림을 보내줍니다.
+
+**찾는 방법:** **오류** 페이지는 대시보드의 관찰 섹션에 있으며, `/<org-slug>/errors` 경로에서 확인할 수 있습니다.
+
+## 관련 항목
+
+- [알림](/ko/agenteye/alerts): 모든 실패를 페이징 규칙으로 전환합니다.
+- [인시던트](/ko/agenteye/incidents): 발생한 알림을 열림에서 해결까지 추적합니다.
+- [세션](/ko/agenteye/sessions): 오류 뒤에 있는 전체 실행을 엽니다.
+- [감사](/ko/agenteye/audits): Observability가 실행 전반에 걸친 실패 패턴을 자동으로 찾아줍니다.