Vous consultez la documentation Apigee Edge.
Accédez à la
documentation Apigee X. info
La rotation des journaux (processus de rotation de plusieurs fichiers journaux) simplifie l'administration des systèmes qui génèrent un grand nombre de fichiers journaux. La rotation des journaux permet la rotation, la compression, la suppression et l'envoi automatiques des fichiers journaux.
Dans Edge pour le cloud privé, certains des principaux fichiers journaux de chaque apigee
composant sont configurés avec un mécanisme de rotation par défaut. Par exemple, sur le composant Processeur de messages, les fichiers suivants sont configurés avec un mécanisme de rotation par défaut à l'aide de logback :
/opt/apigee/var/log/edge-message-processor/logs/system.log/opt/apigee/var/log/edge-message-processor/logs/events.log/opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log/opt/apigee/var/log/edge-message-processor/logs/configurations.log/opt/apigee/var/log/edge-message-processor/logs/transactions.log
Des fichiers similaires existent pour d'autres composants edge-* (dont les noms
commencent par edge-), tels que edge-management-server,
edge-router, edge-postgres-server et edge-qpid-server.
edge-* génère également un fichier journal supplémentaire qui est une sortie redirigée
de la console du composant respectif. Dans le cas du composant Message Processor,
ce fichier est appelé /opt/apigee/var/log/edge-message-processor/edge-message-processor.log.
D'autres composants edge-* génèrent un fichier similaire. La rotation de ces fichiers n'est pas effectuée par
la bibliothèque logback, mais plutôt à l'aide de logrotate et crontab.
Avant de commencer
- Si vous ne connaissez pas bien les
logrotateconfigurations, consultez le manuel logrotate. - Si vous ne connaissez pas bien les configurations
crontab, consultez le manuel crontab.
Activer la rotation des journaux
Cette section s'applique à Edge pour le cloud privé versions 4.50.00 et 4.51.00.
La rotation des journaux est un mécanisme conçu pour faciliter l'administration des systèmes qui génèrent un grand nombre de fichiers journaux. Elle permet la rotation, la compression, la suppression et l'envoi automatiques des fichiers journaux.
Par défaut, certains des principaux fichiers journaux de chacun des apigee composants sont configurés avec un
mécanisme de rotation par défaut.
Par exemple, sur le composant Processeur de messages, les fichiers suivants sont configurés avec un mécanisme de rotation par défaut :
/opt/apigee/var/log/edge-message-processor/logs/system.log/opt/apigee/var/log/edge-message-processor/logs/events.log/opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log/opt/apigee/var/log/edge-message-processor/logs/configurations.log/opt/apigee/var/log/edge-message-processor/logs/transactions.log
Toutefois, d'autres fichiers journaux des composants apigee ne sont pas configurés avec une rotation par défaut.
Par exemple, la rotation des journaux n'est pas configurée par défaut sur le composant apigee Message
Processor file edge-message-processor.log.
La rotation des journaux peut être activée à l'aide de différents utilitaires/frameworks tels que logrotate,
logback, ou log4j. Cette section explique comment configurer la rotation des journaux pour le fichier /opt/apigee/var/log/edge-message-processor/edge-message-processor.log
à l'aide de logrotate et crontab.
Activer la rotation des journaux pour edge-message-processor.log sur les processeurs de messages
Cette section explique comment activer la rotation des journaux pour les journaux /opt/apigee/var/log/edge-message-
processor/edge-message-processor.log sur les processeurs de messages Edge.
Les étapes suivantes décrivent comment activer la rotation des journaux pour le fichier
edge-message-processor.log :
- Ouvrez le fichier
/opt/apigee/edge-message-processor/logrotate/logrotate.confsur la machine du processeur de messages dans un éditeur. Si le fichier n'existe pas, créez-le. Exemple :vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
- Ajoutez un extrait au fichier semblable à celui présenté ci-dessous :
/opt/apigee/var/log/edge-message-processor/edge-message-processor.log { missingok copytruncate rotate 5 size 10M compress delaycompress notifempty nocreate sharedscripts }
- Enregistrez les modifications.
- Ouvrez le
crontabde l'utilisateurapigeeà l'aide de la commande suivante :sudo crontab -u apigee -e
- Ajoutez le job Cron suivant au
crontabde l'utilisateurapigee:0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -s /opt/apigee/var/run/edge-message-processor/logrotate.status -f /opt/apigee/edge-message-processor/logrotate/logrotate.conf
- Enregistrez le
crontabet surveillez la rotation des journaux lors de la prochaine exécution du job Cron.
Vérifier la rotation des journaux pour edge-message-processor.log sur le processeur de messages
- Une fois le job Cron planifié exécuté, le fichier journal sera tourné. Dans l'exemple ci-dessus,
la tâche Cron est programmée pour s'exécuter tous les jours à 00h00 afin de faire tourner le fichier
edge-message- processor.log. -
Accédez au répertoire
/opt/apigee/var/log/edge-message-processor/et vérifiez que le fichieredge-message-processor.logest tourné.Exemple de liste de fichiers journaux
ls -ltrh | grep 'edge-message-processor'
-rw-r--r--. 1 apigee apigee 17K Feb 7 00:00 edge-message-processor.log.1.gz -rw-r--r--. 1 apigee apigee 5.3K Feb 7 09:12 edge-message-processor.log
La sortie ci-dessus indique que les
edge-message-processor.logfichiers sont tournés et enregistrés en tant que fichier GZ. - Si vous ne voyez pas que les fichiers
edge-message-processor.logsont tournés, vérifiez que vous avez correctement suivi toutes les étapes décrites dans Activer la rotation des journaux pour edge-message-processor.log sur les processeurs de messages correctement. Si vous avez manqué une étape, répétez-les toutes correctement. - Si vous ne parvenez toujours pas à faire fonctionner la rotation des journaux, contactez l'assistance Apigee Edge.