# Criar logs Configure os logs do servidor, pegue o link de cada um, defina a chave do export e entenda por quanto tempo os logs ficam guardados. Source: https://fivedash.fivex.gg/docs/pt/logs/create-logs Cada log do FiveDash é uma gaveta do arquivo da cidade: **Mortes e combate**, **Inventário e baús**, **Roubo a lojinha**. Cada um tem um nome, um ícone, uma chave para o export e um link próprio para usar no lugar do webhook do Discord. Esta página mostra como fazer a configuração inicial, criar logs depois, pegar o link e editar ou excluir um log. [Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/logs-create-pt.mp4) ## Antes de começar * **Plano:** o módulo Logs no plano da organização. O número de logs por servidor depende do plano: **15** no Plus, **30** no Pro e **60** no Ultra. * **Nível de acesso:** | O que fazer | Nível necessário | | ------------------------------------------------------------------ | ----------------------------------------------------------------------- | | Configuração inicial (os três passos) | **Todos os logs** em **Configurar** | | Criar um log novo (**Novo log**) | **Todos os logs** em **Configurar**, ou **Criar logs** em **Gerenciar** | | Ver o link, editar, gerar novo link, mandar teste e excluir um log | **Configurar** naquele log (ou **Todos os logs** em **Configurar**) | > Quem cria um log pelo **Criar logs** ganha **Configurar** nesse log automaticamente. ## Configuração inicial Na primeira vez que alguém abre **Logs**, aparece **Traga os logs para o FiveDash**, com três passos. ### Escolha os logs Em **Que logs seus scripts mandam?**, marque os tipos que a cidade usa (a lista está na tabela abaixo). Em **Outros logs**, digite em **Nome do log** o nome de um log próprio, como "Roubo a lojinha", e clique em **Adicionar**. Clique em **Criar o link** (com mais de um log, o botão mostra o número, como **Criar 4 links**). ### Ligue os scripts Escolha a aba **Webhook do Discord** ou **Export do FiveDash**. No webhook, copie o link de cada log e cole na config do script no lugar do link `discord.com/api/webhooks`. No export, copie a chamada de cada log. Clique em **Já troquei** (webhook) ou **Pronto** (export). ### Receba o primeiro log Entre na cidade e faça algo que um script registra, ou clique em **Mandar log de teste**. Quando o log chegar, ele aparece como o script mandou e com o que o FiveDash leu dele. ### Ative os logs Clique em **Ativar logs**. O botão só libera depois que o primeiro log chegou. No fim, clique em **Ir para os logs**. > Durante a configuração, o botão **Editar** do primeiro passo deixa mudar a lista. Um log que você tira da lista é excluído junto com tudo o que ele recebeu. ### Tipos de log prontos | Log | Chave | Para que serve | | ---------------------- | -------------- | -------------------------------------------- | | **Entrada e saída** | `conexoes` | Quem conectou, desconectou ou caiu. | | **Chat e comandos** | `chat` | Mensagens, /me e comandos digitados. | | **Mortes e combate** | `mortes` | Quem matou quem, com que arma e onde. | | **Inventário e baús** | `inventario` | Itens pegos, guardados, dropados e enviados. | | **Dinheiro e banco** | `dinheiro` | Transferências, saques, depósitos e multas. | | **Veículos e garagem** | `veiculos` | Spawns, compras, vendas e garagens. | | **Polícia e prisão** | `policia` | Prisões, revistas, apreensões e multas. | | **Ações da staff** | `staff` | Comandos de admin: god, noclip, tp, item. | | **Facções e empresas** | `organizacoes` | Baús, cofres, contratações e demissões. | | **Anticheat** | `anticheat` | Avisos e banimentos automáticos. | Um log de **Outros logs** recebe a chave tirada do nome: "Roubo à lojinha" vira `roubo-a-lojinha`. Se a chave já existir, o FiveDash põe `-2`, `-3` no fim. ## Criar um log depois ### Abra o diálogo Na barra lateral, em **Logs**, clique em **Novo log**. ### Dê ícone e nome Em **Ícone e nome**, escolha o ícone (dá para buscar por nome em **Buscar ícone**) e digite o nome, como "Roubo a lojinha". ### Escolha como o script manda Em **Como o script manda**, escolha **Export do FiveDash** (recomendado) ou **Webhook do Discord**. No export, confira a **Chave**: ela é preenchida a partir do nome e o FiveDash avisa se está livre. ### Crie Clique em **Criar log**. O diálogo mostra **Log criado. Agora é só colar o link no script.** (webhook) ou **Log criado. Agora é só chamar o export no script.** (export), com o link ou o código para copiar. Clique em **Abrir log** para ir à página dele. ### Campos do log | Campo | O que faz | Padrão | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | Ícone | O ícone do log na barra lateral e nos logs. Só muda no FiveDash. | **Registro** (novo log) ou o ícone do tipo | | Nome | Como o log aparece no painel. De 2 a 40 caracteres, sem repetir o nome de outro log (maiúsculas e acentos não contam). | — | | **Como o script manda** | **Export do FiveDash** ou **Webhook do Discord**. Os dois jeitos continuam funcionando: muda só a instrução que o FiveDash mostra. | **Export do FiveDash** no **Novo log**; **Webhook do Discord** nos logs da configuração inicial | | **Chave** | O nome que os scripts usam no export: `exports.fivedash:log("chave", …)`. De 2 a 32 caracteres, só letras minúsculas, números, `-` e `_`, começando por letra ou número. Única no servidor. | Tirada do nome | | Link | O endereço que entra no lugar do webhook do Discord. Único por log. | Gerado na criação | ## O link do log O link de cada log tem este formato: ```http https://logs.fivex.sh/api/logs// ``` * `` é o identificador do log (um UUID). * `` é um segredo de 43 caracteres. Quem tem o link consegue mandar logs para o servidor. Para copiar o link: abra o log na barra lateral, clique em **Como mandar** no topo e use o botão de copiar. Se o log estiver no export, clique antes em **Usar webhook** (em "O script já manda para um webhook do Discord?"). O link também aparece em **Editar log**, na seção **Como mandar**. Na configuração inicial, os links ficam no passo **Ligue os scripts** (botão **Ver links**). > Não compartilhe o link. Se ele vazar, gere um novo (veja abaixo). Sempre copie o link do painel em vez de digitar. ## Editar um log ### Abra o log Na barra lateral, em **Logs**, clique no log. ### Abra a edição No topo, clique no lápis (**Editar log**). ### Mude e salve Mude o ícone, o nome, **Como o script manda** ou a **Chave** e clique em **Salvar**. > O nome e o ícone mudam só no FiveDash. Mudar a chave pede para trocar nos scripts que usam o export. ## Gerar um link novo Use quando o link vazou ou quando quer cortar um script antigo. ### Abra a edição do log Abra o log e clique em **Editar log**. A opção aparece com **Webhook do Discord** escolhido. ### Gere o link Em **Como mandar**, clique em **Gerar novo link** e confirme em **Gerar novo link**. ### Troque nos scripts Copie o link novo e cole nos scripts. O anterior parou de funcionar na hora. ## Excluir um log Abra o log, clique em **Editar log**, depois em **Excluir log** e confirme em **Excluir de vez**. > Excluir um log apaga todos os logs que ele recebeu, e o link para de funcionar. Não dá para desfazer. ## Por quanto tempo os logs ficam guardados | Plano | **Logs guardados por** | **Logs recebidos por mês** | **Logs por servidor** | | ----- | ---------------------- | -------------------------- | --------------------- | | Plus | 7 dias | 1 milhão | 15 | | Pro | 30 dias | 10 milhões | 30 | | Ultra | 90 dias | 50 milhões | 60 | O limite de logs por mês vale para a organização inteira. O de logs por servidor vale para cada servidor. ## Perguntas frequentes **Apareceu "Até 15 logs por servidor no seu plano." O que faço?** O servidor chegou ao limite de logs do plano. Exclua um log que não usa mais ou mude de plano em **Configurações → Plano**. **Mudei o nome do log. Preciso trocar algo nos scripts?** Não. Nome e ícone são só do painel. Só a chave (export) e o link (webhook) importam para os scripts. **A chave diz "Já usada no log …". E agora?** Outro log do servidor já usa essa chave. Clique na sugestão que aparece ao lado ou escreva outra. ## Próximos passos [Trocar webhooks do Discord](https://fivedash.fivex.gg/docs/pt/logs/migrate-from-webhooks)Cole o link do log nos scripts prontos. [Recurso FiveM](https://fivedash.fivex.gg/docs/pt/developers/fivem-resource)Mande logs pelo export do FiveDash. [Buscar e filtrar](https://fivedash.fivex.gg/docs/pt/logs/search-and-filter)Encontre os logs que chegaram. [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Dê acesso a um log só para cada pessoa.