O Trace Explorer oferece três métodos interconectados para consultar seus dados: a barra de pesquisa, o painel de filtros e o painel Quick Filter. Use o método mais adequado ao seu fluxo de trabalho.
Usar a barra de pesquisa
Insira as condições de filtro diretamente na barra de pesquisa do Trace Explorer.
O Trace Explorer é compatível com a sintaxe de consulta do Simple Log Service (SLS).
Para obter uma descrição detalhada dos campos de consulta, consulte Trace Explorer parameters.
Para obter uma descrição detalhada dos operadores de consulta do SLS, consulte Query operators. Não há suporte para instruções de análise.
Para usar os caracteres curinga
*e?nas condições de filtro, marque a caixa de seleção Allow Fuzzy Search.O campo duration é medido em nanossegundos. Por exemplo, para filtrar traces com duração superior a 500 ms, insira a expressão
duration >= 500000000. Para consultar traces dentro de um intervalo específico, como 0 ms a 500 ms, insiraduration in (0 500000000). O intervalo inclui o valor inicial, mas exclui o valor final.Para consultar campos em Attributes ou Resources, adicione o prefixo
attributes.ouresources.ao nome do campo.
Exemplos de consulta:
-
Localizar traces do span
/components/api/v1/ads/datacom código de status HTTP 500:spanName : "/components/api/v1/ads/data" and attributes.http.status_code : 500 -
Localizar traces com erros da aplicação
opentelemetry-demo-adservice:serviceName : "opentelemetry-demo-adservice" and attributes.excep.ids : *
Usar o painel de filtros
Na página Trace Explorer, clique em na barra de pesquisa para abrir o painel de filtros. Nesse painel, defina valores para as condições de filtro e adicione critérios para Attributes e Resources.
As condições de consulta comuns incluem serviceName (nome da aplicação), spanName (nome do span), ip (endereço do host), traceId (ID do trace) e duration. Cada condição aceita diversos operadores, como :, = e !=. Refine ainda mais os resultados marcando caixas de seleção como Only show traces with code hotspots, Only show root span traces, Only show slow spans e Only show error spans. A área de consulta avançada contém os campos kind (tipo de span) e statusCode (status).
Para selecionar vários valores para uma condição, use o operador oneOf. Para excluir um conjunto de valores, use o operador not oneOf.
O campo duration é medido em nanossegundos. Por exemplo, para filtrar traces com duração superior a 500 ms, insira a expressão
duration >= 500000000. Para consultar traces dentro de um intervalo específico, como 0 ms a 500 ms, insiraduration in (0 500000000). O intervalo inclui o valor inicial, mas exclui o valor final.Para consultar por Attributes e Resources, clique em + Add Query Condition.
Usar o painel Quick Filter
No painel Quick Filter, no lado esquerdo da página Trace Explorer, filtre rapidamente os traces por status, duração, nome da aplicação, nome do span e endereço do host.
Por exemplo, ao selecionar Error no filtro Status, você localiza rapidamente traces com erros, correspondentes a
statusCode=2.Selecione uma aplicação ou nome de span específico para exibir apenas os traces associados.
O painel Quick Filter permite filtragem em vários níveis. Ele exibe uma distribuição em tempo real dos dados de trace para os critérios selecionados, facilitando a identificação de possíveis anomalias.