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

# Sintaxe legada de consulta de logs

> Sintaxe de consulta de logs com o prefixo attributes. e sufixos de tipo, para contas ainda não migradas para a sintaxe atual.

> [!WARNING]
>
> Esta sintaxe de consulta será descontinuada no futuro. Volte para nossa [nova
> sintaxe de consulta](https://docs.appsignal.com/logging/query-syntax.md). Se você quiser mudar para a nova
> sintaxe de consulta, [entre em contato com o suporte](mailto:support@appsignal.com).

O poderoso sistema de filtragem de logs do AppSignal permite que você pesquise e filtre rapidamente 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ê procura em seus logs.

Pense nisso como um mecanismo de busca para os logs da sua aplicação. Aqui está um exemplo simples:

Se você quiser encontrar todos os logs de erro, pode usar:
`severity=error`

Ou se você quiser encontrar logs contendo a palavra "timeout":
`message:timeout`

![Captura de tela de log expandido](https://mintcdn.com/appsignal-715f5a51/g-Xvhfxoo9Zu0ive/assets/images/screenshots/logging/all-logs.png?fit=max\&auto=format\&n=g-Xvhfxoo9Zu0ive\&q=85\&s=294a9482dd18a89b870da2f9f8f13055)

O AppSignal suporta filtragem de logs por:

| Campo de filtro | Descrição | Exemplo de consulta |
| - | - | - |
| `severity` | Nível de severidade do log. Valores aceitos: error, warning, info, debug e trace | `severity=error` |
| `hostname` | Host da aplicação (via pesquisa) | `hostname=appsignal` |
| `group` | Namespaces definidos para sua aplicação (via pesquisa) | `group=users` |
| `message` | Conteúdo da mensagem de log (via pesquisa) | `message:error` |
| `attributes` | Atributos definidos em seus logs (via pesquisa) | `attributes.duration_double>10.1` (veja [Tipos de atributo](#attribute-types)) |

## Sintaxe de pesquisa explicada

A tabela abaixo explica a sintaxe atual de consulta de pesquisa do AppSignal Logs.

Consultas podem ser combinadas com um espaço entre elas (veja Consultas combinadas em [Combinando múltiplas consultas](#combining-multiple-queries)).

### Visão geral da consulta de pesquisa

| Nome da consulta | Sintaxe AppSignal | Descrição |
| - | - | - |
| Wildcard | `Foo` | Retorna todos os logs que contêm um valor semelhante a `Foo` |
| Múltiplos wildcards | `Foo Bar` | Retorna todos os logs que contêm um valor semelhante a `Foo` e um valor semelhante a `Bar` |
| Wildcard para palavras com espaços | `"Foo Bar"` | Retorna todos os logs que contêm um valor semelhante a `"Foo Bar"` |
| Pesquisa por campo | `hostname:foo` | Retorna todos os logs em que o campo hostname é semelhante a `Foo` |
| Pesquisa por campo com múltiplas palavras | `hostname:"foo bar"` | Retorna todos os logs em que o campo hostname é semelhante a `"Foo Bar"` |
| Correspondência exata | `hostname=foo` | Retorna todos os logs em que o campo hostname é `Foo` |
| Negação de consulta exata | `hostname!=foo` | Retorna todos os logs em que o campo hostname não é `Foo` |
| Negação de consulta wildcard | `hostname!:foo` | Retorna todos os logs em que o campo hostname não é semelhante a `Foo` |
| Corresponde a qualquer item na lista | `hostname=[\"frontend1\", frontend2]"` | Retorna todos os logs que correspondem a qualquer item na lista `["frontend1", "frontend2"]` |
| Não corresponde a nenhum item na lista | `group!=[\"app\", unix]"` | Retorna todos os logs que não correspondem a nenhum item na lista `["app", "unix"]` |
| Consulta específica de atributo | `attributes.attribute_name` | Consulta atributos de log. Substitua `attribute_name` pelo atributo que você está consultando (incluindo seu sufixo de tipo). Você pode usar qualquer operador AppSignal válido nesta tabela para compor sua consulta. |
| Maior que | `attributes.duration_double>100` | Retorna todos os logs em que `duration` é maior que 100 |
| Menor que | `attributes.duration_double<100` | Retorna todos os logs em que `duration` é menor que 100 |

As consultas wildcard acima correspondem ao texto informado em qualquer parte do valor. Não existe um caractere wildcard. Um asterisco é pesquisado literalmente, portanto `hostname:web*` corresponde apenas a hostnames que contêm o texto `web*`.

### Combinando múltiplas consultas

Você pode combinar múltiplas consultas adicionando-as juntas com espaços.

1. Encontre logs contendo "error":
   `message:error`

2. Adicione um filtro para um grupo específico:
   `message:error group="background jobs"`

3. Exclua certos hostnames:
   `message:error group="background jobs" hostname!:test-server`

### Tipos de atributo

Ao filtrar atributos de log personalizados usando operadores de comparação (`>`, `<`, `>=`, `<=`), você **deve** incluir um sufixo de tipo no nome do atributo. Sem o sufixo de tipo correto, a consulta falhará.

Os sufixos de tipo suportados são:

| Sufixo | Tipo | Exemplo |
| - | - | - |
| `_int` | Integer | `attributes.user_id_int>1000` |
| `_double` | Float | `attributes.duration_double>5.65` |
| `_bool` | Boolean | `attributes.success_bool=true` |
| `_string` | String | `attributes.region_string=eu` |

> [!WARNING]
>
> **Importante:** Não inclua espaços ao redor dos operadores de comparação ao
> consultar atributos. Por exemplo, use `attributes.duration_double>5.65` — **não**
> `attributes.duration_double > 5.65`. Espaços farão a consulta falhar.

### Casos de uso comuns

1. Encontre todos os erros de um servidor específico:
   `severity=error hostname=production-web-1`

2. Encontre consultas lentas ao banco de dados:
   `source=PostgreSQL attributes.duration_double>100.0`

3. Depure jobs em segundo plano que falharam:
   `group="background jobs" message:failed`


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