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
<a name="observability-view"></a>

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 name="observability-view-console"></a>

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](https://console.aws.amazon.com/cloudwatch/home#gen-ai-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 ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AgentCore-Agents.html) no guia do usuário da * Amazon. CloudWatch *

## Exibir outros dados em CloudWatch
<a name="observability-view-cw"></a>

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
<a name="observability-view-cw-logs"></a>

1. Abra o console do [CloudWatch](https://console.aws.amazon.com/cloudwatch/home).

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

1. 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
<a name="observability-view-cw-spans"></a>

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 ](observability-configure.md#observability-configure-unified-traces) 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
<a name="observability-view-cw-metrics"></a>

Se você habilitou a observabilidade instrumentando o código do seu agente conforme descrito em [ Habilitando a AgentCore observabilidade](observability-configure.md#observability-configure-builtin), 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 ](observability-runtime-metrics.md) para obter uma lista dessas métricas.