> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

<h2 id="build-a-query">
  Construir uma consulta
</h2>

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.

<Frame caption="Sugestões agrupadas em Fields e Attributes, exibidas após AND para o próximo filtro">
  <img src="https://mintcdn.com/appsignal-715f5a51/GKJqxbAmNvM75ywp/assets/images/screenshots/logging/logs-query-autocomplete.png?fit=max&auto=format&n=GKJqxbAmNvM75ywp&q=85&s=1d485a8dc03e051cafa87a0d26819463" alt="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" width="1369" height="675" data-path="assets/images/screenshots/logging/logs-query-autocomplete.png" />
</Frame>

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.

<h2 id="type-a-query-directly">
  Digitar uma consulta diretamente
</h2>

A barra de consulta é um campo de texto, então você também pode digitar ou colar uma consulta. A [sintaxe de consulta](/logging/query-syntax) 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](/labs) e fica atrás de uma feature flag. Entre em contato com o [suporte](mailto:support@appsignal.com) para habilitá-lo para sua organização. Compartilhe seu feedback em nosso [servidor do Discord](https://discord.gg/EjF6ykYx63). Assim que uma consulta retornar as linhas de que você precisa, você pode transformá-las em uma [métrica baseada em logs](/logging/metrics) sem sair da página.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.