# Logs

Guarde num lugar só os logs que os scripts da cidade mandavam para o Discord, com busca, filtros por jogador e uma visão geral do movimento.

Source: https://fivedash.fivex.gg/docs/pt/logs/overview

O módulo **Logs** é o arquivo da cidade: tudo o que os scripts registram (quem conectou, quem matou quem, o que saiu do baú, quem mexeu no dinheiro) chega aqui em vez de ir para canais de webhook no Discord. O FiveDash guarda cada log, lê dele o passaporte, o Discord, os identificadores e as coordenadas, e deixa tudo pesquisável. Esta página é para o dono e a equipe que cuidam dos logs do servidor.

## Antes de começar

* **Plano:** o módulo Logs precisa estar no plano da organização. Veja [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing).
* **Servidor:** os logs ficam ligados a um servidor FiveM da organização. Sem servidor, a página mostra **Nenhum servidor ainda**.
* **Configuração inicial:** só quem tem **Todos os logs** no nível **Configurar** faz a configuração. Os outros veem **Os logs ainda não foram configurados** até ela terminar.

## Como os scripts mandam os logs

Cada log do FiveDash (um "canal", como **Mortes e combate** ou **Inventário e baús**) recebe os logs por um destes dois jeitos. Os dois funcionam ao mesmo tempo.

| Jeito                                | O que é                                                                                                                       | Quando usar                                                                                                                                                            |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Webhook do Discord**               | Um link do FiveDash no lugar do link `discord.com/api/webhooks/…` que o script já usa. O resto do script fica igual.          | Scripts prontos, que já mandam para um webhook. Veja [Trocar webhooks do Discord](https://fivedash.fivex.gg/docs/pt/logs/migrate-from-webhooks).                       |
| **Export do FiveDash** (recomendado) | Uma linha de Lua no lado do servidor do script: `exports.fivedash:log("chave", { … })`. Precisa do recurso `fivedash` ligado. | Scripts seus ou que você pode editar. Mais rápido, e já lê o passaporte do jogador. Veja [Recurso FiveM](https://fivedash.fivex.gg/docs/pt/developers/fivem-resource). |

## O que tem no módulo

| Página            | Caminho no painel                                | O que mostra                                                                                                      |
| ----------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Visão geral**   | **Logs → Visão geral**                           | Números, gráficos e o que está chegando agora.                                                                    |
| **Todos os logs** | **Logs → Todos os logs**                         | O explorador com todos os logs, busca e filtros.                                                                  |
| Cada log          | **Logs →** nome do log                           | O explorador só daquele log, com **Como mandar**, **Mandar teste** e **Editar log**.                              |
| Assistente        | Botão **Assistente** no topo das páginas de Logs | O [Assistente de logs](https://fivedash.fivex.gg/docs/pt/logs/assistant), que procura e explica os logs por você. |

## Visão geral

Em **Logs → Visão geral** você vê o que os scripts do servidor mandaram no período escolhido: **24 horas**, **7 dias** (padrão) ou **30 dias**.

| Bloco                      | O que mostra                                                                                                             |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Hoje** / **Última hora** | Quantos logs chegaram, comparado com a hora antes.                                                                       |
| **Logs recebendo**         | Quantos logs tiveram algo nas últimas 24 h.                                                                              |
| **Em silêncio**            | Logs que não receberam nada nas últimas 24 h (ou **Todos mandaram nas 24 h**).                                           |
| **Pico**                   | O momento com mais logs no período.                                                                                      |
| **Testes**                 | Logs mandados pelo botão de teste.                                                                                       |
| Gráfico                    | Escolha a **Métrica do gráfico**: **Logs**, **Jogadores** ou **Por hora** (comparado com o período anterior, tracejado). |
| **Por log**                | A parte de cada log no período e quando chegou o último.                                                                 |
| **Horários de pico**       | Quando os logs chegam, por dia da semana e hora, no horário de Brasília.                                                 |
| **Jogadores mais ativos**  | Quem mais aparece nos logs (contado nos 20 mil logs mais recentes do período).                                           |
| **Eventos mais comuns**    | Os títulos que mais se repetem.                                                                                          |
| **Scripts**                | Quem manda: o nome do webhook em cada log.                                                                               |
| **Chegando agora**         | Os logs novos, ao vivo.                                                                                                  |

## Níveis de acesso

O acesso aos logs é dado em **Configurações → Membros**. Há duas áreas no módulo, e também dá para liberar **Cada log** separado.

| Área              | Nível          | O que permite                                 |
| ----------------- | -------------- | --------------------------------------------- |
| **Todos os logs** | **Ver**        | Todos os logs, inclusive os que forem criados |
| **Todos os logs** | **Configurar** | Criar logs, configurar todos e ver os links   |
| **Criar logs**    | **Gerenciar**  | Criar logs novos e configurar os que criar    |
| Um log só         | **Ver**        | Os logs que chegam neste log                  |
| Um log só         | **Configurar** | Nome, chave, link do webhook e testes         |

> Quem só tem **Ver** não vê o link do webhook: com o link, qualquer um consegue mandar logs para o servidor.

## Limites do plano

|                                  | Plus     | Pro        | Ultra      |
| -------------------------------- | -------- | ---------- | ---------- |
| **Webhook e export do resource** | Sim      | Sim        | Sim        |
| **Logs guardados por**           | 7 dias   | 30 dias    | 90 dias    |
| **Logs recebidos por mês**       | 1 milhão | 10 milhões | 50 milhões |
| **Logs por servidor**            | 15       | 30         | 60         |

## Perguntas frequentes

**Os scripts precisam mudar muito?**
Não. Pelo webhook, você só troca o link na config do script. Pelo export, é uma linha de Lua por log.

**Dá para usar webhook e export no mesmo servidor?**
Sim. Cada log aceita os dois jeitos. A opção **Como o script manda** só muda o que o FiveDash mostra como instrução para aquele log.

**Os arquivos e prints mandados junto com o webhook ficam guardados?**
Não. O log registra quantos arquivos vieram (**Arquivos**: "não guardados"), mas o arquivo em si não é salvo. Para guardar prints, use a [CDN](https://fivedash.fivex.gg/docs/pt/cdn/overview).

## Próximos passos

[Criar logs](https://fivedash.fivex.gg/docs/pt/logs/create-logs)Configure os logs, os links e as chaves.
[Trocar webhooks do Discord](https://fivedash.fivex.gg/docs/pt/logs/migrate-from-webhooks)Aponte os scripts prontos para o FiveDash.
[Buscar e filtrar](https://fivedash.fivex.gg/docs/pt/logs/search-and-filter)Encontre quem fez o quê e quando.
[Assistente de logs](https://fivedash.fivex.gg/docs/pt/logs/assistant)Pergunte em português e receba a resposta com os logs.
