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

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

La rotazione dei log, ovvero la procedura di rotazione di più file di log in uso e non, 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 tramite posta dei file di log.

In Edge for Private Cloud, alcuni dei file di log principali di ogni apigee componente 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 console del rispettivo componente. Nel caso del componente Message Processor, 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 dalla libreria logback, ma utilizzando logrotate e crontab.

Prima di iniziare

Attiva la rotazione dei log

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

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

Per impostazione predefinita, alcuni dei file di log principali su ciascun componente apigee sono configurati con un meccanismo di rotazione predefinito. Ad esempio, nel componente Message Processor, i seguenti file sono configurati con il 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, gli 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 apigeefile del componente Message Processoredge-message-processor.log.

La rotazione dei log può essere attivata 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.

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

Questa sezione spiega come attivare la rotazione dei log per i /opt/apigee/var/log/edge-message- processor/edge-message-processor.log log sugli Edge Message Processors.

I passaggi riportati di seguito descrivono 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 sulla macchina di Message Processor in un editor. Se il file non esiste, creane uno. 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 il 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 successiva esecuzione del job cron.

Verifica della rotazione dei log per edge-message-processor.log nel Message Processor

  1. Una volta eseguito il job cron pianificato, il file di log verrà ruotato. Nell'esempio precedente, il job cron è pianificato per essere eseguito ogni giorno alle 00:00 per eseguire la rotazione del 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 noti la rotazione dei file edge-message-processor.log, verifica di aver seguito correttamente tutti i passaggi descritti in Attivazione della rotazione dei log per edge-message-processor.log sui processori di messaggi. Se hai saltato un passaggio, ripeti tutti i passaggi correttamente.
  4. Se non riesci ancora a far funzionare la rotazione dei log, contatta l'assistenza Apigee Edge.