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

# nora traces

> 에이전트 실행 나열·검사, 출력 검증, 검증 결과 뽑기.

트레이스가 모든 에이전트 실행의 기록. CLI 가 규모에서 트레이스 쿼리 가장 빠른 방법 — 상태·날짜·판정·자유 텍스트 검색으로 필터 — 그리고 프로그래매틱하게 검증기 패스 트리거.

## 명령

| 명령                               | 설명                  |
| -------------------------------- | ------------------- |
| `traces list [flags]`            | 필터와 함께 트레이스 나열.     |
| `traces get <trace-id>`          | 전체 트레이스 페이로드 fetch. |
| `traces verify <trace-id>`       | 검증기 트리거 (비동기).      |
| `traces verification <trace-id>` | 검증기 요약 fetch.       |
| `traces stats`                   | 워크스페이스 전체 카운터.      |

## `traces list`

```bash theme={null}
nora traces list \
  --flow support-agent \
  --status completed \
  --from 2026-07-01 \
  --limit 50
```

### 필터

* `--status pending|running|completed|error` — 실행 상태.
* `--needs-review` — 사람 리뷰 플래그된 트레이스만.
* `--search <text>` — 프롬프트·도구 인자·도구 응답·답변에 대한 전문.
* `--from <YYYY-MM-DD>` / `--to <YYYY-MM-DD>` — 날짜 범위.
* `--flow <slug>` — 한 Flow 로 스코프.
* `--verdict <verdict>` — 검증 판정으로 필터: `SUPPORT`, `PARTIALLY_SUPPORTED`, `NOT_SUPPORT`, `unverified`.
* `--limit <n>` — 최대 로우. 기본 50.
* `--page <n>` — 페이지네이션, 1 기반.

구조화 출력에 `--json` 추가.

## `traces get`

```bash theme={null}
nora traces get tr_abc
```

전체 트레이스 인쇄: 모든 span, 모든 도구 호출, 모든 리트리벌, 모델 출력, 있으면 검증 결과. 항상 JSON — 트레이스가 크고 구조화됨.

흔한 용도:

* 오프라인 리뷰용 저장: `nora traces get tr_abc > trace-tr_abc.json`.
* 도구 호출만 추출: `nora traces get tr_abc | jq '.spans[] | select(.kind=="tool")'`.
* 두 실행 diff: `diff <(nora traces get tr_a) <(nora traces get tr_b)`.

## `traces verify`

```bash theme={null}
nora traces verify tr_abc
```

트레이스에 검증기 패스 트리거. 검증기가 답변을 클레임으로 분해하고 각각을 리트리벌된 증거에 대조.

비동기 — 명령이 job ID 로 즉시 반환. `traces verification` 폴링해서 결과 얻음.

플래그:

* `--decompose-model <m>` — 클레임 분해에 쓰는 모델 오버라이드.
* `--verify-model <m>` — 각 클레임 체크에 쓰는 모델 오버라이드.

둘 다 워크스페이스 기본 ([Providers](/ko/cli/providers) 참고) 기본.

## `traces verification`

```bash theme={null}
nora traces verification tr_abc
```

검증기 요약 fetch — 전체 판정, 클레임별 결과, 뒷받침 대 미뒷받침 클레임 비율.

판정:

* `SUPPORT` — 모든 클레임이 리트리벌된 증거에 뒷받침.
* `PARTIALLY_SUPPORTED` — 일부 클레임 뒷받침, 일부 아님.
* `NOT_SUPPORT` — 답변에 대한 뒷받침 발견 안 됨.
* `unverified` — 검증 트리거 안 됨.

트레이스가 아직 검증 안 됐으면 `unverified` 반환 — 먼저 `traces verify` 호출.

## `traces stats`

```bash theme={null}
nora traces stats
```

워크스페이스 전체 카운터:

* 총 트레이스 (전체 시간과 최근 24h).
* Flow 별 트레이스.
* 판정 분포.
* 에러율.

앱 열지 않고 빠른 건강 체크에 좋음.

원시 숫자에 `--json` 추가.

## 레시피

### 한 Flow 의 최근 실패 찾기

```bash theme={null}
nora traces list \
  --flow support-agent \
  --status error \
  --from $(date -v-7d +%Y-%m-%d) \
  --limit 100
```

### 야간: 검증 누락된 모든 트레이스에 검증기 실행

```bash theme={null}
nora traces list --verdict unverified --status completed --limit 500 --json \
  | jq -r '.[].id' \
  | while read id; do
      nora traces verify "$id"
    done
```

### 주간 리포트: NOT\_SUPPORT 율

```bash theme={null}
total=$(nora traces list --from $(date -v-7d +%Y-%m-%d) --json | jq 'length')
notsupport=$(nora traces list --from $(date -v-7d +%Y-%m-%d) --verdict NOT_SUPPORT --json | jq 'length')
echo "NOT_SUPPORT 율: $notsupport / $total"
```

### 오프라인 분석용 트레이스 벌크 다운로드

```bash theme={null}
mkdir -p traces-export
nora traces list --from 2026-07-01 --limit 1000 --json | jq -r '.[].id' \
  | while read id; do
      nora traces get "$id" > "traces-export/$id.json"
    done
```

### 트레이스를 시그널에 붙임

트레이스에서 시그널 생성하는 CLI 명령 없음 — 그건 앱 사용. 프로그래매틱 피드백은 [`nora feedback`](/ko/cli/feedback) 참고.

## 트레이스 보존

트레이스가 Flow 설정에 따라 보존 (기본 90일). 페이로드 보존 (원시 프롬프트와 도구 인자) 이 컴플라이언스 워크로드에 더 짧을 수 있음. 트레이스 페이로드가 스크럽되면 `traces get` 이 메타데이터만 반환.

`traces stats` 가 보존 존중 — 카운터가 스크러빙에 영향 안 받음 (메타데이터가 페이로드보다 오래 유지).

## 관련

* [트레이스 개요](/ko/reliable/traces/overview) — 개념.
* [`nora feedback`](/ko/cli/feedback) — 트레이스에 피드백 붙임.
* [`nora approvals`](/ko/cli/approvals) — 사람 기다리는 실행의 승인 결정.