# Logs

Source: https://instatus.com/help/pt-br/observability/logs

Abra **Observability** → **Logs** na sua página de status. Os logs mais recentes ficam no topo, com um gráfico do volume de logs acima. A linha vermelha do gráfico são os erros, para você ver de relance quando algo começou.

![O explorador de logs, com contagens por nível, o gráfico de volume e os logs mais recentes](https://instatus.com/help/observability/logs.png)

| At a glance | Details |
| :-- | :-- |
| [Pesquisar](https://instatus.com/help/pt-br/observability/logs#pesquisar) | Digite palavras, pressione Enter |
| [Filtrar](https://instatus.com/help/pt-br/observability/logs#filtrar) | level:, service:, trace_id: ou qualquer atributo |
| [Período](https://instatus.com/help/pt-br/observability/logs#mude-o-período) | Predefinidos, personalizado ou arrastando no gráfico |
| [Ler um log](https://instatus.com/help/pt-br/observability/logs#leia-um-log) | Clique em uma linha |
| [Ao vivo](https://instatus.com/help/pt-br/observability/logs#ao-vivo) | Pressione L |
| [Exportar](https://instatus.com/help/pt-br/observability/logs#exportar) | CSV, JSON ou copiar |

## Pesquisar

Digite palavras na caixa de pesquisa e pressione **Enter**. As palavras são encontradas em qualquer parte da mensagem, em qualquer ordem. Coloque uma frase entre aspas para encontrá-la exata, como `"rate limited"`.

O gráfico, as contagens e a lista se atualizam com sua pesquisa.

![Uma pesquisa por uma frase entre aspas combinada com um filtro de serviço](https://instatus.com/help/observability/logs-search.png)

## Filtrar

Clique na caixa de pesquisa vazia para ver por onde filtrar. Escolha um campo e depois um valor. Cada campo lista seus valores mais comuns, com a frequência de cada um.

![A lista de campos para filtrar, abaixo da caixa de pesquisa](https://instatus.com/help/observability/logs-suggestions.png)

| Filtro       | Encontra                                                                      |
| ------------ | -------------------------------------------------------------------------- |
| `level:`     | Um nível: `fatal`, `error`, `warn`, `info`, `debug` ou `trace`              |
| `service:`   | Logs de um serviço                                                      |
| `trace_id:`  | Cada log de uma requisição, em todos os serviços                            |
| Qualquer atributo | Digite o nome, como `http.route:` ou `customer.id:`                    |

Um filtro vira uma etiqueta na caixa de pesquisa. Clique no **×** para removê-lo. Coloque `-` antes de um filtro para excluí-lo, como `-level:debug`.

### Filtrar por nível

Digite `level:` para abrir o seletor de nível. Ele mostra quantos logs cada nível tem. Pressione **Espaço** para escolher vários e depois **Enter**. Dois atalhos cobrem os casos comuns: `level:>=warn` mantém avisos e tudo o que for pior, e `-level:debug` esconde o ruído de depuração.

![O seletor de nível, com uma contagem por nível e dois atalhos](https://instatus.com/help/observability/logs-levels.png)

O botão **Serviço** ao lado da caixa de pesquisa é um atalho para `service:`. Clicar em um nível acima do gráfico liga ou desliga esse nível.

### Sintaxe de pesquisa

| Escreva                                  | Encontra                                       |
| -------------------------------------- | ------------------------------------------- |
| `timeout`                              | Logs que contêm a palavra                  |
| `"connection pool"`                    | Essa frase exata                           |
| `timeout retry`                        | As duas palavras, em qualquer ordem                    |
| `timeout OR refused`                   | Qualquer uma das palavras                                 |
| `-timeout` ou `NOT timeout`            | Logs sem a palavra                       |
| `level:error service:api`              | Os dois filtros                                |
| `(timeout OR refused) AND service:api` | Agrupado com parênteses                    |
| `service:"billing worker"`             | Um valor com espaços, entre aspas              |

`AND`, `OR` e `NOT` são escritos em maiúsculas. Se uma pesquisa não puder ser lida, por exemplo porque uma aspa nunca é fechada, o explorador avisa e mantém os resultados anteriores.

Suas pesquisas recentes aparecem quando você abre a caixa de pesquisa, então uma pesquisa frequente fica a um clique.

## Mude o período

Clique no botão de período para escolher dos últimos 15 minutos aos últimos 7 dias, ou defina um período personalizado com **De** e **Até**.

![O menu de período, com opções predefinidas e um período personalizado](https://instatus.com/help/observability/logs-time-range.png)

Para dar zoom em um pico, arraste sobre ele no gráfico. O botão de voltar retorna ao período anterior.

## Leia um log

Clique em uma linha, ou chegue a ela com **↑** **↓** e pressione **Enter**. O painel de detalhes abre com:

- A mensagem completa, com **Copiar mensagem**.
- **Logs semelhantes**, para pesquisar mensagens parecidas.
- **N logs neste trace**, quando o log pertence a uma requisição. Mostra cada log dessa requisição, em todos os serviços.
- Os atributos do log e seu recurso (o serviço, o host e a versão de onde veio). Clique em um valor para filtrar por ele, excluí-lo ou copiá-lo.

![Um log de erro aberto no painel de detalhes, com a mensagem, o link para o trace e os atributos](https://instatus.com/help/observability/logs-detail.png)

As setas no topo do painel vão para o log anterior e o próximo.

## Ao vivo

Pressione **L** ou clique em **Ao vivo** para ver os logs conforme chegam. Os novos aparecem no topo, e o cabeçalho mostra quantos chegam por segundo. Sua pesquisa e seus filtros continuam valendo, então `level:error` ao vivo é um feed de erros em tempo real.

![A visão ao vivo, com novos logs chegando e a taxa por segundo](https://instatus.com/help/observability/logs-live.png)

Clique no botão de pausa, ou pressione **L** de novo, para parar. O gráfico mantém o período que você tinha antes de entrar ao vivo. Se os logs chegarem mais rápido do que é possível mostrar, um aviso informa: pause e pesquise para ver todos.

## Exportar

Marque os logs desejados nas caixas de seleção. Uma barra aparece acima da lista com **Exportar CSV**, **Exportar JSON** e **Copiar**.

![Três logs selecionados, com os botões para exportar em CSV e JSON e copiar acima da lista](https://instatus.com/help/observability/logs-export.png)

O botão de download no fim da barra de pesquisa exporta em CSV todos os logs carregados na lista. As exportações contêm horário, serviço, nível e mensagem de cada log. Para os atributos de um log, abra-o e use **Copiar como JSON** no painel de detalhes.

## Atalhos de teclado

| Tecla               | Faz                                 |
| ----------------- | ------------------------------------ |
| `↓` `↑` ou `J` `K` | Mover entre logs                   |
| `Enter`           | Abrir o log selecionado                |
| `Esc`             | Fechar o painel de detalhes ou um menu      |
| `L`               | Iniciar ou parar a visão ao vivo              |
| `Space`           | Escolher vários valores em um seletor      |

- [Traces](https://instatus.com/help/pt-br/observability/traces): Veja onde cada requisição gasta seu tempo
- [Dashboards](https://instatus.com/help/pt-br/observability/dashboards): Seus números principais em uma página
