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

Esta é a documentação do Apigee Edge.
Acesse 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 registro. Ele permite a rotação automática, a compactação, a remoção e o envio de arquivos de registro.

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

Por exemplo, no componente Roteador, os arquivos a seguir são configurados com rotação padrão. mecanismo de atençã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, há alguns arquivos de registro nos componentes da Apigee que não estão configurados com a rotação de chaves. No componente da Apigee, o arquivo edge-router.log do roteador é um dos arquivos em que a rotação de registros não é configurada por padrão.

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

Antes de começar

  • Caso não conheça as configurações do logrotate, leia a logturn manual (em inglês).
  • Caso não conheça as configurações do crontab, leia a manual do crontab (em inglês).

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

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

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

  1. Abra o arquivo /opt/apigee/edge-router/logrotate/logrotate.conf no roteador. máquina virtual em um editor. Crie o arquivo se ele não existir. 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 alterações.
  4. Abra o crontab do usuário da Apigee usando o seguinte comando:
    sudo crontab -u apigee -e
    
  5. Adicione o cron job a seguir 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 de 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 é girado.

    Exemplo de listagem de arquivos de registro:

    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 os arquivos edge-router.log não estiverem sendo girados, verifique se você seguiu todas as etapas descritas na seção Ativando a rotação de registros para Edge-router.log no Roteador corretamente. Se você não qualquer etapa, repita todas as etapas novamente corretamente.
  4. Se a rotação de registros ainda não funcionar, entre em contato com o suporte do Apigee Edge.