Todos os produtos
Search
Central de documentação

Application Real-Time Monitoring Service:Consultar e filtrar traces

Última atualização: Sep 08, 2026

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.

Nota
  • 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, insira duration 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. ou resources. ao nome do campo.

Exemplos de consulta:

  • Localizar traces do span /components/api/v1/ads/data com 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).

Nota
  • 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, insira duration 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.