Abilita la rotazione dei log per edge-message-processor.log

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

La rotazione dei log, ovvero il processo di rotazione di più file di log in entrata e in uscita dall'uso, semplifica l'amministrazione dei sistemi che generano un numero elevato di file di log. La rotazione log consente la rotazione, la compressione, la rimozione e l'invio automatici dei file di log.

In Edge per Private Cloud, alcuni dei principali file di log di ogni apigee componente sono configurati con un meccanismo di rotazione predefinito. Ad esempio, nel componente processore di messaggi, i seguenti file sono configurati con un meccanismo di rotazione predefinito utilizzando 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

Esistono file simili per altri edge-* componenti (i cui nomi iniziano con edge-), come edge-management-server, edge-router, edge-postgres-server e edge-qpid-server.

Ognuno di questi componenti edge-* genera anche un file di log aggiuntivo che è un output reindirizzato della console del componente corrispondente. Nel caso del componente processore di messaggi, questo file si chiama /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Altri componenti edge-* generano un file simile. La rotazione di questi file non viene eseguita da la libreria logback, ma utilizzando logrotate e crontab.

Prima di iniziare

Abilitare la rotazione dei log

Questa sezione si applica alle versioni 4.50.00 e 4.51.00 di Edge per Private Cloud.

La rotazione log è un meccanismo progettato per semplificare l'amministrazione dei sistemi che generano un numero elevato di file di log. Consente la rotazione, la compressione, la rimozione e l'invio automatici dei file di log.

Per impostazione predefinita, alcuni dei principali file di log di ogni componente apigee sono configurati con un meccanismo di rotazione predefinito. Ad esempio, nel componente processore di messaggi, i seguenti file sono configurati con un meccanismo di rotazione predefinito:

  • /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

Tuttavia, altri file di log nei componenti apigee non sono configurati con la rotazione predefinita. Ad esempio, la rotazione dei log non è configurata per impostazione predefinita nel file edge-message-processor.log del componente Message Processor apigee.

La rotazione dei log può essere abilitata utilizzando diverse utilità/framework come logrotate, logback, o log4j. Questa sezione spiega come configurare la rotazione dei log per il file /opt/apigee/var/log/edge-message-processor/edge-message-processor.log utilizzando logrotate e crontab.

Abilitare la rotazione dei log per edge-message-processor.log nei Message Processor

Questa sezione spiega come abilitare la rotazione dei log /opt/apigee/var/log/edge-message- processor/edge-message-processor.log nei Message Processor Edge.

I passaggi seguenti descrivono come abilitare la rotazione dei log per edge-message-processor.log file:

  1. Apri il file /opt/apigee/edge-message-processor/logrotate/logrotate.conf sulla macchina processore di messaggi in un editor. Se il file non esiste, crealo. Ad esempio:
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    
  2. Aggiungi al file uno snippet simile a quello mostrato di seguito:
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
  3. Salva le modifiche.
  4. Apri crontab dell'utente apigee utilizzando il seguente comando:
    sudo crontab -u apigee -e
    
  5. Aggiungi il seguente cron job a crontab dell'utente 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. Salva crontab e monitora la rotazione dei log durante la prossima esecuzione del cron job.

Verificare la rotazione dei log per edge-message-processor.log nel Message Processor

  1. Una volta eseguito il cron job pianificato, il file di log verrà ruotato. Nell'esempio precedente, il cron job è pianificato per essere eseguito ogni giorno alle 00:00 per ruotare il file edge-message- processor.log.
  2. Vai alla directory /opt/apigee/var/log/edge-message-processor/ e verifica che il file edge-message-processor.log sia ruotato.

    Esempio di elenco di file di log

    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

    L'output precedente indica che i file edge-message-processor.log vengono ruotati e salvati come file GZ.

  3. Se non vedi la rotazione dei file edge-message-processor.log, verifica di aver seguito correttamente tutti i passaggi descritti in Abilitare la rotazione dei log per edge-message-processor.log nei Message Processor. Se hai saltato un passaggio, ripeti correttamente tutti i passaggi.
  4. Se non riesci ancora a far funzionare la rotazione dei log, contatta l'assistenza Apigee Edge.