Abilita la rotazione dei log per edge-router.log

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

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.

In Edge per il cloud privato, alcuni dei file di log principali su ciascuno dei componenti Apigee sono configurati con un meccanismo di rotazione predefinito.

Ad esempio, nel componente Router, i seguenti file sono configurati con un meccanismo di rotazione predefinito:

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

Tuttavia, alcuni file di log nei componenti Apigee non sono configurati con la rotazione predefinita. Il file edge-router.log del router del componente Apigee è uno di quei file per cui la rotazione dei log non è configurata per impostazione predefinita.

La rotazione dei log può essere abilitata utilizzando utilità/framework diversi come logrotate, logback o log4j. Questo documento spiega come configurare la rotazione dei log per il file /opt/apigee/var/log/edge-router/edge-router.log utilizzando logrotate e crontab.

Prima di iniziare

Abilitazione della rotazione dei log per edge-router.log sul router

Questa sezione spiega come abilitare la rotazione dei log per i /opt/apigee/var/log/edge-router/edge-router.log log sui router perimetrali.

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

  1. Apri il file /opt/apigee/edge-router/logrotate/logrotate.conf sul router in un editor. Se il file non esiste, crealo. Ad esempio:

    vi /opt/apigee/edge-router/logrotate/logrotate.conf
    
  2. Aggiungi uno snippet al file simile a quello mostrato di seguito:
    /opt/apigee/var/log/edge-router/edge-router.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 al crontab dell'utente Apigee:
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/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-router.log sul router

  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-router.log.
  2. Vai alla directory /opt/apigee/var/log/edge-router/ e verifica che il file edge-router.log sia ruotato.

    Elenco di esempio di file di log:

    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
    

    L'output riportato sopra indica che i file edge-router.log vengono ruotati e salvati come file GZ.

  3. Se non vedi che i file edge-router.log vengono ruotati, verifica di aver seguito correttamente tutti i passaggi descritti in Abilitare la rotazione dei log per edge-router.log sul router. 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.