> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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>`          | 전체 트레이스 페이로드 가져오기. |
| `traces verify <trace-id>`       | 검증기 트리거(비동기).      |
| `traces verification <trace-id>` | 검증기 요약 가져오기.       |
| `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
```

검증기 요약 가져오기: 전체 판정, 주장별 결과, 뒷받침된 주장 대 아닌 주장 비율.

판정:

* `SUPPORT` 모든 주장이 리트리벌한 증거로 뒷받침됨.
* `PARTIALLY_SUPPORTED` 일부는 뒷받침, 일부는 아님.
* `NOT_SUPPORT` 답변을 뒷받침할 근거를 못 찾음.
* `unverified` 검증을 안 걸었음.

트레이스를 아직 검증 안 했으면 `unverified`를 돌려줌. 먼저 `traces verify`를 호출.

## `traces stats`

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

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

* 총 트레이스(전체 기간과 최근 24시간).
* 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) 사람을 기다리는 실행의 승인 결정.