Sur cette page

Verifier le fichier journal

Chaque composant Mugnsoft ecrit des fichiers journaux structures avec rotation. Comprendre comment les lire est la premiere etape pour depanner tout probleme.

Emplacements des fichiers journaux

Chaque composant stocke ses journaux dans son sous-repertoire log/ :

Composant Repertoire des journaux
Webserver <webserver_install>/log/
Monitor <monitor_install>/log/
Integrator <integrator_install>/log/
Discovery Agent <discovery_agent_install>/log/

Niveaux de journalisation

Tous les composants prennent en charge ces niveaux de journalisation (du plus verbeux au moins verbeux) :

Niveau Description Quand l’utiliser
debug Flux d’execution detaille, valeurs des variables Diagnostic de problemes specifiques
info Evenements operationnels normaux (demarrage, taches planifiees) Par defaut en production
warn Problemes non critiques pouvant necessiter une attention Surveillance des problemes
error Erreurs affectant la fonctionnalite Investigation des defaillances

Modifier le niveau de journalisation

Via l’interface web : Allez dans Settings et modifiez le niveau de journalisation pour n’importe quel composant.

Via l’API : 


curl -k -X POST https://<component>:<port>/updateSetting \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"logLevel": "debug"}'

Conseil : Definissez temporairement le niveau de journalisation sur debug lors du depannage, puis restaurez-le sur info pour eviter une utilisation excessive du disque.

Rotation des journaux

Les journaux sont automatiquement soumis a une rotation selon ces parametres configurables :

Parametre Valeur par defaut Description
maxSize 10 Mo Taille maximale d’un fichier journal unique avant rotation
maxBackups 5 Nombre de fichiers journaux en rotation a conserver
maxAge 28 jours Age maximal des fichiers journaux en rotation
logCompress true Compresser les fichiers journaux en rotation (gzip)

Lire les fichiers journaux

Depuis l’interface web

  1. Naviguez vers le composant dans la vue Components
  2. Cliquez sur le bouton Live View pour voir les journaux en temps reel
  3. Cliquez sur Download Logfile pour telecharger le fichier journal complet

Depuis l’API


# Diffuser les N derniers octets du journal du serveur
curl -k -X GET https://<component>:<port>/partServerlogfile/10000 \
  -H "Authorization: Bearer <token>"

Depuis la ligne de commande

Sur le serveur ou le composant est installe :


# Linux - suivre le journal en temps reel
tail -f <install_dir>/log/*.log

# Windows - afficher le dernier journal
Get-Content <install_dir>\log\*.log -Tail 100

Motifs courants dans les journaux

Demarrage reussi

INFO  Service 'Mugnsoft...' started.
INFO  Installation directory: /opt/mugnsoft/monitor
INFO  API server listening on :8051

Echec d’authentification

ERROR Authenticator - failed authentication for user: admin

Erreur de communication entre composants

ERROR Failed to reach the webserver endpoint (192.168.1.100:8050)
ERROR selfRegister - Could not reach the webserver

Problemes de certificats

ERROR tls: failed to verify certificate
ERROR x509: certificate signed by unknown authority

Erreur de licence

FATAL ==> stopping the service/daemon since license is not valid

Voir aussi

Traductions

Authentification