시작하기
Trace 뷰로 들어가려면:- Traces 탭으로 이동합니다.
- 아무 트레이스나 클릭하여 Trace 뷰를 엽니다. Trace 뷰가 팝업되고 트레이스 실행의 계층적 분석을 표시합니다.
Traces 페이지 개요
Traces 페이지는 세 개의 핵심 패널로 구성됩니다:- 왼쪽 사이드바: 프로젝트의 모든 트레이스 실행을 정렬 가능하고 페이지가 매겨진 목록입니다.
- 중앙 패널: 대화형 trace view로 선택한 트레이스의 스택 및 작업 계층 구조를 보여줍니다.
- 오른쪽 패널: 선택한 작업(Call, Code, Feedback, Scores, Summary, Use)에 대한 상세 보기입니다.
Trace 뷰 탐색
- 이동 경로: 중앙 패널 상단에서 이동 경로를 통해 트레이스 스택을 위아래로 탐색할 수 있습니다.
- 스택 화살표:
↑및↓버튼을 사용하여 스택을 위아래로 이동합니다. - 더블 클릭: 작업을 더블 클릭하여 해당 하위 스택만 보이도록 뷰를 집중합니다.
- “맨 위로 이동” 버튼: 트레이스 스택의 루트로 돌아갑니다.
필터 및 검색
- 작업 이름으로 필터링: 트레이스 트리 위의 입력 바를 사용하여 특정 유형의 작업을 검색합니다(예:
tool,openai.response.create). - 필터 지속성: 트레이스 간에 작업을 선택하면 더 쉬운 비교를 위해 하위 경로 컨텍스트가 유지됩니다.
스크러버 및 컨텍스트 탐색
트리 아래의 패널에는 호출 간 탐색을 위한 여러 스크러버가 포함되어 있습니다:- 타임라인: 이벤트의 시간순 순서.
- 피어: 동일한 유형을 공유하는 작업.
- 형제: 동일한 부모를 가진 작업.
- 스택: 호출 스택을 위/아래로 이동합니다.
대체 트레이스 트리 뷰
필요에 따라 트레이스 트리의 여러 시각적 표현 간에 전환할 수 있습니다. 대체 트레이스 뷰로 전환하려면 오른쪽 상단 모서리에서 사용 가능한 옵션(기본 트레이스 뷰, 코드 구성, 플레임 그래프, 그래프 뷰) 중 하나를 클릭하세요트레이스(기본)
스택 계층 구조, 작업당 비용, 실행 시간 및 상태 표시기를 보여주는 기본 뷰입니다.코드 뷰
코드 뷰에서는 상자가 작업과 중첩된 호출을 나타냅니다. 이는 함수 호출 흐름을 시각화하는 데 도움이 됩니다. 이 뷰에서는 상자를 클릭하여 해당 작업으로 드릴다운하고 호출 경로를 필터링할 수 있습니다.
플레임 그래프
플레임 그래프 뷰는 실행 깊이와 지속 시간에 대한 타임라인 기반 시각화를 제공합니다. 이는 시간에 따른 성능 진단을 이해하려고 할 때 유용합니다. 프레임을 클릭하여 하위 트레이스를 분리할 수 있습니다.
그래프 뷰
그래프 뷰는 작업 간의 계층적 관계를 보여줍니다. 이는 부모/자식 관계를 이해하는 데 유용합니다.사용 팁과 요령
- 트레이스 트리 뷰 상단의 “작업 이름으로 필터링” 검색 바를 사용하여 관련 도구 또는 LLM 호출을 빠르게 분리합니다.
- 디버깅 필요에 따라 뷰 간에 전환하세요. 코드 뷰는 호출 로직에, 플레임 그래프는 시간에 따른 성능을 이해하는 데, 그래프 뷰는 구조를 이해하는 데 사용하세요.