실행 추적 기록 읽기
Trace 화면은 요청이 시작되어 응답을 받기까지의 실행 흐름을 시간축으로 보여줍니다. 분산 추적(Distributed tracing)은 프로세스, 네트워크 및 보안 경계를 넘는 작업을 하나의 요청 흐름으로 연결합니다.
개별 작업은 추적 구간(Span)으로 표시됩니다. 구간의 길이와 부모 및 자식 구간의 관계를 보면 어디에 시간이 쓰였는지, 어떤 호출 안에서 다른 작업을 수행했는지 파악할 수 있습니다.
시간축과 계층
| 화면 요소 | 읽는 방법 |
|---|---|
| 가로 막대 | 작업의 실행 기간 |
| 중첩된 추적 구간 | 작업 사이의 부모·자식 관계 |
| 색상 | 함수, 액션, 자동화, 모델 또는 LLM 호출 등의 리소스 유형 |
| 구간별 실행 시간 | 해당 작업에 소요된 시간 |
추적 구간 상세
추적 구간을 선택하면 Trace Log Details에서 해당 작업의 정보를 확인합니다.
| 정보 | 내용 |
|---|---|
| 작업 이름 | 실행한 함수, 액션, 언어 모델, 자동화, 모델 또는 내부 작업 |
| 실행 기간 | 작업에 걸린 시간 |
| 입력과 출력 | 함수 실행 요청의 인수와 반환값 |
| 모델 상호작용 | LLM 호출의 프롬프트, 응답 및 토큰 사용량 |
| 오류 정보 | 실패한 작업의 오류 메시지와 스택 추적 |
| 추적 식별자 | 관측 데이터 조회와 로그 연결에 쓰는 식별자 |
두 종류의 추적 식별자
foundryTraceId는 Foundry가 부여하며 관측 데이터를 조회하는 데 사용하는 식별자입니다.x-b3-traceid는 표준 분산 추적 식별자이며 서비스 로그 항목의 tags 필드에 포함될 수 있습니다.
x-b3-traceid는 항상 포함되지는 않으며, Ontology SDK로 만든 애플리케이션 등 Foundry 밖에서 생성된 로그에는 없을 수 있습니다.
접근 조건
추적 기록과 서비스 로그에는 프롬프트, 함수 인수 및 객체 데이터가 들어갈 수 있습니다. 공유 실행을 보려면 관리자가 해당 실행 시작 리소스에 로그 접근을 활성화하고, 사용자가 필요한 역할과 보안 표지 접근 조건을 충족해야 합니다.
일반 인스턴스에서는 실행 이력 작업 권한을 가진 사용자가 본인이 실행한 최근 24시간의 로그를 볼 수 있습니다. 보안 분류 기반 접근 제어(CBAC)를 사용하는 인스턴스에는 이 예외가 없으므로 본인의 실행도 로그 접근 설정이 필요합니다. 세부 요건은 로그 권한에서 확인합니다.
추적 구간의 상세 메시지는 서비스 로그에서 조사하고, 시간 분포를 개선하려면 성능 모니터링과 최적화를 함께 사용합니다.