Activer la rotation des journaux pour Edge-router.log

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**.
info

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.

Dans Edge pour 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 Router, les fichiers suivants sont configurés avec un 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

Cependant, certains fichiers journaux des composants Apigee ne sont pas configurés avec une rotation par défaut. Sur le composant Apigee Router edge-router.log fichier 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 /opt/apigee/var/log/edge-router/edge-router.log fichier à 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 pour les 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.

  1. 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
    
  2. Ajoutez un extrait au fichier semblable à celui présenté ci-dessous :
    /opt/apigee/var/log/edge-router/edge-router.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
  3. Enregistrez les modifications.
  4. Ouvrez le crontab de l'utilisateur Apigee à l'aide de la commande suivante :
    sudo crontab -u apigee -e
    
  5. Ajoutez la tâche Cron suivante au crontab de l'utilisateur Apigee :
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
  6. Enregistrez le 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

  1. Une fois le job Cron planifié exécuté, le fichier journal sera pivoté. Dans l'exemple ci-dessus, la tâche Cron est programmée pour s'exécuter tous les jours à minuit afin de faire pivoter le fichier edge-router.log.
  2. Accédez au répertoire /opt/apigee/var/log/edge-router/ et vérifiez que le fichier edge-router.log est pivoté.

    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

    La sortie ci-dessus indique que les fichiers edge-router.log sont pivotés et enregistrés en tant que fichiers GZ.

  3. Si vous ne voyez pas que les fichiers edge-router.log sont pivotés, vérifiez que vous avez correctement suivi toutes les étapes décrites dans Activer la rotation des journaux pour edge-router.log sur le routeur. Si vous avez manqué une étape, répétez-les toutes correctement.
  4. Si vous ne parvenez toujours pas à faire fonctionner la rotation des journaux, contactez l'assistance Apigee Edge.