Habilita la rotación de registros para Edge-router.log

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

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.

En Edge para la nube privada, algunos de los archivos de registro principales en cada uno de los componentes de Apigee se configuran con un mecanismo de rotación predeterminado.

Por ejemplo, en el componente Router, los siguientes archivos están configurados con un mecanismo de rotación predeterminado:

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

Sin embargo, hay ciertos archivos de registro en los componentes de Apigee que no están configurados con la rotación predeterminada. En el archivo edge-router.log del router del componente de Apigee es uno de esos archivos para los que la rotación de registros no está configurada de forma predeterminada.

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

Antes de comenzar

Habilita la rotación del registro para Edge-router.log en el router

En esta sección, se explica cómo habilitar la rotación de registros para los registros /opt/apigee/var/log/edge-router/edge-router.log en los routers perimetrales.

En los siguientes pasos, se describe cómo habilitar la rotación de registros para el archivo edge-router.log.

  1. Abre el archivo /opt/apigee/edge-router/logrotate/logrotate.conf en la máquina del router con un editor. Si el archivo no existe, créalo. Por ejemplo:

    vi /opt/apigee/edge-router/logrotate/logrotate.conf
    
  2. Agrega un fragmento al archivo similar al que se muestra a continuación:
    /opt/apigee/var/log/edge-router/edge-router.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
    
  3. Guarda los cambios.
  4. Abre el crontab del usuario de Apigee con el siguiente comando:
    sudo crontab -u apigee -e
    
  5. Agrega el siguiente trabajo cron al crontab del usuario de Apigee:
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/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 para Edge-router.log en el router

  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-router.log.
  2. Navega al directorio /opt/apigee/var/log/edge-router/ y verifica que se haya rotado el archivo edge-router.log.

    Lista de muestra de archivos de registro:

    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
    

    El resultado anterior indica que los archivos edge-router.log se rotan y guardan como archivos GZ.

  3. Si no ves que los archivos edge-router.log se están rotando, verifica si seguiste todos los pasos descritos en Habilita la rotación de registros para Edge-router.log en el router de forma correcta. Si omitiste algún paso, repite todos los pasos de nuevo de forma correcta.
  4. Si aún no puedes hacer que funcione la rotación del registro, comunícate con el equipo de asistencia de Apigee Edge.