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
.
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
- Si no estás familiarizado con la configuración de
logrotate
, lee el manual de logrotate. - Si no estás familiarizado con la configuración de
crontab
, lee el manual de crontab.
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
:
- 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
- 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 archivo
crontab
del usuario deapigee
con el siguiente comando:sudo crontab -u apigee -e
- Agrega el siguiente trabajo cron al
crontab
del 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
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
- 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
. -
Navega al directorio
/opt/apigee/var/log/edge-message-processor/
y verifica que se haya rotado 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.log
se rotan y 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 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. - Si aún no puedes hacer que la rotación del registro funcione, comunícate con el equipo de asistencia de Apigee Edge.