Todos os produtos
Search
Central de documentação

Application Real-Time Monitoring Service:Sintaxe de consulta no Trace Explorer

Última atualização: Jul 05, 2026

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).

Nota
  • 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ão duration >= 500000000. Para consultar traces dentro de um intervalo de duração, como 0 a 500 ms, insira duration in (0 500000000). Por padrão, o intervalo é fechado à esquerda e aberto à direita.

  • Para consultar campos em atributos ou recursos, adicione o prefixo attributes. ou resources..

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.

Nota
  • 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ão duration >= 500000000. Para consultar traces dentro de um intervalo de duração, como 0 a 500 ms, insira duration 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.