O Trace Explorer oferece três formas de consultar seus dados: a barra de pesquisa, o painel de filtros e o Quick Filter. Como as condições de consulta são interativas, escolha a abordagem que melhor se adapta ao seu fluxo de trabalho.
Barra de pesquisa
Na página Trace Explorer, insira as condições de filtro diretamente na barra de pesquisa.
Abaixo da barra de pesquisa, construa uma consulta estruturada. Para campos como serviceName (nome da aplicação), spanName (nome do span) e IP (endereço do host), selecione um operador e insira um valor para criar o filtro. Utilize também os menus suspensos Quick e Common Queries para preencher a consulta rapidamente.
O Trace Explorer é compatível com a sintaxe de consulta do Simple Log Service (SLS).
Para obter detalhes sobre os campos de consulta, consulte Parâmetros do Trace Explorer.
Para obter detalhes sobre os operadores de consulta do SLS (excluindo instruções de análise), consulte Operadores de consulta.
Para usar caracteres curinga, como
*e?, nas condições de filtro, selecione Allow Fuzzy Search.A unidade da condição
durationé nanossegundos. Por exemplo, para filtrar traces com duração superior a 500 ms, insira a expressãoduration >= 500000000. Para consultar traces dentro de um intervalo de duração, como 0 a 500 ms, insiraduration in (0 500000000). Por padrão, o intervalo é fechado à esquerda e aberto à direita.Para consultar campos em atributos ou recursos, adicione o prefixo
attributes.ouresources..
Exemplos de consulta:
-
Para localizar traces do endpoint /components/api/v1/ads/data com código de status HTTP 500:
spanName : "/components/api/v1/ads/data" and attributes.http.status_code : 500 -
Para localizar traces da aplicação opentelemetry-demo-adservice que apresentam exceções:
serviceName : "opentelemetry-demo-adservice" and attributes.excep.ids : *
Painel de filtros
Na página Trace Explorer, clique em na barra de pesquisa para abrir o painel suspenso de filtros. Nesse painel, defina valores de filtro e adicione filtros para atributos personalizados e recursos.
Os campos de consulta comuns no painel de filtros incluem serviceName (nome da aplicação), spanName (nome do span), IP (endereço do host), traceId e duration. Cada campo aceita diversos operadores, como :, = e !=. O painel também fornece as seguintes caixas de seleção de filtro: Traces with code hotspots only, Show root spans only, Show slow spans only e Show error spans only. A seção de consulta avançada inclui os campos kind e statusCode.
Para selecionar vários valores, altere o operador para oneOf. Para excluir valores específicos, altere o operador para not oneOf.
A unidade da condição
durationé nanossegundos. Por exemplo, para filtrar traces com duração superior a 500 ms, insira a expressãoduration >= 500000000. Para consultar traces dentro de um intervalo de duração, como 0 a 500 ms, insiraduration in (0 500000000). Por padrão, o intervalo é fechado à esquerda e aberto à direita.Para consultar atributos e recursos, clique em + Add Query Condition.
Quick Filter
Na área Quick Filter, no lado esquerdo da página Trace Explorer, filtre traces por status, duração, nome da aplicação, nome do span e endereço do host.
Por exemplo, ao selecionar Error em Status, você filtra traces com
statusCode=2, o que indica um erro.Ao selecionar uma aplicação ou span específico, todos os traces relacionados a esse item são filtrados.
O Quick Filter é fácil de usar e oferece suporte a filtragem em vários níveis. Ele fornece uma visualização em tempo real da distribuição de dados para os filtros atuais, ajudando você a identificar possíveis anomalias.