Autocomplete de consultas de logs

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

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.

​

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 autocomplete de consultas de logs está em beta através do AppSignal Labs e fica atrás de uma feature flag. Entre em contato com o suporte para habilitá-lo para sua organização. Compartilhe seu feedback em nosso servidor do Discord. 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.