Guide Utilisateur LogsCord

Ce document explique comment lire les logs LogsCord, quelles colonnes existent, quels types de logs sont disponibles et comment écrire des expressions de recherche.

1. Principe

LogsCord est un moteur d'audit pour Discord.

Chaque événement enregistré devient une ligne de log. Une ligne contient :

• un type (message_delete, member_role_add, voice_join, etc.) ;
• des identifiants Discord liés à l'action ;
• une date ;
• des données détaillées dans extra.

L'utilisateur peut rechercher avec :

• des filtres simples dans l'interface ;
• une expression avancée dans le mode Expression.

2. Colonnes Disponibles

À Retenir

3. Types De Logs

La liste ci-dessous correspond aux types affichables/recherchables par LogsCord côté client. Certains types peuvent dépendre des événements réellement collectés par le bot, de ses permissions Discord et des modules activés.

Modération Automatique

Messages

Vocal

Membres

Utilisateurs

Salons Et Permissions

Rôles

Serveur

Émojis Et Invitations

Logs Historiques Ou Personnalisés

Ces types existent dans le rendu client, mais peuvent provenir d'anciens imports, d'intégrations ou de données historiques.

4. Données extra Fréquentes

extra contient les détails qui changent selon le type de log.

5. Expressions De Recherche

Dans l'onglet Filtrer les logs, le mode Expression permet d'écrire une requête avancée.

Syntaxe Générale

txtchamp opérateur valeur

Exemples :

txttype == "message_delete"

txtexecutor == "123456789012345678"

txttype == "member_role_add" and target == "123456789012345678"

Valeurs

Les ensembles acceptent actuellement des chaînes.

6. Champs Utilisables Dans Les Expressions

7. Opérateurs

Aliases acceptés :

8. Fonctions Appelables

Important : is_bot() demande une vérification runtime côté serveur. Une expression qui utilise is_bot() peut être moins optimisable qu'une expression purement SQL.

roles() utilise les rôles actuels du membre sur le serveur, pas forcément les rôles historiques au moment exact du log. Pour les logs member_role_add et member_role_remove, préférer extra.roles[*].id si l'objectif est de filtrer les rôles concernés par l'action.

9. Projections Dans extra

Les projections permettent de chercher dans un tableau JSON stocké dans extra.

Syntaxe :

txtextra.<cheminDuTableau>[*]
extra.<cheminDuTableau>[*].<champ>

Exemples :

txtextra.roles[*].id in { "1483959882142060624" }

txtextra.mentions.users[*] in { "1464758198291529953" }

txtextra.roles[*].name == "Majeur"

txtextra.attachments[*].url == "https://example.com/image.png"

txtextra.audit.roles[*].meta.id in { "42" }

Règles :

Index [i]

Il est aussi possible de récupérer un élément précis avec un index numérique.

Les index commencent à 0.

txtextra.embeds[0].description == "raid"
contains(extra.embeds[0].description, "raid")
extra.content[0] == "!"

Si la valeur est un tableau, [i] récupère l'élément à l'index demandé. Si la valeur est une chaîne, [i] récupère le caractère correspondant.

10. Exemples Utiles

Messages

Rôles

Modération

Vocal

Dashboards Personnalisés

11. Priorités Et Parenthèses

L'ordre logique est :

1. parenthèses ; 2. not ; 3. comparaisons ; 4. and ; 5. or.

Utiliser des parenthèses dès qu'il y a un doute :

txt(type == "message_delete" or type == "message_edit") and executor == "123"

Sans parenthèses, une expression complexe peut être correcte techniquement mais ambiguë pour un humain.

12. Expressions Sans Filtre

Certaines expressions sont valides mais ne filtrent rien. LogsCord les nettoie avant de générer la requête SQL.

Un champ nu est converti en test d'existence :

txtextra.content

équivaut à :

txtexists(extra.content)

13. Limites Et Bonnes Pratiques

Limites techniques actuelles :

• profondeur d'expression limitée ;
• nombre de noeuds limité ;
• nombre de valeurs dans un ensemble limité ;
• longueur des regex limitée ;
• projection JSON autorisée uniquement sous extra ;
• les dashboards agrégés sont plus performants quand toute l'expression est poussée dans ClickHouse.

14. Lire Une Réponse De Recherche

Une réponse de recherche contient généralement :

Pour un utilisateur final, le plus important est result. Pour diagnostiquer une recherche lente ou incorrecte, regarder plan.residual.

15. Résumé Rapide

Expressions les plus utiles :

txttype == "message_delete"

txttype in { "message_delete", "message_edit" } and executor == "USER_ID"

txtcontains(extra.content, "discord.gg")

txttype == "member_role_add" and extra.roles[*].id in { "ROLE_ID" }

txttype in { "member_ban_add", "member_kick", "member_timeout_create" } and not is_bot(executor)