> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-feature-automate-reference-docs-generation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Trace tree

Weave Trace 뷰는 LLM 및 에이전트 앱의 복잡한 실행 경로를 이해하는 데 도움이 되도록 설계되었습니다. 수십 개의 중첩된 호출이 있는 에이전트 앱을 디버깅하든, 단일 모델 예측의 흐름을 추적하든, Trace 뷰는 명확한 분석을 제공하면서 애플리케이션 흐름을 보고 이해하는 다양한 방법을 제공합니다.

이 가이드는 트레이스 스택을 탐색하고, 작업을 필터링하고 검색하며, 시각적 표현 간에 전환하는 방법 등을 설명합니다.

## 시작하기

Trace 뷰로 들어가려면:

1. **Traces** 탭으로 이동합니다.
2. 아무 트레이스나 클릭하여 Trace 뷰를 엽니다. Trace 뷰가 팝업되고 트레이스 실행의 계층적 분석을 표시합니다.

## Traces 페이지 개요

Traces 페이지는 세 개의 핵심 패널로 구성됩니다:

* *왼쪽 사이드바*: 프로젝트의 모든 트레이스 실행을 정렬 가능하고 페이지가 매겨진 목록입니다.
* *중앙 패널*: 대화형 [trace view](#trace-view-navigation)로 선택한 트레이스의 스택 및 작업 계층 구조를 보여줍니다.
* *오른쪽 패널*: 선택한 작업(Call, Code, Feedback, Scores, Summary, Use)에 대한 상세 보기입니다.

![Trace page panels](https://mintlify.s3.us-west-1.amazonaws.com/wb-21fd5541-feature-automate-reference-docs-generation/ko/guides/tracking/imgs/trace-tree-full.png)

## Trace 뷰 탐색

* *이동 경로*: 중앙 패널 상단에서 이동 경로를 통해 트레이스 스택을 위아래로 탐색할 수 있습니다.
* *스택 화살표*: `↑` 및 `↓` 버튼을 사용하여 스택을 위아래로 이동합니다.
* *더블 클릭*: 작업을 더블 클릭하여 해당 하위 스택만 보이도록 뷰를 집중합니다.
* *"맨 위로 이동" 버튼*: 트레이스 스택의 루트로 돌아갑니다.

### 필터 및 검색

* *작업 이름으로 필터링*: 트레이스 트리 위의 입력 바를 사용하여 특정 유형의 작업을 검색합니다(예: `tool`, `openai.response.create`).
* *필터 지속성*: 트레이스 간에 작업을 선택하면 더 쉬운 비교를 위해 하위 경로 컨텍스트가 유지됩니다.

![Filter an op by name](https://mintlify.s3.us-west-1.amazonaws.com/wb-21fd5541-feature-automate-reference-docs-generation/ko/guides/tracking/imgs/trace-tree-filter.png)

### 스크러버 및 컨텍스트 탐색

트리 아래의 패널에는 호출 간 탐색을 위한 여러 스크러버가 포함되어 있습니다:

* **타임라인**: 이벤트의 시간순 순서.
* **피어**: 동일한 유형을 공유하는 작업.
* **형제**: 동일한 부모를 가진 작업.
* **스택**: 호출 스택을 위/아래로 이동합니다.

사용 가능한 스크러버를 보려면 패널 하단의 **^** 버튼을 클릭하세요.

각 스크러버에는 슬라이더와 **>** 점프 버튼이 있어 단계별로 이동할 수 있습니다.

![Trace panel scrubbers](https://mintlify.s3.us-west-1.amazonaws.com/wb-21fd5541-feature-automate-reference-docs-generation/ko/guides/tracking/imgs/trace-tree-scrubbers.png)

### 대체 트레이스 트리 뷰

필요에 따라 트레이스 트리의 여러 시각적 표현 간에 전환할 수 있습니다. 대체 트레이스 뷰로 전환하려면 오른쪽 상단 모서리에서 사용 가능한 옵션(기본 트레이스 뷰, 코드 구성, 플레임 그래프, 그래프 뷰) 중 하나를 클릭하세요

#### 트레이스(기본)

스택 계층 구조, 작업당 비용, 실행 시간 및 상태 표시기를 보여주는 기본 뷰입니다.

#### 코드 뷰

코드 뷰에서는 상자가 작업과 중첩된 호출을 나타냅니다. 이는 함수 호출 흐름을 시각화하는 데 도움이 됩니다. 이 뷰에서는 상자를 클릭하여 해당 작업으로 드릴다운하고 호출 경로를 필터링할 수 있습니다.

![Trace panel code view](https://mintlify.s3.us-west-1.amazonaws.com/wb-21fd5541-feature-automate-reference-docs-generation/ko/guides/tracking/imgs/trace-tree-code-view.png)

#### 플레임 그래프

플레임 그래프 뷰는 실행 깊이와 지속 시간에 대한 타임라인 기반 시각화를 제공합니다. 이는 시간에 따른 성능 진단을 이해하려고 할 때 유용합니다. 프레임을 클릭하여 하위 트레이스를 분리할 수 있습니다.

![Trace panel flame graph](https://mintlify.s3.us-west-1.amazonaws.com/wb-21fd5541-feature-automate-reference-docs-generation/ko/guides/tracking/imgs/trace-tree-flame-view.png)

#### 그래프 뷰

그래프 뷰는 작업 간의 계층적 관계를 보여줍니다. 이는 부모/자식 관계를 이해하는 데 유용합니다.

## 사용 팁과 요령

* 트레이스 트리 뷰 상단의 **"작업 이름으로 필터링"** 검색 바를 사용하여 관련 도구 또는 LLM 호출을 빠르게 분리합니다.
* 디버깅 필요에 따라 뷰 간에 전환하세요. **코드 뷰**는 호출 로직에, **플레임 그래프**는 시간에 따른 성능을 이해하는 데, **그래프 뷰**는 구조를 이해하는 데 사용하세요.