Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
La rotación de registros (el proceso de rotar varios archivos de registro dentro y fuera de uso) simplifica la administración de sistemas que generan grandes cantidades de archivos de registro. La rotación de registros permite la rotación, la compresión, la eliminación y el envío automático de archivos de registro.
En Edge para la nube privada, algunos de los archivos de registro principales de cada apigee
componente se configuran con un mecanismo de rotación predeterminado. Por ejemplo, en el componente
Message Processor, los siguientes archivos se configuran con un mecanismo de rotación predeterminado
mediante 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 edge-* componentes (cuyos nombres
comienzan con edge-), como edge-management-server,
edge-router, edge-postgres-server y edge-qpid-server.
edge-* también genera un archivo de registro adicional que es un resultado redireccionado
de la consola del componente respectivo. En el caso del componente Message Processor,
este archivo se llama /opt/apigee/var/log/edge-message-processor/edge-message-processor.log.
Otros componentes edge-* generan un archivo similar. La rotación de estos archivos no se realiza con
la biblioteca logback, sino con logrotate y crontab.
Antes de comenzar
- Si no estás familiarizado con las configuraciones de
logrotate, lee el manual de logrotate. - Si no estás familiarizado con las configuraciones de
crontab, lee el manual de crontab.
Habilita la rotación de registros
Esta sección se aplica a las versiones 4.50.00 y 4.51.00 de Edge para la 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, la compresión, la eliminación y el envío automático de archivos de registro.
De forma predeterminada, algunos de los archivos de registro principales de cada uno de los componentes apigee se configuran con un
mecanismo de rotación predeterminado.
Por ejemplo, en el componente 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 los componentes apigee no se configuran con la rotación predeterminada.
Por ejemplo, la rotación de registros no se configura de forma predeterminada en el componente apigee Message
Processor file edge-message-processor.log.
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 de registros para el archivo /opt/apigee/var/log/edge-message-processor/edge-message-processor.log con logrotate y crontab.
Habilita la rotación de registros para edge-message-processor.log en Message Processors
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 los Message Processors de Edge.
En los siguientes pasos, se describe cómo habilitar la rotación de registros para el archivo
edge-message-processor.log:
- Abre el archivo
/opt/apigee/edge-message-processor/logrotate/logrotate.confen la máquina Message Processor en un editor. Si el archivo no existe, créalo. Por ejemplo:vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
- 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 }
- Guarda los cambios.
- Abre el
crontabdel usuarioapigeecon el siguiente comando:sudo crontab -u apigee -e
- Agrega el siguiente trabajo cron al
crontabdel usuarioapigee: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
- Guarda el
crontaby supervisa la rotación de registros durante la próxima ejecución del trabajo cron.
Verifica la rotación de registros para edge-message-processor.log en Message Processor
- 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 para rotar el archivo
edge-message- processor.log. -
Navega al directorio
/opt/apigee/var/log/edge-message-processor/y verifica que se rote el archivoedge-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.logse rotan y se guardan como un archivo GZ. - Si no ves que se rotan 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 Processors. Si omitiste algún paso, repite todos los pasos correctamente. - Si aún no puedes hacer que funcione la rotación de registros, comunícate con el equipo de asistencia de Apigee Edge.