Amazon Bedrock AgentCore 추적을 Agent Analytics로 전송

AgentCore는 호스트입니다. 에이전트 프레임워크는 이미 스팬을 내보냅니다. CloudWatch 옆에 OTLP/HTTP 익스포터를 추가하고 에이전트와 일치하는 프레임워크 가이드를 따르십시오. 에이전트 프로세스에서 Amplitude AI SDK는 필요하지 않습니다.

이 페이지에는 별도의 캡처가 없습니다. Strands on AgentCore는 AWS Strands입니다. 다른 에이전트는 Google ADK, Pydantic AI, Microsoft Agent Framework 또는 OpenInference를 따릅니다. Amplitude는 내보낸 스팬을 저장합니다. 개인 데이터가 인프라를 떠나기 전에 데이터를 정리하십시오. 에이전트 분석 개인정보 보호 모드를 참조하십시오.

AI 코딩 에이전트로 설정(권장)

이 프롬프트를 Cursor, Claude Code, Windsurf, GitHub Copilot 또는 Codex와 같은 AI 코딩 에이전트에 붙여넣으십시오.

text
Connect this Amazon Bedrock AgentCore agent to Amplitude Agent Analytics with native OpenTelemetry.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/amazon-bedrock-agentcore.md
and follow "Part 2: Coding agent procedure".
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Also follow https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/privacy.md
and scrub content before export.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md

변경 사항을 검토한 다음 시작하기의 단계에 따라 확인하십시오.

이것이 여러분에게 의미하는 바

  • 실행 내용: 에이전트 AgentCore가 이미 실행 중이며, CloudWatch 외에 두 번째 OTLP/HTTP 익스포터가 있습니다.
  • 필요한 사항은 해당 에이전트에 대한 프레임워크 가이드, Amplitude 프로젝트 API 키, 그리고 매번 안정적인 대화 ID 및 product-analytics 사용자 ID입니다.
  • 프로토콜: HTTP 기반 OTLP. Amplitude는 protobuf 및 JSON을 허용합니다. Amplitude는 gRPC를 허용하지 않습니다.
  • 개인정보 보호: Amplitude는 수신 후 콘텐츠를 스크럽하지 않습니다. 내보내기 전에 콘텐츠 속성을 마스킹하거나 삭제하십시오.

내보내기

CloudWatch 내보내기를 유지합니다. 다음 변수를 추가합니다. 값에 환경 변수가 포함된 경우 헤더 값의 공백을 %20로 인코딩하십시오.Authorization= 그대로 둡니다.

bash
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.amplitude.com/otlp/v1/traces
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer%20<project API key>"
OTEL_SERVICE_NAME=order-support

EU 데이터 상주는 https://api.eu.amplitude.com/otlp/v1/traces을(를) 사용합니다.

AgentCore는 이미 OpenInference, OpenLLMetry, OpenLIT 및 Traceloop 속성을 허용합니다. Amplitude는 이미 해당 항목들을 매핑합니다.

아이덴티티

프레임워크 가이드는 대화, 제품 사용자 및 에이전트를 설정합니다. AgentCore는 해당 항목들을 추가하지 않습니다.

이월되는 항목

이벤트는 런타임에서 프레임워크의 이벤트입니다. 작업 chat이(가) 포함된 모델 스팬은 각 새 사용자 메시지에 대해 [Agent] AI Response 및 [Agent] User Message이(가) 됩니다. execute_tool은(는) [Agent] Tool Call이(가) 됩니다.

세션 닫기

[Agent] Session End은(는) 선택 사항이며 권장됩니다. AgentCore 내보내기는 이를 전송하지 않습니다. Amplitude는 기본적으로 적합한 에이전트 이벤트 없이 30분 후에 세션을 닫으며, 세션별 재정의가 설정되지 않은 경우 세션 시작 후 24시간 내에 세션을 닫습니다. 첫 번째 종료가 카운트됩니다. 세션 레코드와 콘텐츠 기반 신호를 포함한 Enrichment는 해당 종료 이후에 한 번 실행됩니다. OpenTelemetry 변환기는 스팬에서 idle-timeout 속성을 읽지 않습니다. 세션 닫기 방법을 참조하십시오.

시작하기

Amazon Bedrock AgentCore 연동 가이드를 따르고, 에이전트에 대한 프레임워크 가이드를 따르십시오. 동일한 세션 id로 두 턴을 전송한 다음 라이브 이벤트에서 확인하십시오:

  1. 세션 ID는 대화 ID이며 추적 ID가 아닙니다.
  2. 사용자 ID는 product-analytics 사용자가 아니라 unknown입니다.
  3. 에이전트 ID는 gen_ai.agent.id입니다.
  4. 턴에는 사용자 메시지 텍스트, 도구 호출 및 AI 응답 텍스트가 표시되며, 모델 이름과 두 토큰 카운트가 포함됩니다.
  5. 두 번째 턴은 첫 번째 사용자 메시지를 복제하지 않습니다.

가이드는 2026년 10월 27일에 마지막으로 확인되었으며, 별도의 캡처가 없는 호스팅 페이지입니다. Amazon Bedrock 및 AgentCore는 해당 소유자의 상표입니다. 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.

이 페이지에서