Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
La rotación de registros, el proceso de rotar varios archivos de registro para usarlos o no, simplifica la administración de sistemas que generan grandes cantidades de archivos de registro. La rotación de registros habilita la rotación, compresión, eliminación y envío automáticos de archivos de registro.
En Edge para la nube privada, algunos de los archivos de registro principales de cada componente 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 con 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 edge-* (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 correspondiente. 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 biblioteca de logback no realiza la rotación de estos archivos, sino que usa logrotate y crontab.
Antes de comenzar
- Si no estás familiarizado con la configuración de
logrotate, lee el manual de logrotate. - Si no estás familiarizado con las configuraciones de
crontab, consulta 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, compresión, eliminación y envío automáticos de archivos de registro.
De forma predeterminada, algunos de los archivos de registro principales de cada uno de los componentes de apigee se configuran con un mecanismo de rotación predeterminado.
Por ejemplo, en el componente Message Processor, los siguientes archivos se configuran con el 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 están configurados con la rotación predeterminada.
Por ejemplo, la rotación de registros no se configura de forma predeterminada en el archivo edge-message-processor.log del procesador de mensajes 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 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 los procesadores de mensajes
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 procesadores de mensajes 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 del procesador de mensajes 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 de edge-message-processor.log en el procesador de mensajes
- Una vez que se ejecute la tarea cron programada, se rotará el archivo de registro. En el ejemplo anterior, el trabajo cron se programa para ejecutarse todos los días a las 00:00 a.m. para rotar el archivo
edge-message- processor.log. -
Navega al directorio
/opt/apigee/var/log/edge-message-processor/y verifica que el archivoedge-message-processor.logesté rotado.Ejemplo de una 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 estén rotando los archivos
edge-message-processor.log, verifica que hayas seguido correctamente todos los pasos que se describen en Cómo habilitar la rotación de registros para edge-message-processor.log en los procesadores de mensajes. Si te salteaste algún paso, vuelve a repetirlos todos correctamente. - Si aún no puedes hacer que funcione la rotación de registros, comunícate con el equipo de asistencia de Apigee Edge.