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

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X.
En savoir plus

<ph type="x-smartling-placeholder">

La rotation des journaux, qui désigne la rotation de plusieurs fichiers journaux pour qu'ils soient utilisés ou non : simplifie l'administration des systèmes qui générer un grand nombre de fichiers journaux. La rotation des journaux active la rotation, la compression la suppression et l’envoi des fichiers journaux.

Dans Edge pour Private Cloud, certains des principaux fichiers journaux sur chaque apigee sont configurés avec un mécanisme de rotation par défaut. Par exemple, sur la page Processeur de messages : les fichiers suivants sont configurés avec une 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 commencer par edge-, par exemple 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 redirection sortie de la console du composant respectif. Dans le cas du composant de traitement des messages, ce fichier s'appelle /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Les autres composants edge-* génèrent un fichier similaire. Ces fichiers ne sont pas effectuées par la bibliothèque Logback, mais avec logrotate et crontab.

Avant de commencer

  • Si vous ne connaissez pas les configurations logrotate, consultez le logrotate manuel.
  • Si vous ne connaissez pas les configurations crontab, consultez le manuel crontab.

Activer la rotation des journaux

Cette section s'applique à Edge for 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 qui génèrent un grand nombre de fichiers journaux. Il permet la rotation, la compression, la suppression et l'envoi automatiques 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 mécanisme de rotation:

  • /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 composant apigee Message Fichier de processeur edge-message-processor.log.

Vous pouvez activer la rotation des journaux à l'aide de différents utilitaires/frameworks tels que logrotate, logback ou log4j. Cette section explique comment configurer les journaux rotation pour /opt/apigee/var/log/edge-message-processor/edge-message-processor.log à l'aide de logrotate et crontab.

Activation de la rotation des journaux pour 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 périphériques.

<ph type="x-smartling-placeholder">

Les étapes suivantes décrivent comment activer la rotation des journaux pour Fichier edge-message-processor.log:

  1. Ouvrir le fichier /opt/apigee/edge-message-processor/logrotate/logrotate.conf sur la machine de traitement des messages dans un éditeur. 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 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
        }
    
    <ph type="x-smartling-placeholder">
  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
    
    <ph type="x-smartling-placeholder">
  6. Enregistrez le crontab et surveillez la rotation des journaux lors de la prochaine exécution de la tâche Cron.

Vérifier la rotation des journaux pour Edge-message-processor.log sur le processeur de messages

  1. Une fois la tâche Cron planifiée exécutée, le fichier journal est alterné. Dans l'exemple ci-dessus, tâche Cron est programmée pour s'exécuter tous les jours à minuit pour alterner le 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 bien 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 edge-message-processor.log les fichiers sont pivotés et enregistrés en tant que fichier GZ.

  3. Si vous ne voyez pas la rotation des fichiers edge-message-processor.log, Vérifiez ensuite que vous avez suivi toutes les étapes décrites dans <ph type="x-smartling-placeholder"></ph> Activation correcte de la rotation des journaux pour Edge-message-processor.log sur les processeurs de messages. Si vous avez manqué une étape, répétez toutes les étapes correctement.
  4. Si vous ne parvenez toujours pas à faire fonctionner la rotation des journaux, contactez l'assistance Apigee Edge.