트레이스와 세션

에이전트 실행 한 번을 타임라인으로, 대화 전체를 하나의 세션으로 봅니다. 어떤 호출이 병렬로 실행됐는지, 시간이 어디에 쓰였는지, 무엇이 실패했고 비용이 얼마였는지 알 수 있습니다.

콘솔 사이드바 위치(해당 기능이 계정에 적용되면 표시됩니다): Traces 열기 ↗

진행 단계

한 번의 실행(사용자 요청 하나, 에이전트 작업 하나)에 속한 모든 호출에 X-Trace-Id를, 각 호출의 이름으로 X-Span-Id를, 한 대화의 모든 호출에 X-Session-Id를 보냅니다. Claude Code처럼 자체 트레이스나 세션 헤더를 보내는 도구는 변경 없이 묶입니다.
트레이스를 엽니다. 최근 7일간의 트레이스와 세션이 호출 수, 소요 시간, 비용과 함께 최근 요청 순으로 나열됩니다. 열 제목을 선택하면 그 열을 기준으로 정렬됩니다. 트레이스나 세션 페이지에서 이름 변경을 선택하면 이름을 붙일 수 있고, 워크스페이스의 모든 구성원에게 표시됩니다. 검색에는 전체 ID나 이름의 일부를 입력합니다.
트레이스를 열면 워터폴이 보입니다. 호출마다 막대 하나가 시간 순으로 놓이고, 내 코드가 실행되던 구간은 내 앱으로 표시됩니다. 병렬 호출은 겹쳐 보입니다. 실패한 호출은 빗금과 상태 코드로 표시되며, 호출을 선택하면 지연 시간, 토큰, 비용을 볼 수 있습니다.
세션을 열면 합계, 사용한 모델, 상태 코드별 오류, 시간에 따른 호출 분포를 볼 수 있습니다. 로그에서 호출 보기를 누르면 세션의 모든 요청이 나열됩니다.

트레이스와 세션은 요청 로그로 만들어지므로, 로그와 같은 90일과 같은 호출을 다룹니다.
실패한 호출에는 제공업체가 반환한 오류를 포함해 코드가 실제로 받은 상태 코드가 표시됩니다.
ID는 직접 정합니다. 각각 출력 가능한 ASCII 문자 최대 128자이며, 응답으로 되돌아오고 제공업체에는 전송되지 않습니다.
코딩 에이전트가 서브 에이전트를 구분해 보내면, 세션에는 에이전트별 호출 수와 비용이 나열되고, 트레이스에는 압축과 보조 호출이 표시되며 두 호출 사이에 실행된 도구의 이름이 나옵니다.
게이트웨이가 여러 번 시도한 요청은 상세 화면에 각 시도의 모델, 상태 코드, 소요 시간이 나열됩니다. 워터폴에서는 실패한 시도가 막대 앞부분에 빗금으로 표시됩니다.

같은 기능의 API 레퍼런스: 요청 헤더