View a markdown version of this page

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

Visualize dados de observabilidade para seus agentes do Amazon Bedrock AgentCore

Depois de implementar a observabilidade em seu agente, você pode ver as métricas e os rastreamentos coletados na página de observabilidade da 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 pelo tempo de execução do AgentCore agente, bem como dados derivados de amplitude 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 ativada 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 rastrear dados, consulte agentes do Amazon Bedrock AgentCore 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 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 do seu agente, memória ou recurso de gateway.

    AgentCore os grupos de registros de agentes 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 (“Solicitação de processamento...”) # 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 vãos

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 do 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 ver os traços:

  • Navegue até o CloudWatch console

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

  • Filtrar por nome do 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 seu código de agente conforme descrito em Habilitando a AgentCore observabilidade, seu agente gera automaticamente métricas OTEL, que são enviadas CloudWatch usando o Enhanced Metric Format (EMF):

  • Namespace: bedrock-agentcore

  • Acesso via: console de CloudWatch métricas

  • 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 para. CloudWatch Consulte os dados de observabilidade do tempo de execução AgentCore gerados para obter uma lista dessas métricas.