View a markdown version of this page

Visualize dados de observabilidade para seus agentes do Amazon Bedrock AgentCore - Base da Amazônia AgentCore
Visualize dados usando a observabilidade generativa de IA na Amazon CloudWatchExibir outros dados em CloudWatch

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Visualize dados de observabilidade para seus agentes do Amazon Bedrock AgentCore

Depois de implementar a observabilidade em seu agente, você pode visualizar as métricas e os rastreamentos coletados na página de observabilidade de IA generativa do CloudWatch console e nos registros. CloudWatch Consulte as seções a seguir para saber como visualizar as métricas de seus agentes.

Visualize dados usando a observabilidade generativa de IA na Amazon CloudWatch

A página CloudWatch generativa de observabilidade da IA exibe todas as métricas fornecidas pelo serviço geradas pelo tempo de execução do AgentCore agente, bem como dados derivados de abrangência e rastreamento, caso você tenha habilitado a instrumentação no código do agente. Para visualizar o painel de observabilidade em CloudWatch, abra a página Amazon CloudWatch GenAi Observability.

Com a observabilidade generativa da IA CloudWatch, você pode visualizar painéis personalizados com gráficos e outras visualizações de seus dados, bem como detalhamentos de erros, visualizações de rastreamento e muito mais. Para saber mais sobre como usar a observabilidade generativa da IA em CloudWatch, incluindo como analisar a sessão individual de seus agentes e os dados de rastreamento, consulte os AgentCore agentes do Amazon Bedrock no guia do usuário da Amazon. CloudWatch

Exibir outros dados em CloudWatch

Todas as métricas e extensões fornecidas pelo serviço também podem ser visualizadas em CloudWatch, junto com qualquer métrica gerada pelo código do agente instrumentado.

Para visualizar esses dados, consulte as seções a seguir.

Logs

  1. Abra o console do CloudWatch.

  2. No painel de navegação à esquerda, expanda Registros e selecione Grupos de registros

  3. Use o campo de pesquisa para encontrar o grupo de registros para seu agente, memória ou recurso de gateway.

    AgentCore os grupos de log do agente têm o seguinte formato:

    • Registros padrão - stdout/stderr saída

      • Localização:/aws/bedrock-/<agent_id>- agentcore/runtimes<endpoint_name>/[registros de tempo de execução] <UUID>

      • Contém: erros de tempo de execução, registros de aplicativos, instruções de depuração

      • Exemplo de uso:

        • print (“Processando solicitação...”) # Aparece nos registros padrão

        • logging.info (“Solicitação processada com sucesso”) # Aparece nos registros padrão

    • Registros estruturados do OTEL - Informações detalhadas da operação

      • Localização:/aws/bedrock-agentcore/runtimes/- <agent_id><endpoint_name>/otel-rt-logs

      • Contém: detalhes de execução, rastreamento de erros, dados de desempenho

      • Coleta automática: nenhum código adicional é necessário - gerado pela instrumentação ADOT

      • Benefícios: Pode incluir IDs de correlação vinculando registros a rastreamentos relevantes

Traços e extensões

Os rastreamentos fornecem visibilidade dos caminhos de execução da solicitação por meio de seu agente:

  • Local: o fluxo de spans registros no grupo de registros do agente (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) ou o fluxo de default registros no grupo de aws/spans registros para agentes que usam o destino de intervalo compartilhado. Para obter mais informações, consulte Destino de Span para agentes hospedados no tempo de AgentCore execução do Amazon Bedrock.

  • Acesso via: console CloudWatch de pesquisa de transações

  • Requisitos: A pesquisa de CloudWatch transações deve estar ativada

Os traços capturam automaticamente:

  • Sequências de invocação de agentes

  • Integração com componentes da estrutura (LangChain, etc.)

  • Chamadas e respostas do LLM

  • Invocações e resultados de ferramentas

  • Caminhos de erro e exceções

Para rastreamento distribuído entre serviços, você pode usar cabeçalhos HTTP padrão:

  • AWS X-Ray formato: X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

  • Formato W3C: traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Para visualizar os traços:

  • Navegue até o CloudWatch console

  • Selecione Pesquisa de transações na navegação à esquerda

  • Filtrar por nome de serviço ou outros critérios

  • Selecione um rastreamento para visualizar o gráfico de execução detalhado

Metrics

Se você habilitou a observabilidade instrumentando o código do seu agente conforme descrito em Habilitando a AgentCore observabilidade, seu agente gera automaticamente métricas OTEL, que são enviadas para o CloudWatch uso do Enhanced Metric Format (EMF):

  • Namespace: bedrock-agentcore

  • Acesso via: console do CloudWatch Metrics

  • Conteúdo: Métricas personalizadas geradas pelo código e pelas estruturas do seu agente

  • Coleta automática: nenhum código adicional é necessário - gerado pela instrumentação ADOT

Além das métricas emitidas pelo agente, o AgentCore serviço publica métricas de serviço padrão no. CloudWatch Consulte os dados de observabilidade de tempo de execução AgentCore gerados para obter uma lista dessas métricas.