Pular para o conteúdo principal
Imagine o seguinte: sua aplicação Rails registra logs em vários grupos, como rails, shop e audit. Você quer ver apenas as linhas de shop, mas não lembra se o campo se chama group ou namespace. A barra de consulta de logs sugere campos, operadores e valores de severidade, hostname e grupo enquanto você digita. Use as sugestões para construir uma consulta sem precisar memorizar a sintaxe. Você também pode digitar uma consulta diretamente e escolher sugestões para as partes de que não se lembra.

Construir uma consulta

Selecione a barra de consulta para abrir sugestões agrupadas em Fields e Attributes:
  • Fields estão disponíveis em toda linha de log: severity, hostname, group e message.
  • Attributes são as chaves que o AppSignal encontra no JSON das linhas de log exibidas, como amount ou cart_id. A lista mostra cinco atributos até você começar a digitar. Digite parte de um nome para filtrar a lista.
Barra de consulta de logs contendo uma consulta digitada que termina em AND, com um menu suspenso listando os campos severity, hostname, group e message, e depois atributos como amount, attempt e cart_id

Sugestões agrupadas em Fields e Attributes, exibidas após AND para o próximo filtro

Digamos que um job em segundo plano falhe e você queira ver toda linha de nível error que mencione Active Job. Construa severity=error AND message:"ActiveJob" a partir das sugestões:
  1. Selecione severity. Severity pula a etapa do operador e oferece os níveis de severidade, como error, warn e info. Essas sugestões inserem texto na consulta, mas você ainda pode digitar ou editá-lo diretamente.
  2. Selecione error. A barra agora mostra severity=error.
  3. Digite um espaço e selecione AND nas sugestões de junção, ou digite você mesmo.
  4. Selecione message e escolha um operador: contains, is, is not ou does not contain. Selecione contains e a barra mostra severity=error AND message:.
  5. Digite "ActiveJob" e pressione Enter para executar a consulta. As aspas são opcionais para uma única palavra e obrigatórias quando o valor contém um espaço, como em message:"Error performing".
A página agora mostra apenas as linhas de nível error cuja mensagem contém ActiveJob. Adicione AND group=shop para restringir a um grupo. Para corresponder a mais de uma severidade, combine filtros com OR, por exemplo (severity=error OR severity=warn). Use as teclas de seta para destacar uma sugestão e Enter para inseri-la. Sem nenhuma sugestão destacada, Enter executa a consulta. Pressione Esc para fechar as sugestões. Selecione o botão de limpar à direita da barra para remover a consulta e mostrar todos os logs. Enquanto a barra de consulta estiver em foco, a exibição ao vivo é pausada para que as linhas atuais permaneçam no lugar. Ela é retomada quando você sai da barra.

Escolher um hostname ou grupo

Na página Logs, digite hostname= ou group= na barra de consulta. O autocomplete sugere os valores dos seus logs, em Hostnames ou Groups. Digite parte de um nome para restringir a lista e selecione um valor para inseri-lo. Os outros operadores também funcionam, como hostname!= ou group:.
A página Logs do AppSignal com hostname= digitado na barra de consulta. O autocomplete lista três hosts em Hostnames.

Digite hostname= para escolher um host dos seus logs.

  • As sugestões vêm das fontes de log e do intervalo de tempo que você está visualizando. Quando nada corresponde, a lista mostra “No matching values in this time range. You can still type your own.”
  • A lista mostra até 100 valores. Continue digitando para restringi-la.
  • Apenas a barra de consulta da página Logs sugere hostnames e grupos. Os formulários de triggers de log e de métricas de log não sugerem.

Digitar uma consulta diretamente

A barra de consulta é um campo de texto, então você também pode digitar ou colar uma consulta. A sintaxe de consulta completa continua funcionando na barra, caso você precise de mais do que as sugestões de autocomplete de logs oferecem. O mesmo autocomplete está disponível nos campos de consulta de triggers de log e métricas de log. No formulário de métricas, as sugestões também incluem campos disponíveis para extração e agrupamento de métricas.
Barra de consulta de logs contendo sugestões de campos de autocomplete e valores de fonte de log pré-selecionados no formulário de métricas de log

Sugestões de autocomplete para uma consulta digitada diretamente na barra de consulta e valores de fonte de log pré-selecionados no formulário de métricas de log

Assim que uma consulta retornar as linhas de que você precisa, você pode transformá-las em uma métrica baseada em logs sem sair da página. Em seguida, você também pode criar um trigger de log para ser notificado quando a consulta corresponder a novas linhas. O autocomplete de consultas de logs agora está disponível de forma geral para todos os clientes. Compartilhe seu feedback em nosso servidor do Discord.