Outils pour utilisateurs

Outils du site


software:applications:nextcloud:serveur:logs:modifier-niveau-journalisation

Nextcloud: Modifier le niveau de journalisation

La CLI de Nextcloud (occ) permet de modifier les paramètres de l'application et, entre autre, la gestion des logs. La CLI doit être exécutée par l'utilisateur www-data.

Pour afficher la configuration actuelle de journalisation:

su --shell=/bin/sh --command="/usr/bin/php7.3 /srv/nextcloud/web/occ log:file" www-data
 
# Alternative
runuser -u www-data -- php /srv/nextcloud/web/occ log:file

Pour modifier la verbosité des logs, utiliser occ log:manage avec l'argument --level.

Les niveaux de verbosité vont de debug qui trace toutes les activités à fatal qui ne journalise que les erreurs interrompant l'exécution de l'application.

0 debug Trace toute activité. Niveau de trace le plus détaillé. inclus tous les autres niveaux
1 info Trace les principaux évènements. inclus les niveau warnings, errors, et fatal
2 warning Opérations se terminant avec avertissements. inclus les niveau error et fatal
3 error Opérations échouées mais les autre service et opérations fonctionnent inclus niveau fatal
4 fatal Erreurs conduisant à l'arrêt du serveur Nextcloud

En général on n'active le niveau debug que le temps de diagnostiquer une problématique puis on revient à un niveau beaucoup moins verbeux.

su --shell=/bin/sh --command="/usr/bin/php7.3 /srv/nextcloud/web/occ log:manage --level info" www-data
 
# Alternative
runuser -u www-data -- php /srv/nextcloud/web/occ log:manage --level info
 
# On peut utiliser indifféremment le nom du niveau de log ou le chiffre
runuser -u www-data -- php /srv/nextcloud/web/occ log:manage --level 1 
Maintenir une verbosité trop importante peu nuire aux performances du serveur.

Références

software/applications/nextcloud/serveur/logs/modifier-niveau-journalisation.txt · Dernière modification : 2026/03/06 17:04 de yoann