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á.
AgentCore gerar dados de observabilidade de memória
Para o tipo AgentCore de recurso de memória, AgentCore envia métricas para a Amazon CloudWatch por padrão. AgentCore também gera um conjunto padrão de extensões e registros, se você habilitá-los. Consulte Habilitando a observabilidade para AgentCore tempo de execução, memória, gateway, ferramentas integradas e recursos de identidade para saber mais sobre como ativar extensões e registros.
Consulte as seções a seguir para saber mais sobre os dados de observabilidade fornecidos para os armazenamentos de memória do seu agente.
Métricas de memória fornecidas
O tipo de recurso de AgentCore memória fornece as seguintes métricas por padrão.
- Latência
-
O tempo total decorrido entre o recebimento da solicitação e o envio do token de resposta final. Representa o processamento completo da solicitação de ponta a ponta.
- Invocations
-
O número total de solicitações de API feitas no plano de dados e no plano de controle. Essa métrica também rastreia o número de eventos de ingestão de memória.
- Erros do sistema
-
Número de invocações que resultam em erros do lado do AWS servidor.
- Erros do usuário
-
Número de invocações que resultam em erros do lado do cliente.
- Erros
-
Número total de erros que ocorrem ao processar solicitações de API no plano de dados e no plano de controle. Essa métrica também rastreia o total de erros que ocorrem durante a ingestão de memória.
- Controles de utilização
-
Número de invocações que o sistema limitou. As solicitações limitadas contam como invocações, erros e erros do usuário.
- Contagem de criações
-
Conta o número de eventos de memória e registros de memória criados.
Dados de abrangência fornecidos
Para melhorar a observabilidade, AgentCore fornece extensões estruturadas que traçam a relação entre os eventos e as memórias que eles geram ou acessam. Para habilitar esses dados de abrangência, você precisa instrumentar seu código de agente. Consulte Adicionar observabilidade aos seus AgentCore recursos do Amazon Bedrock para saber mais.
Esses dados de abrangência estão disponíveis na íntegra em CloudWatch Logs and CloudWatch Application Signals. Para saber mais sobre a visualização de dados de observabilidade, consulte Visualizar dados de observabilidade para seus agentes do Amazon Bedrock AgentCore .
A tabela a seguir define as operações para as quais os períodos são criados e os atributos de cada período capturado.
| Nome da operação | Atributos de extensão | Description |
|---|---|---|
|
|
|
Cria um novo evento em uma sessão de memória |
|
|
|
Recupera um evento de memória existente |
|
|
|
Lista eventos em uma sessão |
|
DeleteEvent |
|
Exclui um evento da memória |
|
RetrieveMemoryRecords |
|
Recupera registros de memória para um determinado namespace |
|
ListMemoryRecords |
|
Lista os registros de memória disponíveis |
Dados de registro fornecidos
AgentCore fornece registros estruturados que ajudam você a monitorar e solucionar problemas dos principais processos de recursos de AgentCore memória. Para habilitar esses dados de registro, você precisa instrumentar seu código de agente. Consulte Adicionar observabilidade aos seus AgentCore recursos do Amazon Bedrock para saber mais.
AgentCore pode enviar registros para CloudWatch Logs, Amazon S3 ou Firehose stream. Se você usar um destino de CloudWatch registros, esses registros serão armazenados no grupo de registros padrão /aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id} ou em um grupo de registros personalizado começando com/aws/vendedlogs/. Consulte Habilitando a observabilidade para AgentCore tempo de execução, memória, gateway, ferramentas integradas e recursos de identidade para saber mais.
Quando a DeleteMemory operação é chamada, os registros são gerados para o início e a conclusão do processo de exclusão. Todos os registros de erros de exclusão correspondentes serão fornecidos com informações sobre o motivo pelo qual a chamada falhou.
Também fornecemos registros para vários estágios do processo de criação de memória de longo prazo, ou seja, extração e consolidação. Quando novos eventos de memória de curto prazo são fornecidos, AgentCore extrai os principais conceitos das respostas para iniciar a formação de novos registros de memória de longo prazo. Depois de criados, eles são integrados aos registros de memória existentes para criar um armazenamento unificado de memórias distintas.
Veja o detalhamento a seguir para saber como cada fluxo de trabalho ajuda você a monitorar a formação de novas memórias:
Registros de extração
-
Início e conclusão do processamento de extração
-
Número de memórias extraídas com sucesso
-
Qualquer erro na desserialização ou processamento de eventos de entrada
Registros de consolidação:
-
Início e conclusão do processamento de consolidação
-
Número de memórias que precisam de consolidação
-
Success/failure de adições e atualizações de memória
-
Status de recuperação de memória relacionado
A tabela a seguir fornece uma análise mais detalhada de como diferentes fluxos de trabalho de recursos de memória usam campos de registro junto com o próprio corpo do registro para fornecer informações específicas da solicitação.
| Nome do fluxo de trabalho | Campos de log | Description |
|---|---|---|
|
Extração |
resource_arn, event_timestamp, memory_strategy_id, namespace, actor_id, session_id, event_id, requestID, isError |
Analisa as conversas recebidas para gerar novas memórias |
|
Consolidação |
resource_arn, event_timestamp, memory_strategy_id, namespace, session_id, RequestID, isError |
Combina memórias extraídas com memórias existentes |
