Système de Journalisation
Suivez tout ce qui se passe sur votre serveur avec 55 types d'événements organisés en 18 catégories, un routage par canal par catégorie, et des couleurs d'intégration personnalisées — le tout configuré depuis le tableau de bord.
Topics: logs, logging, audit, events, tracking
Suivez tout ce qui se passe sur votre serveur avec 55 types d'événements organisés en 18 catégories, un routage par canal par catégorie, et des couleurs d'intégration personnalisées — le tout configuré depuis le tableau de bord.
Aperçu
Le système de journalisation enregistre les événements du serveur et publie des intégrations détaillées dans les canaux que vous choisissez. C'est la colonne vertébrale de la responsabilité en matière de modération et de visibilité générale : qui a rejoint, ce qui a été supprimé, quels rôles ont changé, qui a été banni, et bien plus encore.
Tout est configuré depuis Tableau de bord → Journaux. Rien n'est activé par défaut — vous décidez exactement quelles catégories suivre et où chacune d'elles est envoyée. Pour un raccourci en une commande qui active tout dans un seul canal, consultez les commandes de journaux.
Activation et configuration de base
- Ouvrez Tableau de bord → Journaux pour votre serveur.
- Activez Actif dans l'en-tête de la page pour activer le système.
- Utilisez le sélecteur Canal de journalisation global dans l'en-tête pour envoyer *toutes* les catégories dans un seul canal — le moyen le plus rapide de commencer.
- Ou développez n'importe quelle catégorie ci-dessous pour lui donner son propre canal et l'activer.
Astuce : Netrcol a besoin des permissions Voir le canal, Envoyer des messages, Intégrer des liens, et Lire l'historique des messages dans chaque canal que vous journalisez. Le vérificateur de santé de configuration sur la page vous avertira si une permission est manquante.
Canaux par catégorie
Chaque catégorie est une ligne extensible avec son propre sélecteur de canal et interrupteur on/off. Cela vous permet de répartir vos journaux sur plusieurs canaux — par exemple, les journaux de modération dans un canal privé pour le personnel, et les journaux d'entrée/sortie dans un canal public.
Si chaque catégorie pointe vers le même canal, le sélecteur Canal de journalisation global affiche ce canal ; s'ils diffèrent, il affiche *“Les canaux diffèrent.”* Le redéfinir renvoie tout vers un seul canal.
Couleurs d'intégration
Chaque événement a une bande de couleur que vous pouvez personnaliser. Ouvrez une catégorie, et chaque ligne d'événement a un échantillon de couleur — pratique pour distinguer les catégories d'un coup d'œil (par exemple, rouge pour la modération, vert pour les entrées).
Catégories de journaux
Netrcol regroupe ses 55 types d'événements en ces 18 catégories :
| Catégorie | Ce qu'elle journalise |
|---|---|
| Bot | Journaux d'interaction avec le bot et de cycle de vie de la guilde |
| Modération | Journaux de bannissement, de débanissement, d'automod et d'actions du personnel |
| Message | Journaux de suppression, d'édition et de suppression en masse de messages lisibles |
| Réaction | Activité d'ajout et de suppression d'émojis |
| Membre | Entrées, départs, mises à jour de rôles, changements de surnoms et mises en attente |
| Canal | Journaux de création, suppression, renommage, sujet et changements de catégorie de canal |
| Rôle | Journaux de création, mise à jour et suppression de rôles |
| Vocal | Changements d'état vocal (les événements vocaux de débogage nécessitent un drapeau d'opt-in) |
| Invitation | Journaux de création et de suppression d'invitations |
| Serveur | Changements de paramètres, de nom et de structure du serveur |
| Actif | Journaux de mise à jour d'émojis et d'autocollants |
| Webhook | Événements de mise à jour de webhook |
| Sécurité | Journaux d'activités risquées et de protection du système |
| Intégration | Événements de mise à jour d'intégration de guilde |
| Événement planifié | Journaux de création, mise à jour et suppression d'événements planifiés |
| Message épinglé | Journaux de mise à jour d'épingles de canal |
| Présence | Journaux de saisie et de présence (opt-in, volume élevé) |
| Utilisateur | Changements de profil utilisateur, affichés une fois par guilde concernée |
Titres intelligents
Certaines catégories utilisent des titres plus clairs et spécifiques au lieu d'un générique “Mis à jour.” Les départs de membres, par exemple, essaient de séparer quitté, expulsé, et banni ; les changements de canal à un seul champ utilisent un titre précis comme “Sujet du canal changé” plutôt que “Canal mis à jour.”
Enrichissement conscient de l'audit
Lorsque les journaux d'audit du serveur sont disponibles, les journaux de Modération et de Membre sont enrichis avec l'acteur et le motif de l'audit — ainsi, un journal de bannissement peut montrer *qui* l'a émis et *pourquoi*, et pas seulement qu'il a eu lieu.
Configuration rapide depuis le chat
Si vous souhaitez simplement tout dans un seul canal sans ouvrir le tableau de bord :
!logs-setup 123456789012345678Cela active toutes les 18 catégories et les dirige vers ce canal. Désactivez tout le système avec :
!logs-disableTous les détails se trouvent sur la page des commandes de journaux.
Notes et astuces
- Rien n'est activé par défaut. Vous choisissez quelles catégories suivre — commencez petit et ajoutez-en plus si nécessaire.
- Catégories à fort volume. *Présence* (saisie/présence) est désactivé par défaut et est mieux laissé désactivé à moins que vous ne soyez en débogage ; il nécessite également un drapeau d'environnement de bot pour émettre quoi que ce soit.
- Les événements vocaux de débogage restent silencieux à moins qu'un drapeau d'opt-in global ne soit activé dans l'environnement du bot.
- Journaux d'utilisateur dédupliqués. Un seul changement de profil est regroupé par guilde, même si plusieurs messages mis en cache correspondent à cet utilisateur, vous ne recevrez donc pas d'entrées en double.
- Cache de messages. Pour afficher le contenu supprimé/édité, Netrcol conserve un court cache en mémoire des messages récents par serveur. Il n'est jamais écrit dans un stockage permanent — voir la Politique de confidentialité.
Étapes suivantes
- Configurez-le sur Tableau de bord → Journaux
- Consultez les commandes de journaux
- Assurez-vous que Netrcol a les bonnes permissions