Pular para o conteúdo principal
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. Captura de tela de log expandido

​
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:
CampoDescriçãoExemplo
severityNível do log (error, warning, info, debug, trace)severity=error
hostnameHost da aplicaçãohostname=production-1
groupNamespace definido para sua aplicaçãogroup="background jobs"
messageConteúdo da mensagem de logmessage:timeout
Atributos personalizadosQualquer atributo personalizado definido em seus logsduration>10.1
Se nenhum campo for fornecido, a consulta pesquisará no campo message.

​
Operadores de consulta

​
Operadores de pesquisa

OperadorSintaxeDescriçãoExemplo
:field:valueContém valormessage:error
!:field!:valueNão contém valorhostname!:test
=field=valueCorrespondência exataseverity=error
!=field!=valueDiferente desource!=mongodb
Use aspas para valores com espaços: group:"background jobs"

​
Operadores de comparação

Para valores numéricos:
OperadorSintaxeDescriçãoExemplo
>attribute>valueMaior queduration>100
<attribute<valueMenor queuser_id<1000
>=attribute>=valueMaior ou igual aduration>=100
<=attribute<=valueMenor ou igual auser_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.