Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Rotação de registro, o processo de alternar vários arquivos de registro para dentro e para fora de uso, simplifica a administração de sistemas que geram um grande número de arquivos de registros. A rotação de registros permite a rotação, compactação, remoção e envio por correio automáticos dos arquivos de registros.
No Edge para nuvem privada, alguns dos principais arquivos de registros em cada componente apigee
são configurados com um mecanismo de rotação padrão. Por exemplo, no componente
Message Processor, os seguintes arquivos são configurados com um mecanismo de rotação
padrão usando 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
Existem arquivos semelhantes para outros componentes edge-*
(com nomes
que começam com edge-
), como edge-management-server
,
edge-router
, edge-postgres-server
e edge-qpid-server
.
edge-*
também gera um arquivo de registro extra que é uma saída
redirecionada do console do respectivo componente. No caso do componente do processador de mensagens,
esse arquivo é chamado de /opt/apigee/var/log/edge-message-processor/edge-message-processor.log
.
Outros componentes edge-*
geram um arquivo semelhante. A rotação desses arquivos não é feita pela
biblioteca de logback, mas pelo uso de logrotate
e crontab
.
Antes de começar
- Se você não conhece as configurações de
logrotate
, leia o manual de logrotate. - Se você não conhece as configurações de
crontab
, leia o manual do crontab.
Ativar rotação de registro
Esta seção se aplica ao Edge para nuvem privada nas versões 4.50.00 e 4.51.00.
A rotação de registros é um mecanismo projetado para facilitar a administração de sistemas que geram um grande número de arquivos de registros. Ele permite rotação, compactação, remoção e envio de e-mails automáticos de arquivos de registros.
Por padrão, alguns dos principais arquivos de registro em cada um dos componentes apigee
são configurados com um
mecanismo de rotação padrão.
Por exemplo, no componente "Processador de mensagens", os seguintes arquivos são configurados com o mecanismo de rotação padrão:
/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
No entanto, outros arquivos de registro em componentes apigee
não estão configurados com a rotação padrão.
Por exemplo, a rotação de registros não é configurada por padrão no arquivo edge-message-processor.log
do processador de mensagens do componente apigee
.
A rotação de registros pode ser ativada com diferentes utilitários/frameworks, como logrotate
, logback
ou log4j
. Nesta seção, explicamos como configurar a rotação de registros para o arquivo /opt/apigee/var/log/edge-message-processor/edge-message-processor.log
usando logrotate
e crontab
.
Como ativar a rotação de registros para Edge-message-processor.log em processadores de mensagens
Esta seção explica como ativar a rotação de registros para registros /opt/apigee/var/log/edge-message-
processor/edge-message-processor.log
nos processadores de mensagens de borda.
As etapas a seguir descrevem como ativar a rotação de registros para o
arquivo edge-message-processor.log
:
- Abra o arquivo
/opt/apigee/edge-message-processor/logrotate/logrotate.conf
na máquina do processador de mensagens em um editor. Se o arquivo não existir, crie-o. Por exemplo:vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
- Adicione ao arquivo um snippet semelhante ao mostrado abaixo:
/opt/apigee/var/log/edge-message-processor/edge-message-processor.log { missingok copytruncate rotate 5 size 10M compress delaycompress notifempty nocreate sharedscripts }
- Salve as mudanças.
- Abra o
crontab
do usuárioapigee
usando o seguinte comando:sudo crontab -u apigee -e
- Adicione o cron job a seguir ao
crontab
do usuárioapigee
: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
- Salve o
crontab
e monitore a rotação de registros durante a próxima execução do cron job.
Como verificar a rotação de registro para Edge-message-processor.log no processador de mensagens
- Depois que o cron job programado for executado, o arquivo de registro será rotacionado. No exemplo acima,
o cron job está programado para ser executado todos os dias à 0h para alternar o arquivo
edge-message- processor.log
. -
Navegue até o diretório
/opt/apigee/var/log/edge-message-processor/
e verifique se o arquivoedge-message-processor.log
foi girado.Exemplo de listagem de arquivos de registros
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
A saída acima indica que os arquivos
edge-message-processor.log
são girados e salvos como um arquivo GZ. - Se você não notar que os arquivos
edge-message-processor.log
estão sendo rotacionados, verifique se seguiu todas as etapas descritas em Como ativar a rotação de registros para Edge-message-processor.log em processadores de mensagens corretamente. Se você esqueceu alguma etapa, repita todas as etapas corretamente. - Se a rotação de registros ainda não estiver funcionando, entre em contato com o suporte do Apigee Edge.