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

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

La rotazione dei log, ossia il processo di rotazione di più file di log dentro e fuori uso, semplifica l'amministrazione dei sistemi che generano un numero elevato di file di log. La rotazione dei log consente la rotazione, la compressione, la rimozione e l'invio automatici dei file di log.

In Edge per il cloud privato, alcuni dei file di log principali di ciascun componente apigee sono configurati con un meccanismo di rotazione predefinito. Ad esempio, nel componente Message Processor, 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 componenti edge-* (i cui nomi iniziano con edge-), come edge-management-server, edge-router, edge-postgres-server e edge-qpid-server.

Ciascuno di questi componenti edge-* genera anche un file di log aggiuntivo che è un output reindirizzato della rispettiva console del componente. Nel caso del componente Message Processor, questo file è chiamato /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 dalla libreria di logback, ma piuttosto dall'utilizzo di logrotate e crontab.

Prima di iniziare

• Se non hai dimestichezza con le configurazioni di logrotate, leggi il manuale di Logrotate.
• Se non hai dimestichezza con le configurazioni di crontab, leggi il manuale di crontab.

Abilita rotazione log

Questa sezione si applica a Edge per Cloud privato versioni 4.50.00 e 4.51.00.

La rotazione dei 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 file di log principali in ciascuno dei componenti apigee sono configurati con un meccanismo di rotazione predefinito. Ad esempio, nel componente Message Processor, 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 di apigee non sono configurati con la rotazione predefinita. Ad esempio, la rotazione dei log non è configurata per impostazione predefinita nel file del processore dei messaggi dei componenti apigee edge-message-processor.log.

La rotazione dei log può essere abilitata utilizzando utilità/framework diversi 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.

Abilitazione della rotazione dei log per edge-message-processor.log sui processori di messaggi

Questa sezione spiega come abilitare la rotazione dei log per i /opt/apigee/var/log/edge-message- processor/edge-message-processor.log log sui processori di messaggi Edge.

I passaggi seguenti spiegano come attivare la rotazione dei log per il file edge-message-processor.log:

1. Apri il file /opt/apigee/edge-message-processor/logrotate/logrotate.conf nel computer del 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 uno snippet al file 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 il crontab dell'utente apigee utilizzando il seguente comando:

   sudo crontab -u apigee -e
   

5. Aggiungi il seguente cron job al 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 l'elemento crontab e monitora la rotazione dei log alla successiva esecuzione del cron job.

Verifica della rotazione dei log per edge-message-processor.log nel processore di messaggi

1. Una volta eseguito il cron job pianificato, il file di log verrà ruotato. Dall'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.

   Elenco di esempio 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 riportato sopra indica che i file edge-message-processor.log vengono ruotati e salvati come file GZ.

3. Se non vedi che i file edge-message-processor.log vengono ruotati, verifica di aver seguito correttamente tutti i passaggi descritti in Abilitare la rotazione dei log per edge-message-processor.log sui processori di messaggi. Se hai saltato qualche passaggio, ripeti correttamente tutti i passaggi.
4. Se ancora non riesci a far funzionare la rotazione dei log, contatta l'assistenza Apigee Edge.