Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
La rotation des journaux est un mécanisme conçu pour faciliter l'administration des systèmes générant un grand nombre de fichiers journaux. Il permet la rotation, la compression, la suppression et l'envoi automatiques des fichiers journaux.
Dans Edge for Private Cloud, certains des principaux fichiers journaux de chacun des composants Apigee sont configurés avec un mécanisme de rotation par défaut.
Par exemple, sur le composant routeur, les fichiers suivants sont configurés avec le mécanisme de rotation par défaut:
/opt/apigee/var/log/edge-router/logs/system.log
/opt/apigee/var/log/edge-router/logs/events.log
/opt/apigee/var/log/edge-router/logs/startupruntimeerrors.log
/opt/apigee/var/log/edge-router/logs/configurations.log
/opt/apigee/var/log/edge-router/logs/transactions.log
Toutefois, certains fichiers journaux des composants Apigee ne sont pas configurés avec la rotation par défaut. Le fichier edge-router.log
du routeur du composant Apigee est l'un de ces fichiers pour lesquels la rotation des journaux n'est pas configurée par défaut.
La rotation des journaux peut être activée à l'aide de différents utilitaires/frameworks tels que logrotate
, logback
ou log4j
. Ce document explique comment configurer la rotation des journaux pour le fichier /opt/apigee/var/log/edge-router/edge-router.log
à l'aide de logrotate
et crontab
.
Avant de commencer
- Si vous ne connaissez pas bien les configurations
logrotate
, consultez le manuel Logrotate. - Si vous ne connaissez pas bien les configurations
crontab
, consultez le manuel crontab.
Activer la rotation des journaux pour Edge-router.log sur le routeur
Cette section explique comment activer la rotation des journaux /opt/apigee/var/log/edge-router/edge-router.log
sur les routeurs Edge.
Les étapes suivantes décrivent comment activer la rotation des journaux pour le fichier edge-router.log
.
-
Ouvrez le fichier
/opt/apigee/edge-router/logrotate/logrotate.conf
sur la machine du routeur dans un éditeur. Si le fichier n'existe pas, créez-le. Exemple :vi /opt/apigee/edge-router/logrotate/logrotate.conf
- Ajoutez au fichier un extrait semblable à celui-ci :
/opt/apigee/var/log/edge-router/edge-router.log { missingok copytruncate rotate 5 size 10M compress delaycompress notifempty nocreate sharedscripts }
- Enregistrez les modifications.
- Ouvrez le fichier
crontab
de l'utilisateur Apigee à l'aide de la commande suivante :sudo crontab -u apigee -e
- Ajoutez la tâche Cron suivante au fichier
crontab
de l'utilisateur Apigee :0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
- Enregistrez le fichier
crontab
et surveillez la rotation des journaux lors de la prochaine exécution du job Cron.
Vérifier la rotation des journaux pour Edge-router.log sur le routeur
- Une fois la tâche Cron planifiée exécutée, le fichier journal fera l'objet d'une rotation. Dans l'exemple ci-dessus, la tâche Cron est planifiée pour s'exécuter tous les jours à minuit afin d'effectuer une rotation du fichier
edge-router.log
. - Accédez au répertoire
/opt/apigee/var/log/edge-router/
et vérifiez que le fichieredge-router.log
a fait l'objet d'une rotation.Exemple de liste de fichiers journaux:
ls -ltrh | grep 'edge-router'
-rw-r--r--. 1 apigee apigee 6.0K Feb 16 00:00 edge-router.log.1.gz -rw-r--r--. 1 apigee apigee 3.0K Feb 16 01:23 edge-router.log
Le résultat ci-dessus indique que les fichiers
edge-router.log
sont alternés et enregistrés en tant que fichiers GZ. - Si la rotation des fichiers
edge-router.log
ne s'affiche pas, vérifiez que vous avez correctement suivi toutes les étapes décrites dans la section Activer la rotation des journaux pour Edge-router.log sur le routeur. Si vous avez manqué une étape, répétez-la correctement. - Si vous ne parvenez toujours pas à faire fonctionner la rotation des journaux, contactez l'assistance Apigee Edge.