Lorsque vous dépanner des problèmes ou des erreurs avec Discourse, il est important de consulter vos journaux (logs). Voici une liste de leur emplacement et de leur contenu.
Domaine de votre site
Journaux d’administration affichés dans l’interface utilisateur
Le panneau d’administration de Discourse contient plusieurs formes de journalisation :
- Les e-mails envoyés, ignorés, en échec de distribution, reçus et rejetés sont consignés à l’adresse https://=DOMAIN=/admin/email-logs et dans les onglets voisins.
- Les actions du personnel sont consignées à l’adresse https://=DOMAIN=/admin/logs/staff_action_logs
- Les adresses e-mail et les adresses IP qui ont été bannies de l’inscription seront listées à https://=DOMAIN=/admin/logs/screened_emails et https://=DOMAIN=/admin/logs/screened_ip_addresses
- Les liens publiés par des comptes bannis en tant que spammeurs sont listés à https://=DOMAIN=/admin/logs/screened_urls
- Les journaux d’analyse de recherche sont affichés à l’adresse https://=DOMAIN=/admin/logs/search_logs
L’interface utilisateur web de Logster
Chaque instance de Discourse est livrée avec une visionneuse de journaux graphique (GUI). Elle est située à : https://=DOMAIN=/logs
Remarque : si vous êtes sur un forfait hébergé, cette page peut vous être masquée. Contactez plutôt le support lorsque vous rencontrez ce type de problème !
Si vous enquêtez sur une mystérieuse erreur 500 sur les forums, vous devriez toujours essayer cet endroit en premier !
Sélectionnez une ligne d’erreur pour obtenir des détails à son sujet. Il pourrait vous être demandé de fournir le contenu des onglets env et backtrace ici sur Meta.
Les journaux Rails / Pitchfork
Ruby on Rails contient un journal très verbeux qui est écrit sur le disque. De plus, le serveur web pitchfork (un fork de unicorn) écrit également sur le disque.
Pour y accéder :
cd /var/discourse
./launcher enter app
cd /shared/log/rails
Ce dossier contient “production.log” et “unicorn.stderr.log” en plus des fichiers journaux “rotatifs” (rotated). Vous pouvez utiliser des outils Unix standard tels que less production.log pour les inspecter.
Ce dossier est également disponible sans entrer dans le conteneur à l’adresse /var/discourse/shared/standalone/log/rails.
Les journaux NGINX
Occasionnellement, les journaux NGINX peuvent contenir quelques astuces supplémentaires ; ils sont situés à :
cd /var/discourse
./launcher enter app
cd /var/log/nginx
Les fichiers access.log et error.log s’y trouveront, ainsi qu’un certain nombre de fichiers compressés et archivés. L’exécution de less access.log.2.gz décompressera et affichera automatiquement le fichier journal pour vous.
Ce répertoire est également disponible sur l’hôte à l’adresse /var/discourse/shared/standalone/log/var-log/nginx.
Journaux Redis
Bien qu’il soit très rare de devoir consulter les journaux Redis, si vous en avez besoin, ils se trouvent dans /var/log/redis à l’intérieur du conteneur et dans /var/discourse/shared/standalone/log/var-log/redis sur l’hôte. Les entrées de journal les plus récentes se trouvent dans le fichier current de ce répertoire.
Journaux PostgreSQL
Si vous avez besoin de consulter les journaux du serveur de base de données, ils se trouvent dans /var/log/postgres à l’intérieur du conteneur et dans /var/discourse/shared/standalone/log/var-log/postgres sur l’hôte ; les entrées les plus récentes se trouvent dans le fichier current de ce répertoire.