Activer la rotation des journaux pour Edge-message-processor.log

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

La rotation des journaux (qui consiste à faire tourner plusieurs fichiers journaux avant et après leur utilisation) simplifie l'administration des systèmes qui génèrent un grand nombre de fichiers journaux. La rotation des journaux permet d'automatiser la rotation, la compression, la suppression et l'envoi des fichiers journaux.

Dans Edge for Private Cloud, certains des fichiers journaux principaux de chaque composant apigee sont configurés avec un mécanisme de rotation par défaut. Par exemple, dans 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 le nom commence par edge-), tels que edge-management-server, edge-router, edge-postgres-server et edge-qpid-server.

Chacun de ces composants edge-* génère également un fichier journal supplémentaire, qui est une sortie redirigée de la console du composant concerné. Dans le cas du composant "Processeur de messages", ce fichier s'appelle /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 par 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

Cette section s'applique à Edge pour Private Cloud 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 générant un grand nombre de fichiers journaux. Il 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 composants apigee 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 le 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, les autres fichiers journaux des composants apigee ne sont pas configurés avec la rotation par défaut. Par exemple, la rotation des journaux n'est pas configurée par défaut sur le fichier edge-message-processor.log du processeur de messages du composant apigee.

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 le fichier Edge-message-processor.log sur les processeurs de messages

Cette section explique comment activer la rotation des 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:

  1. Ouvrez le fichier /opt/apigee/edge-message-processor/logrotate/logrotate.conf dans un éditeur sur le processeur de messages. Si le fichier n'existe pas, créez-le. Exemple :
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    
  2. Ajoutez au fichier un extrait semblable à celui-ci :
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
    
  3. Enregistrez les modifications.
  4. Ouvrez le fichier crontab de l'utilisateur apigee à l'aide de la commande suivante :
    sudo crontab -u apigee -e
    
  5. Ajoutez la tâche Cron suivante au fichier crontab de l'utilisateur apigee :
    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
    
  6. 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 le fichier Edge-message-processor.log sur le processeur de messages

  1. 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-message- processor.log.
  2. Accédez au répertoire /opt/apigee/var/log/edge-message-processor/ et vérifiez que le fichier edge-message-processor.log a fait l'objet d'une rotation.

    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
    

    Le résultat ci-dessus indique que les fichiers edge-message-processor.log font l'objet d'une rotation et sont enregistrés au format GZ.

  3. Si la rotation des fichiers edge-message-processor.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 le fichier Edge-message-processor.log sur les processeurs de messages. Si vous avez manqué une étape, répétez-la correctement.
  4. Si vous ne parvenez toujours pas à faire fonctionner la rotation des journaux, contactez l'assistance Apigee Edge.