Ativar a rotação de registros para edge-router.log

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

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.

No Edge para nuvem privada, alguns dos principais arquivos de registros em cada um dos componentes da Apigee são configurados com um mecanismo de rotação padrão.

Por exemplo, no componente "Roteador", os seguintes arquivos são configurados com o mecanismo de rotação padrão:

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

No entanto, alguns arquivos de registros nos componentes da Apigee não estão configurados com a rotação padrão. No componente do Apigee, o arquivo edge-router.log é um dos arquivos em que a rotação de registros não é configurada por padrão.

A rotação de registros pode ser ativada com diferentes utilitários/frameworks, como logrotate, logback ou log4j. Neste documento, explicamos como configurar a rotação de registros para o arquivo /opt/apigee/var/log/edge-router/edge-router.log usando logrotate e crontab.

Antes de começar

Como ativar a rotação de registros para Edge-router.log no roteador

Nesta seção, explicamos como ativar a rotação de registros para /opt/apigee/var/log/edge-router/edge-router.log registros nos roteadores de borda.

Confira nas etapas a seguir como ativar a rotação de registros para o arquivo edge-router.log.

  1. Abra o arquivo /opt/apigee/edge-router/logrotate/logrotate.conf na máquina roteador em um editor. Se o arquivo não existir, crie-o. Exemplo:

    vi /opt/apigee/edge-router/logrotate/logrotate.conf
    
  2. Adicione ao arquivo um snippet semelhante ao mostrado abaixo:
    /opt/apigee/var/log/edge-router/edge-router.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
    
  3. Salve as mudanças.
  4. Abra o crontab do usuário da Apigee usando o seguinte comando:
    sudo crontab -u apigee -e
    
  5. Adicione o seguinte cron job ao crontab do usuário da Apigee:
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
    
  6. 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-router.log no roteador

  1. 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-router.log.
  2. Navegue até o diretório /opt/apigee/var/log/edge-router/ e verifique se o arquivo edge-router.log foi girado.

    Exemplos de listagem de arquivos de registros:

    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
    

    A saída acima indica que os arquivos edge-router.log são girados e salvos como arquivos GZ.

  3. Se você não notar que os arquivos edge-router.log estão sendo rotacionados, verifique se seguiu todas as etapas descritas em Como ativar a rotação de registros para Edge-router.log no roteador corretamente. Se você esqueceu alguma etapa, repita todas as etapas novamente corretamente.
  4. Se a rotação de registros ainda não estiver funcionando, entre em contato com o suporte do Apigee Edge.