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

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.

Cada um desses componentes 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

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:

  1. 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
  2. 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
    }
  3. Salve as mudanças.
  4. Abra o crontab do usuário apigee usando o seguinte comando: 
    sudo crontab -u apigee -e
  5. Adicione o cron job a seguir ao crontab do usuário apigee: 
    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
  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-message-processor.log no processador de mensagens

  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-message- processor.log.

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

  3. 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.
  4. Se a rotação de registros ainda não estiver funcionando, entre em contato com o suporte do Apigee Edge.