Fichier log Matomo

Cet article présente la gestion des fichiers traces dans Matomo.

Votre avis

Nobody voted on this yet  You need to enable JavaScript to vote

Tweet

Etude

Toute la configuration de Matomo se situe dans le fichier config/config.ini.php. Les fichiers logs sont configurées dans la section log dont un exemple est fourni dans le fichier config/global.ini.php.

[log]
; possible values for log: screen, database, file
log_writers[] = screen

; log level, everything logged w/ this level or one of greater severity
; will be logged. everything else will be ignored. possible values are:
; ERROR, WARN, INFO, DEBUG
log_level = WARN

; if configured to log in a file, log entries will be made to this file
logger_file_path = tmp/logs/piwik.log

A noter que le niveau WARN n'affiche pas beaucoup de messages.

Configuration

La configuration peut être modifié dans le fichier config/config.ini.php.

Préparation environnement

L'installation initiale étant réalisée sur une machine Ubuntu, les fichiers logs vont être placés au même emplacement que les autres traces. Un répertoire piwik dans /var/log est créé.

#sudo mkdir -p /var/log/piwik
#sudo chown www-data:adm /var/log/piwik
#sudo chmod 750 /var/log/piwik

Les permissions sont accordées au compte www-data correspondant au compte du serveur web.

Paramétrage

Le fichier config/config.ini.php est alors modifié pour spécifier le fichier trace. L'objectif est d'écrire les informations dans le fichier /var/log/piwik/piwik.log avec un niveau WARN. Les éléments de configurations mis en place sont les suivants.

[log]
log_writers[] = "file"
logger_file_path = "/var/log/piwik/piwik.log"
;log_level = INFO

A noter que le paramètre log_level est commenté afin de faciliter les modifications en cas de besoin. La valeur par défaut sera récupérée depuis le fichier config/global.ini.php. Le mode est changé avec la valeur <code<file</code> pour forcer l'écriture dont l'emplacement est configuré dans le paramètre logger_file_path.

La configuration est visible dans la console d'administration de Matomo, au niveau de la section Diagnostic → Fichier de configuration. Il faut alors naviguer dans la partie log pour consulter les paramètres.

Rotation

Matomo ne fournit pas de configuration pour effectuer une rotation des fichiers traces. L'installation étant faite sur une machine Ubuntu, il est possible d'utiliser l'outil Logrotate.

Un fichier piwik est donc mis en place dans le répertoire /etc/logrotate.d, avec le contenu suivant.

/var/log/piwik/piwik.log {
    daily
    missingok
    rotate 14
    compress
    delaycompress
    notifempty
    create 640 www-data adm
}