Résolution de problèmes

Les logs n'apparaissent pas dans le dashboard

Vérifier la clé API

La cause la plus fréquente est une clé API incorrecte. Vérifiez que :

• La clé API configurée dans votre plugin correspond à celle de votre instance
• Il n'y a pas d'espace ou de caractère en trop dans la clé

Vérifier l'URL de l'API

Assurez-vous que l'URL de l'API dans votre plugin est correcte :

https://votre-instance.quantumlogs.cloud/logs

• Vérifiez le protocole (https:// et non http://)
• Vérifiez que l'URL se termine par /logs

Vérifier la connectivité réseau

Votre serveur de jeux doit pouvoir atteindre l'API QuantumLogs :

• Testez avec curl ou un outil similaire depuis le serveur
• Vérifiez qu'aucun pare-feu ne bloque les requêtes sortantes

Activer le mode debug

Activez le mode debug dans la configuration de votre plugin pour voir les messages d'erreur dans la console du serveur de jeux.

Vérifier le statut de l'injection

Si votre abonnement est expiré ou en erreur, l'injection peut être bloquée (BLOCK_INJECTION_SAAS=true). Vérifiez votre abonnement sur le portail de facturation.

Erreur "Mauvais rôle" à la connexion

Causes possibles

1. Pas de rôle requis : Vous n'avez pas le rôle Discord configuré dans la configuration Discord Authentication
2. Mauvais serveur Discord : Vous n'êtes pas membre du serveur Discord dont le Guild ID est configuré
3. Bot non présent : En mode Common, le bot QuantumLogs doit être invité sur votre serveur Discord
4. Configuration incorrecte : L'ID du rôle ou du serveur est incorrect

Solutions

• Staff : Demandez au propriétaire de vérifier votre rôle Discord
• Propriétaire : Vérifiez les IDs dans Administration > Extensions > Discord Authentication
• Vérifiez que le bot QuantumLogs est bien présent sur votre serveur Discord
• Voir Configuration Discord pour le guide complet

Page blanche après connexion

Vider le cache

1. Ouvrez les outils de développement du navigateur (F12)
2. Onglet Application > Storage > Clear site data
3. Rechargez la page

Token expiré

Le token JWT peut avoir expiré. Déconnectez-vous et reconnectez-vous.

Les analytics ne collectent pas de données

Vérifier que l'extension est activée

Rendez-vous dans Administration > Extensions et vérifiez que l'extension Analytics est bien activée.

Vérifier l'intégration GameDig

L'extension Analytics utilise GameDig pour interroger vos serveurs. Vérifiez que :

• L'extension GameDig est également activée
• Votre serveur de jeux est accessible depuis le backend QuantumLogs
• Le nom du jeu dans la configuration GameDig est correct (voir ci-dessous)

Vérifier les horaires d'ouverture

Si des horaires d'ouverture sont configurés, les données ne sont collectées que pendant ces horaires.

GameDig ne détecte pas mon serveur

Vérifier le nom du jeu

Le nom du jeu dans la configuration GameDig doit correspondre exactement à l'identifiant utilisé par la librairie GameDig. Les noms les plus courants :

Vérifier l'IP et le port

• L'IP doit être l'adresse publique du serveur (pas localhost ni 127.0.0.1)
• Le port doit être le port de requête du serveur (souvent le port de jeu ou port de jeu + 1)

Le statut reste "off" sur le Home

Après avoir corrigé la configuration, le statut peut mettre un certain temps à se mettre à jour car GameDig interroge les serveurs à intervalles réguliers. Attendez quelques minutes après la correction.

Plugin GMod : erreurs dans la console

"Module not found: reqwest"

Le module reqwest n'est pas installé sur votre serveur. Deux options :

1. Installez le module reqwest pour Garry's Mod
2. Installez le module DLL (recommandé)

"HTTP failed" ou timeout

• Vérifiez la connectivité réseau du serveur
• Vérifiez que l'URL de l'API est correcte
• Augmentez SEND_INTERVAL si votre serveur envoie trop de logs

Plugin Roblox : "HTTP 403"

HttpService n'est pas activé. Activez-le dans : Game Settings > Security > Allow HTTP Requests = ON

Plugin Rust : le plugin ne se charge pas

• Vérifiez que Oxide/uMod est correctement installé
• Vérifiez les logs de la console pour les erreurs de compilation
• Assurez-vous que le fichier est bien un .cs et non un .cs.txt

Les graphiques sont vides

Pas de données pour la période sélectionnée

Essayez une période plus large (30 jours au lieu de 24h).

Serveur non sélectionné

Vérifiez qu'au moins un serveur est sélectionné dans le sélecteur.

Extension non chargée

Vérifiez que l'extension correspondante (Analytics, Metrics Dashboard) est activée et chargée sans erreur.

Loading Screen : la preview ne s'affiche pas

Vérifier que l'extension est activée

Rendez-vous dans Administration > Extensions et vérifiez que l'extension GMod Loading Screen est bien activée.

Vider le cache du navigateur

Si la preview reste blanche après activation, videz le cache de votre navigateur (Ctrl+Shift+Suppr) et rechargez la page.

Loading Screen : les images ne se chargent pas

• Vérifiez que les URLs des images sont accessibles publiquement (pas derrière un login)
• Utilisez le protocole https://
• Vérifiez que le serveur hébergeant les images autorise le CORS (chargement depuis d'autres domaines)

Performance lente du dashboard

Trop de logs

Si la requête est lente (indicateur rouge "Très lent"), essayez :

• D'ajouter des filtres pour réduire les résultats
• D'utiliser le mode Infinite Scroll au lieu du mode Classic
• De réduire la plage de dates

Navigateur

• Videz le cache du navigateur
• Essayez en navigation privée
• Désactivez les extensions de navigateur qui pourraient interférer