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

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](https://console.aws.amazon.com/cloudwatch/home#gen-ai-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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AgentCore-Agents.html) 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 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 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
<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 do Span para agentes hospedados no tempo de AgentCore execução do Amazon Bedrock](observability-configure.md#observability-configure-unified-traces).
+ 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
<a name="observability-view-cw-metrics"></a>

Se você habilitou a observabilidade instrumentando seu código de 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 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](observability-runtime-metrics.md) para obter uma lista dessas métricas.