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

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Rotação de registro, o processo de rotação de vários arquivos de registro para dentro e para fora de uso simplifica a administração de sistemas que gerar um grande número de arquivos de registro. A rotação de registros permite rotação, compactação remoção e envio de arquivos de registro.

No Edge para nuvem privada, alguns dos principais arquivos de registro em cada apigee são configurados com um mecanismo de rotação padrão. Por exemplo, no processador de mensagens, os arquivos a seguir são configurados com uma 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 começar 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 é redirecionado do console do respectivo componente. No caso do componente "Processador de mensagens", esse arquivo é chamado /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Outros componentes edge-* geram um arquivo semelhante. Estes arquivos rotação não são feitas a biblioteca de logback, mas 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).

Ativar rotação de registros

Esta seção se aplica ao Edge para nuvem privada 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 registro. Ele permite a rotação automática, a compactação, a remoção e o envio de arquivos de registro.

Por padrão, alguns dos principais arquivos de registro em cada um dos componentes apigee são configurados com uma mecanismo de rotação padrão. Por exemplo, no componente Processador de mensagens, os arquivos a seguir são configurados com o padrão mecanismo de rotaçã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 são configurados com a rotação padrão. Por exemplo, a rotação de registro não é configurada por padrão na mensagem do componente apigee. Arquivo do processador edge-message-processor.log.

A rotação de registros pode ser ativada usando diferentes utilitários/frameworks, como logrotate, logback ou log4j. Nesta seção, explicamos como configurar o registro rotação para /opt/apigee/var/log/edge-message-processor/edge-message-processor.log usando logrotate e crontab.

Como ativar a rotação de registro para Edge-message-processor.log em processadores de mensagens

Nesta seção, explicamos como ativar a rotação de registros para /opt/apigee/var/log/edge-message- processor/edge-message-processor.log registros nos processadores de mensagens do Edge.

As etapas a seguir descrevem como ativar a rotação de registros em 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. Crie o arquivo se ele não existir. 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 alterações.
  4. Abra o crontab do usuário apigee usando o seguinte comando: 
    sudo crontab -u apigee -e
  5. Adicione o seguinte cron job 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 do Edge-message-processor.log no processador de mensagens

  1. Depois que o cron job programado for executado, o arquivo de registro será rotacionado. A partir do 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 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

    A saída acima indica que o edge-message-processor.log arquivos são girados e salvos como um arquivo GZ.

  3. Se os arquivos edge-message-processor.log não estiverem sendo girados, Depois, verifique se você seguiu todas as etapas descritas A rotação de registros foi ativada para Edge-message-processor.log nos processadores de mensagens. Se você tiver pulado alguma etapa, repita-a corretamente.
  4. Se a rotação de registros ainda não funcionar, entre em contato com o suporte do Apigee Edge.