Sistema de Registro
Rastreie tudo o que acontece em seu servidor com 55 tipos de eventos organizados em 18 categorias, roteamento de canais por categoria e cores de embed personalizadas — tudo configurado a partir do painel.
Topics: logs, logging, audit, events, tracking
Rastreie tudo o que acontece em seu servidor com 55 tipos de eventos organizados em 18 categorias, roteamento de canais por categoria e cores de embed personalizadas — tudo configurado a partir do painel.
Visão Geral
O sistema de registro grava eventos do servidor e publica embeds detalhados nos canais que você escolher. É a espinha dorsal da responsabilidade de moderação e visibilidade geral: quem entrou, o que foi deletado, quais funções mudaram, quem foi banido e muito mais.
Tudo é configurado em Painel → Registros. Nada é ativado por padrão — você decide exatamente quais categorias rastrear e para onde cada uma é enviada. Para um atalho de um comando que ativa tudo em um único canal, veja os Comandos de Registros.
Habilitação e configuração básica
- Abra Painel → Registros para seu servidor.
- Ative Ativo no cabeçalho da página para ligar o sistema.
- Use o seletor de Canal de registro geral no cabeçalho para enviar *todas* as categorias para um canal — a forma mais rápida de começar.
- Ou expanda qualquer categoria abaixo para dar a ela seu próprio canal e ativá-la.
Dica: O Netrcol precisa de Ver Canal, Enviar Mensagens, Incorporar Links e Ler Histórico de Mensagens em cada canal que você registrar. A verificação de saúde da configuração na página avisará se alguma permissão estiver faltando.
Canais por categoria
Cada categoria é uma linha expansível com seu próprio seletor de canal e interruptor de ativação/desativação. Isso permite que você divida seus registros entre canais — por exemplo, registros de moderação em um canal privado para a equipe e registros de entrada/saída em um público.
Se todas as categorias apontarem para o mesmo canal, o seletor de cabeçalho Canal de registro geral mostrará esse canal; se forem diferentes, mostrará *“Canais diferentes.”* Configurá-lo novamente redireciona tudo para um único canal.
Cores de embed
Cada evento tem uma faixa de cor que você pode personalizar. Abra uma categoria, e cada linha de evento tem uma amostra de cor — útil para distinguir categorias rapidamente (por exemplo, vermelho para moderação, verde para entradas).
Categorias de registro
O Netrcol agrupa seus 55 tipos de eventos nessas 18 categorias:
| Categoria | O que registra |
|---|---|
| Bot | Interação do bot e registros do ciclo de vida da guilda |
| Moderação | Registros de banimento, desbloqueio, automoderação e ações da equipe |
| Mensagem | Registros de exclusão, edição e exclusão em massa de mensagens legíveis |
| Reação | Atividade de adicionar e remover emojis |
| Membro | Entradas, saídas, atualizações de função, mudanças de apelido e timeouts |
| Canal | Criação, exclusão, renomeação, mudanças de tópico e categoria de canal |
| Função | Registros de criação, atualização e exclusão de funções |
| Voz | Mudanças de estado de voz (eventos de voz de depuração requerem uma flag de opt-in) |
| Convite | Registros de criação e exclusão de convites |
| Servidor | Mudanças nas configurações, nome e estrutura do servidor |
| Ativo | Registros de atualização de emojis e adesivos |
| Webhook | Eventos de atualização de webhook |
| Segurança | Atividades arriscadas e registros do sistema de proteção |
| Integração | Eventos de atualização de integração da guilda |
| Evento Agendado | Registros de criação, atualização e exclusão de eventos agendados |
| Mensagem Fixada | Registros de atualização de fixação de canal |
| Presença | Registros de digitação e presença (opt-in, alto volume) |
| Usuário | Mudanças no perfil do usuário, mostradas uma vez por guilda afetada |
Títulos inteligentes
Algumas categorias usam títulos mais limpos e específicos em vez de um genérico “Atualizado.” Saídas de membros, por exemplo, tentam separar saiu, expulso e banido; mudanças de canal de um único campo usam um título preciso como “Tópico do Canal Alterado” em vez de “Canal Atualizado.”
Enriquecimento ciente de auditoria
Quando os registros de auditoria do servidor estão disponíveis, os registros de Moderação e Membro são enriquecidos com o ator e a razão da auditoria — assim, um registro de banimento pode mostrar *quem* o emitiu e *por que*, não apenas que aconteceu.
Configuração rápida pelo chat
Se você quiser tudo em um único canal sem abrir o painel:
!logs-setup 123456789012345678Isso ativa todas as 18 categorias e as direciona para esse canal. Desative todo o sistema com:
!logs-disableTodos os detalhes estão na página dos Comandos de Registros.
Notas & dicas
- Nada está ativado por padrão. Você escolhe quais categorias rastrear — comece pequeno e adicione mais conforme necessário.
- Categorias de alto volume. *Presença* (digitação/presença) está desativada por padrão e é melhor deixá-la desligada, a menos que você esteja depurando; também requer uma flag de ambiente de bot para emitir qualquer coisa.
- Eventos de voz de depuração permanecem silenciosos, a menos que uma flag global de opt-in esteja habilitada no ambiente do bot.
- Registros de usuários deduplicados. Uma única mudança de perfil é agrupada por guilda, mesmo que várias mensagens em cache correspondam a esse usuário, então você não receberá entradas duplicadas.
- Cache de mensagens. Para mostrar conteúdo deletado/alterado, o Netrcol mantém um curto cache em memória de mensagens recentes por servidor. Ele nunca é gravado em armazenamento permanente — veja a Política de Privacidade.
Próximos passos
- Configure-o em Painel → Registros
- Revise os Comandos de Registros
- Certifique-se de que o Netrcol tenha as permissões corretas