Paramètres de stockage des journaux de service

Par défaut, le stockage des journaux est configuré comme suit :

• Les journaux sont stockés dans le /log sous-répertoire à l'intérieur du répertoire de chacun des services backend.

• Les journaux sont stockés sous forme de fichiers texte non compressés.

• Les journaux sont conservés pendant une semaine, puis ils sont archivés (rotation) et les anciens sont supprimés.

Chacun des trois services Java backend possède ses propres journaux. Les paramètres ci-dessus peuvent être modifiés si nécessaire. Ils sont définis dans le fichier logback.xml de chaque service. Vous pouvez trouver ce fichier dans un conf répertoires des services :

• Linux : /home/java/{service-name}/conf/logback.xml

• Windows : C:\java\{service-name}\conf\logback.xml

Étant donné que ce fichier se trouve dans chacun des répertoires des services, les paramètres ci-dessous doivent être appliqués séparément pour chacun des fichiers.

Les paramètres peuvent être appliqués individuellement ou en combinaison. Sélectionnez les paramètres souhaités en fonction de vos objectifs.

Emplacement des journaux

Par défaut, les journaux sont stockés dans les dossiers des services dans le sous-répertoire log, mais pour une raison quelconque vous pouvez vouloir les stocker séparément dans un répertoire personnalisé.

Pour configurer cela, ouvrez le fichier logback.xml et trouvez les lignes suivantes :

<file>log/log.txt</file>

<fileNamePattern>log/log.%d{yyyy-MM-dd}.log</fileNamePattern>

Changez l'entrée log/ par le chemin absolu vers votre répertoire personnalisé de journaux.

Par exemple, si le répertoire est /my/directory/for/logs/, alors les lignes doivent ressembler à ceci :

<file>/my/directory/for/logs/log.txt</file>

<fileNamePattern>/my/directory/for/logs/log.%d{yyyy-MM-dd}.log</fileNamePattern>

Enregistrez le fichier et redémarrez la plateforme pour appliquer les modifications. Désormais, les journaux seront enregistrés dans le répertoire personnalisé.

Liens symboliques

Sur les systèmes Linux, il existe une autre manière de stocker les journaux dans un répertoire personnalisé. Au lieu de modifier la configuration du service, vous pouvez créer des liens symboliques vers les répertoires personnalisés souhaités. Voici comment procéder :

1. Arrêtez les services Navixy.

2. Créez de nouveaux sous-répertoires dans votre nouveau répertoire personnalisé (par ex. /my/directory/for/logs/):

mkdir -p /my/directory/for/logs/api-server/log
mkdir -p /my/directory/for/logs/sms-server/log
mkdir -p /my/directory/for/logs/tcp-server/log

1. Déplacez les journaux existants des services vers vos nouveaux répertoires :

mv /home/java/api-server/log/* /my/directory/for/logs/api-server/log/
mv /home/java/sms-server/log/* /my/directory/for/logs/sms-server/log/
mv /home/java/tcp-server/log/* /my/directory/for/logs/tcp-server/log/

1. Supprimez les anciens répertoires :

rmdir /home/java/api-server/log
rmdir /home/java/sms-server/log
rmdir /home/java/tcp-server/log

1. Créez des liens symboliques :

ln -s /my/directory/for/logs/api-server/log /home/java/api-server/log
ln -s /my/directory/for/logs/sms-server/log /home/java/sms-server/log
ln -s /my/directory/for/logs/tcp-server/log /home/java/tcp-server/log

1. Redémarrez les services.

Une fois cela fait, les journaux seront enregistrés dans vos nouveaux répertoires personnalisés.

Archivage des journaux

Sur des instances avec un grand nombre d'appareils (lorsqu'il y en a plus de quelques milliers), les journaux des services backend peuvent occuper une quantité importante d'espace disque. L'archivage des journaux des jours précédents peut être une excellente solution pour économiser de l'espace disque.

Trouvez la ligne suivante dans le fichier logback.xml :

<fileNamePattern>log/log.%d{yyyy-MM-dd}.log</fileNamePattern>

Ajoutez .gz après log, de sorte que la ligne ressemble à ceci :

<fileNamePattern>log/log.%d{yyyy-MM-dd}.log.gz</fileNamePattern>

Enregistrez le fichier et redémarrez la plateforme pour appliquer les modifications. Désormais, les fichiers journaux des jours précédents seront compressés en .gz archives, consommant beaucoup moins d'espace disque que les fichiers texte non compressés. Toutefois, le fichier log.txt du jour en cours restera non compressé car il continue d'être alimenté par la plateforme.

Durée de conservation des journaux

La durée de conservation par défaut des journaux est de 7 jours. Dans la plupart des cas, cela suffit pour tout dépannage. Cependant, vous pouvez souhaiter conserver les journaux plus longtemps ou, alternativement, raccourcir cette période. Rappelez-vous : plus la durée de conservation est longue, plus ils consomment d'espace disque, donc gérez cette valeur avec prudence.

Pour modifier la durée de conservation des journaux, trouvez la ligne suivante dans logback.xml :

<maxHistory>7</maxHistory>

Changez 7 par toute valeur souhaitée (en jours).

Enregistrez le fichier et redémarrez la plateforme pour appliquer les modifications.