LeavePulse
Documentation Owners

Diagnostics

Utilisez les diagnostics de l'Agent LeavePulse pour vérifier l'état de la passerelle, les jetons, le réseau, la whitelist et l'état de l'environnement.

Sur cette page
  1. Commandes Principales
  2. Ce que vérifie le Diagnostic
  3. 1. Passerelle et Connectivité
  4. 2. État de l'Environnement
  5. 3. Services Fonctionnels
  6. 4. Vérifications Système
  7. Suites de Diagnostic
  8. Comment lire le Rapport

Le diagnostic est le premier outil à utiliser si l'Agent est installé mais que LeavePulse ne reflète pas l'état attendu. Il transforme une plainte générale "ça ne marche pas" en un rapport détaillé avec des conseils de correction spécifiques.

Exécutez les diagnostics avant de modifier manuellement toute configuration. Le rapport ne contient pas de jetons secrets en texte clair ; les données des jetons sont résumées en statuts de sécurité.

Commandes Principales

Utilisez le préfixe correspondant à votre plateforme.

Utilisez ceci sur les builds serveur Paper, Spigot, Folia, Fabric ou NeoForge.

Export diagnostics
/leavepulse diagnostics export

Alias court : /lpa

La commande d'exportation crée un rapport JSON dans le dossier de diagnostic de l'Agent et affiche le chemin du fichier dans la console. Fournissez ce fichier au support lorsque vous demandez de l'aide.

Ce que vérifie le Diagnostic

Le diagnostic LeavePulse couvre les domaines suivants :

1. Passerelle et Connectivité

  • Client WebSocket : Si le client est initialisé et si la session est active.
  • Jeton de Passerelle : Si le jeton est présent, si sa signature est valide et s'il n'a pas expiré.
  • Accessibilité Réseau : Tests de connexion directe aux points de terminaison de l'API et de la passerelle (api.leavepulse.com, gateway.leavepulse.com).

2. État de l'Environnement

  • État d'Enrôlement : Si l'environnement du serveur est enregistré et si les clés de signature sont présentes.
  • Incohérence d'Identité : Vérification que l'Agent ne tente pas de se connecter à un serveur avec un ID différent.

3. Services Fonctionnels

  • Service Whitelist : Si l'intégration de la whitelist est active et liée à un formulaire spécifique.
  • Contrôleur de Maintenance : Si le plugin peut intercepter les événements de connexion pour le mode maintenance.
  • Relais Backend : (Proxy uniquement) Vérification du mappage des noms de serveurs backend.

4. Vérifications Système

  • Système de fichiers : Si l'Agent a les permissions d'écriture pour les dossiers de configuration et de diagnostic.
  • Planificateur : Si les tâches de fond (synchronisation, rapport de métriques) s'exécutent correctement.

Suites de Diagnostic

Vous pouvez exécuter des vérifications ciblées pour des modules spécifiques :

  • /leavepulse diagnostics suite leavepulse.network — Tests réseau uniquement.
  • /leavepulse diagnostics suite leavepulse.whitelist — Diagnostics de la whitelist uniquement.

Comment lire le Rapport

Le rapport contient un tableau de vérifications. Chaque vérification comprend :

  • id : Identifiant unique du test.
  • status : Résultat (HEALTHY, WARNING, ou UNHEALTHY).
  • message : Courte description du statut.
  • actionHint : Conseil spécifique pour résoudre le problème (ex : "reconnectez avec un nouveau code" ou "vérifiez les permissions du pare-feu").