{{tag>software nextcloud log}}

====== 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:

<code bash>
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
</code>

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.

<code bash>
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 
</code>

<note>
Maintenir une verbosité trop importante peu nuire aux performances du serveur.
</note>

===== Références =====

  * [[https://docs.nextcloud.com/server/18/admin_manual/configuration_server/occ_command.html#logging-commands-label|Commandes de gestion des logs (docs.nextcloud.com) (en)]]
  * [[https://docs.nextcloud.com/server/stable/admin_manual/configuration_server/logging_configuration.html|Manuel d'administration Nextcloud : configuration de la journalisation (docs.nextcloud.com) (en)]]