Logging Nextcloud : quels logs existent et comment les consulter ?

Dans Nextcloud, le logging (ou jour­na­li­sa­tion) capture et documente tous les évé­ne­ments et processus per­ti­nents au sein de votre en­vi­ron­ne­ment Cloud. L’objectif est de contrôler l’état du système et de détecter ra­pi­de­ment les erreurs po­ten­tielles. L’em­pla­ce­ment de stockage des in­for­ma­tions ainsi que la manière de lire les logs Nextcloud dépendent du type de log choisi.

Qu’est-ce que le logging dans Nextcloud ?

Le logging Nextcloud désigne la collecte et la do­cu­men­ta­tion des in­for­ma­tions im­por­tantes pour le système au sein d’une instance Nextcloud. Cette fonction sert prin­ci­pa­le­ment à sur­veil­ler l’état du système et à iden­ti­fier ra­pi­de­ment les sources d’erreurs po­ten­tielles. Elle permet également de suivre les activités in­ha­bi­tuelles et les évé­ne­ments liés à la sécurité, comme les ten­ta­tives d’accès non au­to­ri­sées. Les données sont stockées dans des journaux (logs) qui peuvent être analysés par les ad­mi­nis­tra­teurs afin d’assurer le bon fonc­tion­ne­ment du Cloud ou de résoudre les problèmes.

Quels sont les niveaux de logs Nextcloud dis­po­nibles ?

Nextcloud distingue cinq niveaux de jour­na­li­sa­tion, qui indiquent dans quelle mesure les in­for­ma­tions sont con­sig­nées. Ces niveaux (levels) de log Nextcloud se pré­sen­tent comme suit :

0 - DEBUG : à ce niveau, toutes les activités sont en­re­gis­trées. Il s’agit du niveau de jour­na­li­sa­tion le plus détaillé au sein d’une instance Nextcloud. 1 - INFO : ce niveau en­re­gistre l’activité des fichiers et les con­nexions des uti­li­sa­teurs, ainsi que les aver­tis­se­ments, les erreurs et les erreurs fatales. 2 - WARN : en plus des erreurs et des erreurs fatales, le log Nextcloud de level 2 en­re­gistre uni­que­ment les opé­ra­tions réussies ayant entraîné un aver­tis­se­ment con­cer­nant des problèmes po­ten­tiels. 3 - ERROR : seules les erreurs graves et les opé­ra­tions ayant échoué sans avoir d’impact négatif sur les autres services et opé­ra­tions sont en­re­gis­trées. 4 - FATAL : dans ce cas, la jour­na­li­sa­tion n’a lieu que lorsque le serveur est arrêté.

Les pa­ra­mètres du niveau de jour­na­li­sa­tion sont définis dans le fichier config/config.php. Dans Nextcloud config.php, le niveau de jour­na­li­sa­tion par défaut est 2 (WARN). Pour diag­nos­ti­quer un problème, il est re­com­mandé d’activer le niveau DEBUG. Cependant, après l’analyse des erreurs, il convient de revenir à un niveau de jour­na­li­sa­tion moins détaillé. En effet, le mode DEBUG en­re­gistre une grande quantité d’in­for­ma­tions, ce qui peut nuire aux per­for­mances du serveur.

Quels sont les dif­fé­rents logs Nextcloud ? Où les trouver ?

Nextcloud met à dis­po­si­tion des uti­li­sa­teurs dif­fé­rents types de logs pour do­cu­men­ter les activités et les processus. Avec errorlog, file, syslog et systemd, il existe quatre options de logging dif­fé­rentes que nous allons détailler ci-dessous.

errorlog

Avec cette méthode, toutes les in­for­ma­tions du journal sont envoyées à error_log, en­re­gis­trant les erreurs dans le fichier des logs du serveur Web. L’em­pla­ce­ment dépend du choix et de la con­fi­gu­ra­tion du serveur. Ainsi, si vous utilisez Apache, vous devriez nor­ma­le­ment trouver le fichier dans le chemin /var/log/apache2/error.log. Vous pouvez toujours modifier ma­nuel­le­ment l’em­pla­ce­ment du fichier si vous le souhaitez.

file

Tous les logs Nextcloud sont stockés dans un fichier séparé, appelé par défaut nextcloud.log et situé dans le chemin d’accès /var/www/nextcloud/data/. Le nom du fichier et le format de la date peuvent être per­son­na­li­sés dans config/config.php grâce aux pa­ra­mètres logfile et logdateformat.

syslog

Toutes les in­for­ma­tions de log sont envoyées au programme daemon central du logiciel Cloud. Il s’agit d’un processus d’arrière-plan qui fonc­tionne en continu pour gérer pé­rio­di­que­ment les demandes de service ré­cur­rentes.

systemd

Avec ce type de logging Nextcloud, les journaux sont stockés dans le log systemd, qui s’occupe de la gestion des services en cours d’exécution sur le système. Pour cela, l’extension PHP php-systemd doit être installée.

Comment ouvrir les logs Nextcloud ?

Si vous utilisez le logging Nextcloud basé sur les fichiers, vous avez la pos­si­bi­lité d’accéder fa­ci­le­ment à toutes les données du log via les pa­ra­mètres d’ad­mi­nis­tra­tion (sous « Logging »). Cette fonction est fournie par l’ap­pli­ca­tion Log Reader, qui vous permet également de té­lé­char­ger les fichiers de log. Pour les autres options de logging, les logs peuvent être ouverts via un éditeur de texte et/ou une ligne de commande.

Close