Sintaxe de consulta de logs

Esta página descreve nossa sintaxe de consulta mais recente. Para a sintaxe usando attributes, veja nossa sintaxe legada de consulta

O sistema de filtragem de logs do AppSignal permite pesquisar e filtrar os logs da sua aplicação usando uma sintaxe de consulta intuitiva. Seja para encontrar mensagens de erro específicas, filtrar por níveis de severidade ou pesquisar atributos personalizados, nossa linguagem de consulta torna fácil identificar exatamente o que você está procurando.

Não é necessário digitar essa sintaxe manualmente. Selecione a barra de pesquisa dos logs e o autocomplete sugere campos, operadores e níveis de severidade a partir dos seus logs. As sugestões inserem texto na consulta, e você pressiona Enter para executá-la. Para o fluxo completo, veja Autocomplete de consultas de logs.

Início rápido

Comece com estas consultas simples:

timeout

Encontra logs cuja mensagem contém “timeout”.

severity=error

Encontra todos os logs de nível error.

severity=error hostname=production-web-1

Encontra erros de um servidor específico.

Campos disponíveis

Você pode consultar os seguintes campos em seus logs:

Campo	Descrição	Exemplo
`severity`	Nível do log (error, warning, info, debug, trace)	`severity=error`
`hostname`	Host da aplicação	`hostname=production-1`
`group`	Namespace definido para sua aplicação	`group="background jobs"`
`message`	Conteúdo da mensagem de log	`message:timeout`
Atributos personalizados	Qualquer atributo personalizado definido em seus logs	`duration>10.1`

Se nenhum campo for fornecido, a consulta pesquisará no campo message.

Operadores de consulta

Operadores de pesquisa

Operador	Sintaxe	Descrição	Exemplo
`:`	`field:value`	Contém valor	`message:error`
`!:`	`field!:value`	Não contém valor	`hostname!:test`
`=`	`field=value`	Correspondência exata	`severity=error`
`!=`	`field!=value`	Diferente de	`severity!=info`

Use aspas para valores com espaços: group:"background jobs" Compare um campo com uma string vazia para filtrar valores vazios e não vazios:

code="" corresponde a linhas de log em que code está vazio.
code!="" corresponde a linhas de log em que code tem um valor não vazio.

Correspondências parciais e wildcards

O operador : corresponde quando o valor aparece em qualquer lugar do campo. message:timeout encontra “Request timeout” e “timeout after 30s”. A correspondência diferencia maiúsculas de minúsculas, portanto não encontra “Timeout”. Não existe um caractere wildcard. Um asterisco é pesquisado literalmente, portanto message:error* corresponde apenas a mensagens que contêm o texto error*. Para encontrar mensagens que contenham “error”, use message:error. Os caracteres % e _ também são correspondidos literalmente. Use = quando todo o campo precisar corresponder. Correspondências exatas também diferenciam maiúsculas de minúsculas.

Operadores de comparação

Para valores numéricos:

Operador	Sintaxe	Descrição	Exemplo
`>`	`attribute>value`	Maior que	`duration>100`
`<`	`attribute<value`	Menor que	`user_id<1000`
`>=`	`attribute>=value`	Maior ou igual a	`duration>=100`
`<=`	`attribute<=value`	Menor ou igual a	`user_id<=1000`

Atributos aninhados

Usaremos a seguinte estrutura JSON de exemplo:

{
  "message": "User logged in",
  "group": "admin",
  "hostname": "production-1",
  "user": {
    "id": 123,
    "name": "John Doe",
    "emails": ["john@example.com", "john@work.com"],
    "location.country": "US"
  }
}

Consulte atributos JSON aninhados usando notação de ponto:

user.id=123

Acesse propriedades de objetos aninhados.

user.emails.0=john@example.com

Consulte elementos de array por índice (base zero).

user.location\.country=US

Faça escape dos pontos que fazem parte do próprio nome do campo usando uma barra invertida.

Combinando consultas

Lógica AND (padrão)

Consultas separadas por espaço são combinadas com AND:

severity=error hostname=production-1

Encontra erros do production-1.

Lógica OR

Use OR para corresponder a qualquer condição:

severity=error OR severity=warning

Encontra erros ou avisos.

Agrupamento com parênteses

Use parênteses para consultas complexas:

severity=error AND (hostname=web-1 OR hostname=web-2)

Encontra erros tanto do web-1 quanto do web-2.

Recursos

Integridade do aplicativo

Logs e métricas

Infraestrutura

Otimizar seus aplicativos

Início rápido

Campos disponíveis

Operadores de consulta

Operadores de pesquisa

Correspondências parciais e wildcards

Operadores de comparação

Atributos aninhados

Combinando consultas

Lógica AND (padrão)

Lógica OR

Agrupamento com parênteses

​Início rápido

​Campos disponíveis

​Operadores de consulta

​Operadores de pesquisa

​Correspondências parciais e wildcards

​Operadores de comparação

​Atributos aninhados

​Combinando consultas

​Lógica AND (padrão)

​Lógica OR

​Agrupamento com parênteses

Início rápido

Campos disponíveis

Operadores de consulta

Operadores de pesquisa

Correspondências parciais e wildcards

Operadores de comparação

Atributos aninhados

Combinando consultas

Lógica AND (padrão)

Lógica OR

Agrupamento com parênteses