트레이스 관리하기

트레이스를 공개적으로 공유하고, LangSmith의 Details 보기에서 서버 로그를 보는 방법을 알려드릴게요.

트레이스를 공개 공유할 수 있고, 트레이스 실행과 관련된 서버 로그를 볼 수 있습니다.

출처: 문서

본문

트레이스 공유

경고: 트레이스를 공개적으로 공유하면 링크를 가진 사람이라면 누구에게나 접근 가능해집니다. 민감한 정보를 공유하지 않는지 확인하세요.

셀프 호스팅 LangSmith 배포가 VPC 내에 있다면 공개 링크는 VPC 내에서 인증된 구성원만 접근할 수 있습니다. 보안 강화를 위해 네트워크에 접근 권한이 있는 사용자만 접근할 수 있는 비공개 URL로 인스턴스를 구성하는 것을 권장합니다.

트레이스를 공개적으로 공유하려면:

UI에서 트레이스를 엽니다.
Details 보기 상단의 더보기 메뉴에서 Share 버튼을 클릭합니다.
나타나는 대화상자에서 공개 링크를 복사합니다.

공유된 트레이스는 LangSmith 계정이 없어도 링크를 가진 사람이라면 누구나 접근할 수 있습니다. 트레이스를 볼 수 있지만 편집할 수는 없습니다.

트레이스 공유를 해제하려면 다음 방법 중 하나를 사용하세요:

공유된 트레이스를 열고 Details 보기 상단 툴바의 Public을 클릭한 뒤 대화상자에서 Unshare를 클릭합니다.
Settings > Shared URLs로 이동해 선택한 워크스페이스에서 공개 공유된 모든 트레이스를 봅니다. 공유 해제하려는 트레이스 옆의 Unshare를 클릭합니다.

서버 로그 보기

참고: 트레이스의 서버 로그 보기는 Cloud SaaS와 완전 셀프 호스팅 배포 옵션에서만 동작합니다.

LangSmith에서 실행으로 생성된 트레이스를 볼 때 Details 보기에서 관련 서버 로그에 직접 접근할 수 있습니다.

Details 보기에서 오른쪽 위 Run in Studio 버튼 옆의 See Logs 버튼을 사용하세요.

이 버튼을 클릭하면 LangSmith에서 관련 배포의 서버 로그 보기로 이동합니다.

서버 로그 보기는 다음 둘 다의 로그를 표시합니다:

Agent Server 자체 운영 로그: 내부 서버 작업, API 호출, 시스템 이벤트
사용자 애플리케이션 로그: 그래프에서 다음과 같이 기록하는 로그:
- Python: logging 또는 structlog 라이브러리 사용.
- JavaScript: @langchain/langgraph-sdk/logging에서 재내보낸 Winston 로거 사용:
```
import { getLogger } from "@langchain/langgraph-sdk/logging";

const logger = getLogger();
logger.info("Your log message");
```

Details 보기에서 이동하면 Filters 상자가 방금 본 트레이스의 Trace ID로 자동으로 채워져, 특정 트레이스 실행과 관련된 로그만 빠르게 필터링할 수 있습니다.

트레이스 삭제

만료일 전에 LangSmith에서 트레이스를 제거해야 한다면 전체 프로젝트를 삭제하거나 특정 트레이스를 삭제할 수 있습니다.

전체 프로젝트 삭제

LangSmith UI에서 프로젝트의 오버플로우 메뉴에서 Delete 옵션을 선택합니다.
delete_tracer_sessions API 엔드포인트 사용.
LangSmith SDK의 delete_project() (Python) 또는 deleteProject() (JS/TS) 사용.

특정 트레이스 삭제:

delete_runs API 엔드포인트를 사용해 트레이스 ID 또는 메타데이터 키-값 쌍으로 실행을 삭제합니다. 요청 본문은 다음을 수락합니다:

session_id: 삭제를 특정 프로젝트로 범위 지정.
trace_ids: 삭제할 트레이스 ID 목록.
metadata: 주어진 메타데이터 키-값 쌍과 일치하는 모든 실행 삭제.

전체 API 사용법(코드 예제, 요청당 1000 트레이스 한도, 삭제 타임라인, 메타데이터 매칭 동작 포함)은 규정 준수를 위한 데이터 삭제를 참고하세요.

더 알아보기

규정 준수를 위한 데이터 삭제 — 트레이스 삭제 상세.
실행 추적 개념 — 트레이스 구성 요소.