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 habilitar 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 de ponta a ponta da solicitação.
- 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 durante o processamento de 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. 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 amplitude 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 extensão, você precisa instrumentar seu código de agente. Consulte Adicionar observabilidade aos seus AgentCore recursos do Amazon Bedrock para saber mais.
Esses dados de amplitude estão disponíveis na íntegra em CloudWatch Logs e 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 as extensões são criadas e os atributos de cada extensão capturada.
| Nome da operação | Atributos de amplitude | 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 os 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 gerar registros para o CloudWatch fluxo Logs, Amazon S3 ou Firehose. Se você usa um destino de CloudWatch registros, esses registros sã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, são gerados registros 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 por que 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 conceitos-chave 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 |
