# Buscar e filtrar

Encontre nos logs quem fez o quê e quando, com busca por texto, filtros por log, script e jogador, período e o detalhe de cada log.

Source: https://fivedash.fivex.gg/docs/pt/logs/search-and-filter

Quando alguém pergunta "quem tirou o fuzil do baú da facção ontem?", a resposta está nos logs. O explorador do FiveDash junta todos os logs da cidade numa lista só, com busca, filtros e o detalhe de cada log. Esta página é para a staff que investiga o que aconteceu no servidor.

[Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/logs-search-pt.mp4)

## Antes de começar

* **Nível de acesso:** **Ver** em **Todos os logs**, ou **Ver** em cada log que você precisa. Você só vê os logs que tem liberados.
* **Logs ativos:** a configuração dos logs precisa estar concluída. Veja [Criar logs](https://fivedash.fivex.gg/docs/pt/logs/create-logs).

## Onde buscar

| Página            | Caminho                  | O que lista                                           |
| ----------------- | ------------------------ | ----------------------------------------------------- |
| **Todos os logs** | **Logs → Todos os logs** | Tudo o que os scripts da cidade mandam, num lugar só. |
| Um log            | **Logs →** nome do log   | Só os logs daquele log.                               |

## Buscar um log

### Abra o explorador

Vá em **Logs → Todos os logs** (ou abra um log na barra lateral).

### Digite a busca

Na caixa **Buscar nos logs: nome, item, placa, comando…**, digite o que procura. A busca olha o título, os valores e o nome do script, sem diferenciar maiúsculas.

### Escolha o período

Clique no período e escolha uma opção. Para uma janela exata, escolha **Personalizado (horário de Brasília)**, preencha **De** e **Até** e clique em **Aplicar**.

### Abra o log

Clique num log da lista para ver o detalhe.

## Períodos

| Opção                                   | O que cobre                                                                                 |
| --------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Última hora**                         | Os últimos 60 minutos.                                                                      |
| **Últimas 24 horas**                    | O último dia.                                                                               |
| **Últimos 7 dias**                      | A última semana. É o padrão.                                                                |
| **Últimos 30 dias**                     | O último mês.                                                                               |
| **Todo o período**                      | Tudo o que ainda está guardado.                                                             |
| **Personalizado (horário de Brasília)** | De uma data e hora até outra. **De** vazio é "Desde o começo"; **Até** vazio é "Até agora". |

## Filtros

Clique em **Filtros** para abrir os filtros. Cada filtro aceita até 20 valores, e um log aparece se bater com qualquer um deles. **Limpar filtros** tira todos.

| Filtro      | O que faz                                                                                                                                                                                 | Padrão             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **Log**     | Mostra só os logs escolhidos (só em **Todos os logs**).                                                                                                                                   | Todos              |
| **Script**  | Mostra só o que um script mandou (o nome do webhook, o `username`). Busque em **Buscar scripts**.                                                                                         | Todos              |
| **Jogador** | Mostra os logs que citam um jogador. Digite em **ID do jogador, Discord ou license** e aperte Enter; dá para somar vários. Em **Vistos nos últimos logs** aparecem os jogadores recentes. | Nenhum             |
| **Testes**  | **Mostrar testes** (junto com os logs dos scripts), **Esconder testes** (só o que os scripts mandaram) ou **Só testes** (os mandados pelo painel).                                        | **Mostrar testes** |

### Como o filtro Jogador entende o valor

| Você digita                                             | O FiveDash procura                                                                                          |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Um número de 17 a 20 dígitos, como `312456789012345678` | A **conta do Discord**: todos os logs que citam essa conta. Uma menção `<@312456789012345678>` também vale. |
| Algo com `:`, como `license:4f1c…`                      | O **identificador**: license, steam, fivem…                                                                 |
| Qualquer outro valor, como `1042`                       | O **passaporte ou ID do personagem**.                                                                       |

> Na lista ou no detalhe, clique no ID de um jogador (**Ver só os logs do ID…** / **Filtrar**) para filtrar por ele na hora.

## A lista

| Parte                 | O que mostra                                                                                                                       |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Resumo do período** | Quantos logs, a média por hora, os **Jogadores** (personagens nos logs), o **Pico** e o **Último log**, com um gráfico do período. |
| Lista                 | Os logs do mais novo para o mais antigo, separados por **Hoje**, **Ontem** e data.                                                 |
| **Por página**        | 25, 50 (padrão) ou 100 logs por página, com **Primeira**, **Anterior** e **Próxima**.                                              |
| **Mostrando … de …**  | O total. A contagem para em 10.000 (mostra "10.000+").                                                                             |

### Ao vivo e pausado

O explorador abre **Ao vivo**: os logs novos entram sozinhos. Clique em **Ao vivo** para **Pausar** (os novos esperam até você voltar) e em **Pausado** para voltar ao vivo. Quando a lista muda muito, use **Atualizar histórico**.

## O detalhe de um log

Clique num log para abrir o detalhe ao lado. Use as setas ↑ e ↓ do teclado para ir ao **Log anterior** e ao **Próximo log**.

| Seção               | O que mostra                                                                                                                                                                 |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Quem**            | Os jogadores do log: **ID do personagem**, nome e a conta do Discord (foto e nome, lidos pelo bot do servidor).                                                              |
| **O que aconteceu** | O título, o texto e os **Detalhes**: cada valor lido do log, com botão para copiar.                                                                                          |
| **Onde**            | As **Coordenadas** encontradas no log (**Local 1**, **Local 2**…).                                                                                                           |
| **Origem**          | **Log**, **Chegou por** (**Export do FiveDash** ou **Webhook**), **Recurso**, **Script**, **Recebido**, **Hora na cidade**, **Hora no embed**, **Arquivos** e **ID do log**. |

## Compartilhar uma busca

A busca, os filtros, o período e a página ficam no endereço da página. Copie o endereço do navegador e mande para outra pessoa da equipe: ela abre a mesma busca. Um log aberto também fica no endereço, e o link abre o detalhe direto. A pessoa só vê o que o acesso dela permite.

## Perguntas frequentes

**Busquei um jogador e não veio nada. Por quê?**
O filtro **Jogador** só acha logs em que o passaporte, o Discord ou o identificador aparecem no texto. Confira se o script manda esse dado e se o período cobre a data. Tente também a busca por texto.

**Apareceu "Esta consulta expirou ou o acesso aos logs mudou."**
Clique em **Ir para a primeira página** para refazer a busca.

**Por que não vejo um log na lista de filtros?**
Você só vê os logs liberados para você. Peça a um dono ou admin da organização em **Configurações → Membros**.

## Próximos passos

[Assistente de logs](https://fivedash.fivex.gg/docs/pt/logs/assistant)Peça para a IA investigar por você.
[Visão geral dos logs](https://fivedash.fivex.gg/docs/pt/logs/overview)Os números e gráficos do servidor.
[Trocar webhooks do Discord](https://fivedash.fivex.gg/docs/pt/logs/migrate-from-webhooks)O que o FiveDash lê de cada log.
[Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Libere logs para a equipe.
