Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Monitorar seus agentes na IU do Atlas Agent mecanismo

A página Monitoring na IU do Atlas agente mecanismo mostra métricas de uso e integridade do seu projeto e de seus espaços de trabalho. Use a página para acompanhar invocações de agentes, taxas de erro, uso de tokens, atividade de memória e consumo de recursos ao longo do tempo. A página mostra dados apenas para o projeto atual.

Cada seção da página mostra métricas como blocos e cartões de tendência. Um bloco mostra um único valor para o período de tempo selecionado. Um cartão de tendência mostra como uma métrica muda ao longo do período de tempo selecionado. Os cartões de tendência agrupam os dados em buckets de 5minutos para o período 1h, buckets de hora em hora para o período 24h e buckets diários para os períodos 7d e 30d.

Para aprender como visualizar logs, eventos de implantação e a integridade do workspace em tempo real, consulte o guia Monitorar o Agente. Para aprender como depurar uma execução específica do agente, consulte o guia Inspecionar Rastros de Execução do Agente.

Para visualizar as métricas do seu projeto, siga estas etapas:

1

Na barra de navegação esquerda na IU do Atlas agente mecanismo, em Monitor, clique em Monitoring.

2

Selecione 1h, 24h, 7d ou 30d para selecionar um período de tempo para monitorar. A página mostra as últimas 24 horas por padrão.

3

Para visualizar métricas de um único workspace, selecione o workspace no filtro de workspace ou clique em uma linha na tabela By workspace ou Compute by workspace. Para retornar às métricas de todo o projeto, selecione All workspaces.

A página atualiza seus dados automaticamente a cada 60 segundos.

Ao visualizar um único workspace, a página mostra as mesmas seções que a visualização de todo o projeto, com escopo para esse workspace, com as seguintes exceções:

  • A seção Networking não está disponível.

  • As tabelas By workspace e Compute by workspace não estão disponíveis.

Você pode escolher quais cartões de tendência aparecem em cada seção e pode exibir as seções Compute e Networking, que estão ocultas por padrão. Você pode personalizar a página na visualização de todo o projeto ou na visualização de um único workspace.

Para personalizar a página, execute as seguintes etapas:

1

O seletor de período e o filtro do workspace ficam ocultos enquanto você personaliza a página.

2
  • Para mostrar ou ocultar um cartão de tendência, alterne o cartão em sua seção.

  • Para exibir a seção Compute, selecione Show Compute.

  • Para exibir a seção Networking, selecione Show networking.

3

Para descartar suas alterações, clique em Cancel.

Por padrão, as seções Usage, Memory e Policy mostram cartões de tendência para as quatro métricas com o maior volume. Você não pode personalizar o cartão de tendência Health.

Seu navegador armazena suas seleções, para que persistam entre as sessões no mesmo navegador. Suas seleções não se aplicam em outros navegadores ou em outros dispositivos.

Esta seção descreve as métricas em cada seção da página Monitoring. Cada métrica mostra o total para o período de tempo selecionado.

A seção Health mostra o resultado e a duração de executar do agente. A seção também contém cartões de tendência Invocations e Errors. O cartão de tendência Errors aparece apenas quando ocorreram erros no período selecionado.

A tabela a seguir descreve as métricas na seção:

Métrica
Descrição
unidade
Invocations

Número de executar de agente que foram concluídas ou falharam. Executar que estão aguardando aprovação não são contadas.

Contar

Error rate

Número de falhas dividido por invocações. Este valor é zero quando não houve invocações.

Porcentagem

Failures

Número de executar que terminaram em erro. Executar que estão aguardando aprovação não são contadas.

Contar

Latency p50

A mediana de tempo desde o início de uma executar até a conclusão ou erro, incluindo o tempo gasto aguardando aprovação.

ms ou s

Latency p95

Tempo dentro do qual 95 por cento dos executar foram concluídos, desde o início de um executar até a conclusão ou erro, incluindo o tempo gasto aguardando aprovação.

ms ou s

As métricas de latência aparecem apenas quando os dados de latência estão disponíveis para o período selecionado. Para aprender mais sobre aprovações, consulte Execução de agente com intervenção humana.

A seção Usage mostra o consumo de modelo, ferramenta e tempo de execução. A tabela a seguir descreve as métricas na seção:

Métrica
Descrição
unidade
LLM calls

Número de chamar para modelos de linguagem.

Contar

Input tokens

Número de tokens enviados para modelos de linguagem.

Contar

Output tokens

Número de tokens retornados por modelos de linguagem.

Contar

Tool sandbox calls

Número de chamar para sandboxes de ferramentas.

Contar

Tool sandboxes

Número de sandboxes de ferramentas usados.

Contar

Workload runtime

Tempo total em que os sandboxes de agente e ferramenta foram executados durante o período selecionado.

duração

Platform uptime

Tempo total em que os serviços de plataforma sempre ativos, incluindo o mecanismo de orquestração e o servidor de memória, foram executados durante o período selecionado. Este valor inclui o tempo de inatividade.

