Habilitar la rotación de registros para Edge-message-processor.log

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

La rotación de registros, el proceso de rotar varios archivos de registro hacia adentro y fuera de su uso, simplifica la administración de sistemas que generan una gran cantidad de archivos de registro. La rotación de registros permite la rotación, compresión, eliminación y envío automáticos de los archivos de registro.

En Edge para nube privada, algunos de los archivos de registro principales en cada componente apigee se configuran con un mecanismo de rotación predeterminado. Por ejemplo, en el componente de Message Processor, los siguientes archivos se configuran con un mecanismo de rotación predeterminado que usa 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

Existen archivos similares para otros componentes de edge-* (cuyos nombres comienzan con edge-), como edge-management-server, edge-router, edge-postgres-server y edge-qpid-server.

Cada uno de estos componentes de edge-* también genera un archivo de registro adicional que es un resultado redireccionado de la consola del componente correspondiente. En el caso del componente de Message Processor, este archivo se llama /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Otros componentes de edge-* generan un archivo similar. La biblioteca de Logback no realiza la rotación de estos archivos, sino mediante logrotate y crontab.

Antes de comenzar

Habilitar la rotación del registro

Esta sección se aplica a las versiones 4.50.00 y 4.51.00 de Edge para nube privada.

La rotación de registros es un mecanismo diseñado para facilitar la administración de sistemas que generan grandes cantidades de archivos de registro. Permite la rotación, compresión, la eliminación y el envío automáticos de los archivos de registro.

De forma predeterminada, algunos de los archivos de registro principales en cada uno de los componentes de apigee están configurados con un mecanismo de rotación predeterminado. Por ejemplo, en el componente de Message Processor, los siguientes archivos se configuran con un mecanismo de rotación predeterminado:

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

Sin embargo, otros archivos de registro en componentes apigee no están configurados con la rotación predeterminada. Por ejemplo, la rotación del registro no está configurada de forma predeterminada en el archivo edge-message-processor.log de Message Processor del componente apigee.

La rotación de registros se puede habilitar con diferentes utilidades o frameworks, como logrotate, logback o log4j. En esta sección, se explica cómo configurar la rotación del registro para el archivo /opt/apigee/var/log/edge-message-processor/edge-message-processor.log con logrotate y crontab.

Habilita la rotación del registro para Edge-message-processor.log en Message Processor

En esta sección, se explica cómo habilitar la rotación de registros para los registros /opt/apigee/var/log/edge-message- processor/edge-message-processor.log en Edge Message Processor.

En los siguientes pasos, se describe cómo habilitar la rotación del registro para el archivo edge-message-processor.log:

  1. Abre el archivo /opt/apigee/edge-message-processor/logrotate/logrotate.conf en la máquina de Message Processor en un editor. Si el archivo no existe, créalo. Por ejemplo:
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    
  2. Agrega un fragmento al archivo similar al que se muestra a continuación:
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
    
  3. Guarda los cambios.
  4. Abre el archivo crontab del usuario de apigee con el siguiente comando:
    sudo crontab -u apigee -e
    
  5. Agrega el siguiente trabajo cron al crontab del usuario 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. Guarda el crontab y supervisa la rotación del registro durante la próxima ejecución del trabajo cron.

Verifica la rotación del registro de Edge-message-processor.log en el procesador de mensajes

  1. Una vez que se ejecute el trabajo cron programado, se rotará el archivo de registro. En el ejemplo anterior, el trabajo cron está programado para ejecutarse todos los días a las 00:00 a.m. con el fin de rotar el archivo edge-message- processor.log.
  2. Navega al directorio /opt/apigee/var/log/edge-message-processor/ y verifica que se haya rotado el archivo edge-message-processor.log.

    Ejemplo de lista de archivos de registro

    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
    

    El resultado anterior indica que los archivos edge-message-processor.log se rotan y guardan como un archivo GZ.

  3. Si no ves que se están rotando los archivos edge-message-processor.log, verifica que hayas seguido correctamente todos los pasos descritos en Habilita la rotación de registros para Edge-message-processor.log en Message Processor. Si omitiste algún paso, repite todos los pasos correctamente.
  4. Si aún no puedes hacer que la rotación del registro funcione, comunícate con el equipo de asistencia de Apigee Edge.