OpenTelemetry 수집 참조

이 페이지는 Amplitude의 OTLP 엔드포인트가 OpenTelemetry GenAI 스팬을 에이전트 분석 [Agent] 이벤트로 변환하는 방법에 대한 참조입니다. 설정 단계는 에이전트 분석으로 OpenTelemetry 추적 보내기를 참조하십시오.

엔드포인트 및 프로토콜

  • 프로토콜: HTTP 전용 OTLP(http/protobuf 또는 http/json), 선택적 gzip 포함. Amplitude는 OTLP/gRPC를 지원하지 않습니다.
  • 인증: Bearer토큰 또는 api_key쿼리 매개변수로 사용되는 프로젝트 API 키. Amplitude는 프로젝트별 활성화 요청을 필요로 하지 않습니다.
  • 지원되는 계측: OpenTelemetry GenAI 시맨틱 컨벤션, OpenInference(llm.*), OpenLLMetry 및 Traceloop(traceloop.*), OpenLIT 및 LiteLLM. Amplitude는 GenAI 스팬이 아닌 스팬을 무시합니다.

속성 확인 순서

Amplitude는 존재하는 첫 번째 속성을 다음 순서로 읽습니다.

무엇이 무엇에 매핑되는지

Amplitude는 gen_ai.usage.cost가 없을 때 비용을 계산하지 않습니다. 비용 계산 방법을 참조하십시오.

채팅 호출은 전체 프롬프트 기록을 다시 전송하므로 마지막 비서 메시지 뒤에 있는 사용자 메시지만 새 [Agent] User Message로 변경됩니다. Amplitude는 재생 기록을 다시 표시하지 않으며, 새 입력이 도구 결과인 도구 루프 연속(tool-loop continuation)은 사용자 턴을 생성하지 않습니다.

AI SDK의 프로세스 내 OpenTelemetry 내보내기는 자체 매핑을 사용합니다. SDK 참조에서 OpenTelemetry 속성 매핑을 참조하십시오.

기능 플래그 속성

Amplitude는 GenAI 스팬에서 OpenTelemetry 기능 플래그 평가를 읽고 각 평가를 실험으로 기록합니다. 모든 feature_flag.evaluation 스팬 이벤트를 먼저 읽은 다음 스팬의 자체 feature_flag.* 속성을 읽습니다. 리소스 속성은 카운트되지 않습니다.

스팬이 생성하는 모든 이벤트는 [Agent] Experiments를 포함하고, 정확히 하나의 평가가 남았을 때 [Agent] Experiment Key, Variant, Unit, Provider가 추가됩니다. 오류를 반환한 것처럼 변형이 없는 평가는 아무것도 추가되지 않습니다. 두 평가가 키를 공유하는 경우 나중에 수행된 평가가 우선하므로 span 속성이 동일한 키를 사용하는 span 이벤트를 재정의합니다. 유효성 검사 규칙과 10회 실험 제한이 AI SDK와 일치합니다. 에이전트 분석에서 실험 변형 기록을 참조하십시오.

Claude Platform이 걸쳐 있는 범위

Amplitude는 스팬 이름이 anthropic.로 시작하고 스팬에 gen_ai.provider.name=anthropic, com.anthropic.claude-platform 또는 com.anthropic.sdk 계측 범위, 또는 리소스 service.name=claude-platform이(가) 포함된 경우에만 이러한 규칙을 적용합니다. 일반 invoke_agent 스팬과 다른 이름의 Anthropic 채팅 스팬은 위의 매핑에 머무릅니다.

anthropic.message.stop_reason 후 anthropic.session.turn.stop_reason이(가) 수행되면, gen_ai.response.finish_reasons이(가) 없을 때 AI 응답에서 [Agent] Finish Reason이(가) 됩니다. Amplitude는 enduser.id 또는 gen_ai.usage.cost을(를) 발명하지 않습니다. 상위 스팬 ID는 계층 구조로 유지됩니다. 그들은 [Agent] Parent Agent ID이(가) 아닙니다.

목적지를 추가하려면 Claude 플랫폼 추적 보내기를 참조하십시오.

전송, 제한 및 응답

전송은 최소 한 번 발생합니다. 영속적 전송 큐로 Collector를 실행하고 재시도를 활성화한 상태로 유지하십시오. 인메모리 큐는 재시작 시 버퍼링된 스팬을 손실합니다.

OTLP 리시버는 403를 반환하지 않습니다. CDN 또는 WAF 등의 다른 홉에서 발생한 403를 누락된 Amplitude 활성화가 아닌 구성 오류로 취급하십시오.

이 내용이 도움이 되었나요?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

이 페이지에서