Simple Log Service:Analisar recursos de trajetória

Escopo e pré-requisitos

A página atual fornece quatro tipos de recursos: ferramenta, habilidade, memória e arquivo. Antes de usar este recurso, verifique se as capacidades de processamento e consulta correspondentes estão disponíveis no ambiente atual e se há dados de eventos no recurso.

Consultar eventos

1. Abra o SessionStore de destino e selecione Trajectory Features.

2. Defina o intervalo de tempo e, em seguida, selecione Feature List para visualizar eventos.

3. Defina o tipo, agente, modelo e status conforme necessário, ou insira condições de pesquisa na caixa de pesquisa.

4. Se usar a caixa de pesquisa, clique em Search & Analyze. Alterações nos filtros estruturados acionam uma atualização.

5. Abra um evento nos resultados para visualizar seus detalhes e evidências.

O exemplo a seguir encontra os eventos de uma ferramenta. Os dados atuais devem conter os campos correspondentes.

event_type:"tool" AND agent_tool_name:"search_order"

Para consultar os eventos de uma trajetória, use a seguinte instrução:

trajectory_id:"demo-trajectory-001"

Nota: Os campos de recursos não são exatamente iguais aos campos da lista de trajetórias. Por exemplo, o nome de um evento de ferramenta usa agent_tool_name , enquanto o conjunto de ferramentas em uma trajetória usa tool_names . Visualize o Event JSON ou as propriedades de consulta e análise primeiro para verificar os campos reais. O agente em um recurso indica o nó ao qual o evento pertence, e não é necessariamente o agente representativo da trajetória.

Alternar o modo de organização de resultados

A lista de recursos oferece suporte aos seguintes modos de organização.

Os resultados do resumo podem ser classificados por contagem de eventos, contagem de falhas e outras métricas. Tanto os detalhes quanto os resumos oferecem suporte à paginação. As opções atuais são 20, 50 e 100 entradas por página.

As contagens ao lado das opções de filtro candidatas podem usar um intervalo diferente dos resultados formais e não devem ser usadas como totais exatos. Para determinar o número de eventos correspondentes, consulte os resultados após enviar a consulta.

Visualizar o Log View

Para verificar os campos específicos dos registros de eventos, alterne para o Log View, verifique o intervalo de tempo e as condições de consulta e, em seguida, execute a consulta novamente. O Log View consulta os eventos de recursos processados, e não os logs brutos do aplicativo. Se um evento tiver várias versões, o número de logs poderá ser diferente do número de eventos deduplicados na lista de recursos.

Diferentes modos de exibição podem reter seus próprios estados de consulta. Após alternar, verifique as condições novamente.

Visualizar o relatório agregado

Alterne para o Aggregate Report para visualizar as estatísticas de eventos no intervalo de tempo e nas condições de filtro atuais, como total de eventos, trajetórias associadas, eventos de ferramenta e eventos com falha, além das distribuições por tipo, status, ferramenta, agente, modelo e arquivo.

As estatísticas do relatório não são uma simples soma da página de lista atualmente visível. Os gráficos de classificação podem exibir apenas os principais itens, e os objetos que não aparecem não necessariamente deixaram de ter eventos.

Observe as seguintes diferenças de escopo:

• As tendências são organizadas pelo tempo de registro do evento e não devem ser usadas diretamente como a distribuição do tempo de ocorrência real das ações de negócio.

• Se detalhar os resultados agrupados e, em seguida, alternar para o relatório, verifique novamente as condições de filtro. Não presuma que a restrição do grupo se torna automaticamente uma condição do relatório.

• O relatório atual não oferece suporte para selecionar ou editar modelos de painel. Não o utilize como um painel completo que pode ser organizado livremente.

Visualizar evidências de execução de um evento

1. Abra um evento na lista de eventos.

2. Na guia Details, visualize o tipo, o nome, o status e os identificadores relacionados do evento.

3. Na guia Evidence, visualize o conteúdo disponível e use as entradas fornecidas na página para localizar a etapa de execução ou abrir a trajetória bruta.

4. Para verificar os campos completos, visualize o Event JSON.

A mesma chamada de ferramenta pode estar associada a eventos de arquivo, habilidade ou memória ao mesmo tempo. Use os eventos associados para entender uma operação, mas não some todos eles como se fossem o número de chamadas de ferramenta.

As evidências de eventos exigem os registros de trajetória da versão correspondente. Se a página informar que as evidências estão ausentes, que a versão de destino não existe ou que você não tem permissões de acesso, não use uma versão mais recente para tirar conclusões históricas.

Entender o status e as atualizações de eventos

Uma consulta de recursos primeiro filtra os eventos pelo tempo e pelas condições atuais e, em seguida, seleciona a versão mais recente dos eventos correspondentes. Por exemplo, uma consulta por status de erro pode corresponder a um registro de erro histórico que já foi recuperado. Para verificar se um evento ainda está falhando, verifique os registros de atualização e as evidências correspondentes.

Lista vazia ou falha na solicitação

Se a lista estiver vazia, limpe os filtros, expanda o intervalo de tempo para um intervalo razoável e, em seguida, verifique se o processamento de eventos correspondente está ativado. A ausência de eventos de habilidade ou memória não prova que o aplicativo não possui comportamentos relacionados.

Se a página informar explicitamente que um recurso não existe ou se ocorrer um erro de permissão, resolva primeiro os problemas de recurso e permissão. Não interprete uma falha de solicitação como zero eventos. Da mesma forma, o relatório não deve usar resultados vazios no lugar de estatísticas que não foram concluídas.