사전 요구 사항
Weave에서 OTEL 트레이싱 구성하기
TracerProvider와 OTLPSpanExporter를 사용해 OTEL을 설정하세요. 익스포터는 인증 및 프로젝트 식별에 필요한 올바른 엔드포인트와 HTTP 헤더로 설정하세요.
API 키와 프로젝트 정보 같은 민감한 환경 변수는 환경 파일(예: .env)에 저장하고 os.environ을 사용해 불러오세요. 이렇게 하면 자격 증명을 안전하게 보호하고 코드베이스에 포함되지 않도록 할 수 있습니다.
필수 설정
- 엔드포인트:
https://trace.wandb.ai/otel/v1/traces - 헤더:
Authorization: W&B API 키를 사용하는 Basic 인증.project_id: W&B entity 및 프로젝트 이름(예:myteam/myproject).
설정 예시
tracer_provider가 있습니다.
OTEL로 PydanticAI 에이전트 트레이스하기
InstrumentationSettings 객체를 Agent 생성자에 전달하세요. 이렇게 하면 모든 에이전트와 도구 call이 OTEL 설정에 따라 트레이스됩니다.
다음 예제는 트레이싱을 활성화한 기본 에이전트를 만드는 방법을 보여줍니다. 핵심 step은 에이전트를 초기화할 때 instrument 인자를 설정하는 것입니다:

OTEL로 PydanticAI 도구 트레이스하기
@agent.tool_plain으로 데코레이팅된 함수)를 호출하면 도구 입력, 출력, 그리고 모델의 추론을 포함한 전체 상호작용이 Weave에서 캡처되어 시각화됩니다.
다음 예제는 system prompt와 도구를 포함하는 에이전트를 만드는 방법을 보여줍니다. 트레이싱은 에이전트와 도구 모두에 대해 자동으로 활성화됩니다:

기본적으로 모든 에이전트 계측
Agent.instrument_all()을 사용하세요. 이렇게 하면 instrument 매개변수를 명시적으로 지정하지 않은 모든 에이전트에 기본 InstrumentationSettings 인스턴스가 설정됩니다.