duração

Um cartão de tendência Pod runtime, que combina o tempo de execução da carga de trabalho e o tempo de atividade da plataforma, está disponível por meio de Customize.

A seção Memory mostra a atividade de memória do agente. A tabela a seguir descreve as métricas na seção:

Métrica
Descrição
unidade
Docs written

Número de documento gravados na memória no período selecionado. Este valor não é o tamanho atual da memória.

Contar

Docs retrieved

Número de documentos recuperados da memória.

Contar

Embedding tokens

Número de tokens usados para gerar embeddings.

Contar

Searches

Número de chamadas de pesquisa de memória.

Contar

Context tokens

Número de tokens de memória adicionados ao contexto do agente.

Contar

Memories consolidated

Número de memórias adicionadas por meio de consolidação.

Contar

Para aprender mais sobre a memória do agente, consulte Memória do Agente.

A seção Policy mostra a métrica Policy denials, que conta as chamar que o Policy mecanismo negou.

A métricas conta as recusas do tipo de política AUTHORIZED_TOOLS e das políticas de orçamento de execução e sessão. A métricas não conta as recusas do tipo de política AUTHORIZED_MODELS. Para aprender mais, consulte Tipos de política.

A seção Memory latency mostra o desempenho das operações de memória. Cada métrica aparece apenas quando seus agentes realizaram a operação de memória relacionada durante o período selecionado.

A tabela a seguir descreve as métricas na seção:

Métrica
Descrição
unidade
Context latency p50

Mediana de tempo para recuperar o contexto da memória.

ms ou s

Context latency p95

Tempo dentro do qual 95 por cento das recuperações de contexto de memória foram concluídas.

ms ou s

Write latency p95

Tempo dentro do qual 95 por cento das gravar de memória foram concluídas.

ms ou s

Retrieval success

Porcentagem de recuperações de memória que foram bem-sucedidas.

Porcentagem

A seção Compute mostra o uso de recurso. A seção está oculta por padrão. Para exibir a seção, selecione Show Compute após selecionar Customize. A seção inclui cartões de tendência CPU e Memory.

A tabela a seguir descreve as métricas na seção:

Métrica
Descrição
unidade
CPU

Uso média da CPU durante o período selecionado.

Cores

CPU user

Uso médio da CPU no modo de usuário.

Cores

CPU system

Uso médio da CPU no modo de sistema.

Cores

Memory

Uso atual de memória.

bytes

Disk

Uso atual do disco.

bytes

Processes

Número atual de processos.

Contar

A seção Networking mostra o tráfego de saída de todo o projeto. A seção está oculta por padrão e está disponível apenas na visualização de todo o projeto. Para mostrar a seção, selecione Show networking após selecionar Customize.

Métrica
Descrição
unidade
Egress throughput

Taxa média de tráfego de saída.

Bytes por segundo

Egress packets

Taxa média de pacotes de saída.

Pacotes por segundo

Active peers

Número atual de emparelhamento ativos.

Contar

Peer registrations

Número de emparelhamento registrados.

Contar

Peer removals

Número de emparelhamento removidos.

Contar

Stale peers reaped

Número de emparelhamento inativos removidos automaticamente.

Contar

Quando o tráfego usa mais de uma família de IP, a seção também mostra uma tabela By IP family com a taxa de transferência e a parcela de tráfego de cada família. Para aprender mais sobre egress, consulte Gerenciar políticas de egress de rede.

A seção Breakdowns mostra como o uso é distribuído. A seção inclui as seguintes tabelas:

  • By model: Uso e compartilhamento de tokens para cada modelo.

  • By pod type: Tempo de execução total para cada tipo de pod e sua porcentagem do tempo de execução combinado de todos os tipos de pod. O mecanismo de orquestração e o servidor de memória acumulam tempo de execução mesmo quando ociosos.

  • By tool: Número de chamar e taxa de erro para cada ferramenta.

  • Compute by workspace: uso e compartilhamento de CPU para cada workspace. Esta tabela está disponível apenas na visualização de todo o projeto quando você mostra a seção Compute.

  • By workspace: Uso e compartilhamento de tokens para cada workspace. Workspaces implantar sem uso mostram 0. Esta tabela está disponível apenas na visualização de todo o projeto.

A página mostra as seguintes mensagens quando os dados não estão disponíveis, dependendo da causa:

  • No metrics in this time range: Não existem métricas para o período 1h ou 24h. Selecione um período mais longo ou invoque um agente.

  • No metrics yet: Não existem métricas para o período 7d ou 30d. As métricas aparecem depois que os agente são executados no projeto.

  • No data in this time range: Uma seção ou tabela não possui dados para o período selecionado. Selecione um período mais longo ou invoque um agente que use o recurso selecionado.

  • Monitoring data isn't available in this environment yet: O monitoramento não está configurado para o seu ambiente. Para aprender mais, consulte Monitorar o agente.

  • Monitoring data couldn't be loaded: A página ou uma seção não conseguiu carregar os dados. A página tenta novamente automaticamente.