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.

Início rápido

Comece com estas consultas simples:

timeout

Pesquisa por “timeout” no campo message.

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	`source!=mongodb`

Use aspas para valores com espaços: group:"background jobs"

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.

Gerenciamento de logs

Triggers

⌘I

Configuração do aplicativo

Desempenho / rastreamento

Alertas

Detecção de anomalias

Erros

Monitoramento de uptime

Monitoramento de processos

Logs

Métricas & dashboards

Monitoramento de host

Início rápido

Campos disponíveis

Operadores de consulta

Operadores de pesquisa

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

​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

Operadores de comparação

Atributos aninhados

Combinando consultas

Lógica AND (padrão)

Lógica OR

Agrupamento com parênteses