Включить ротацию журнала для edge-message-processor.log

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Ротация журналов — процесс смены использования и прекращения использования нескольких файлов журналов — упрощает администрирование систем, генерирующих большое количество файлов журналов. Ротация журналов обеспечивает автоматическую ротацию, сжатие, удаление и отправку файлов журналов по почте.

В Edge для частного облака некоторые основные файлы журналов каждого компонента apigee настроены с использованием механизма ротации по умолчанию. Например, в компоненте «Обработчик сообщений» для следующих файлов настроен механизм ротации по умолчанию с использованием журнала регистрации:

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

Подобные файлы существуют и для других компонентов edge-* (имена которых начинаются с edge- ), таких как edge-management-server , edge-router , edge-postgres-server и edge-qpid-server .

Каждый из этих компонентов edge-* также генерирует дополнительный файл журнала, который представляет собой перенаправленный вывод консоли соответствующего компонента. В случае компонента «Обработчик сообщений» этот файл называется /opt/apigee/var/log/edge-message-processor/edge-message-processor.log . Другие компоненты edge-* генерируют аналогичный файл. Ротация этих файлов выполняется не библиотекой logback, а с помощью logrotate и crontab .

Прежде чем начать

Включить ротацию журналов

Этот раздел относится к Edge для частного облака версий 4.50.00 и 4.51.00.

Ротация журналов — это механизм, предназначенный для упрощения администрирования систем, генерирующих большое количество файлов журналов. Он обеспечивает автоматическую ротацию, сжатие, удаление и отправку файлов журналов по почте.

По умолчанию некоторые основные файлы журналов каждого из компонентов apigee настроены с использованием механизма ротации по умолчанию. Например, в компоненте «Обработчик сообщений» для следующих файлов настроен механизм ротации по умолчанию:

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

Однако для других файлов журналов в компонентах apigee ротация по умолчанию не настроена. Например, ротация журналов по умолчанию не настроена в файле процессора сообщений компонента apigee edge-message-processor.log .

Ротацию журналов можно включить с помощью различных утилит/платформ, таких как logrotate , logback или log4j . В этом разделе объясняется, как настроить ротацию журналов для файла /opt/apigee/var/log/edge-message-processor/edge-message-processor.log с помощью logrotate и crontab .

Включение ротации журналов для Edge-message-processor.log на процессорах сообщений

В этом разделе объясняется, как включить ротацию журналов для журналов /opt/apigee/var/log/edge-message- processor/edge-message-processor.log на пограничных процессорах сообщений.

Следующие шаги описывают, как включить ротацию журналов для файла edge-message-processor.log :

  1. Откройте файл /opt/apigee/edge-message-processor/logrotate/logrotate.conf на компьютере с процессором сообщений в редакторе. Если файл не существует, создайте его. Например: 
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
  2. Добавьте в файл фрагмент, аналогичный показанному ниже: 
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
    missingok
    copytruncate
    rotate 5
    size 10M
    compress
    delaycompress
    notifempty
    nocreate
    sharedscripts
    }
  3. Сохраните изменения.
  4. Откройте crontab пользователя apigee используя следующую команду: 
    sudo crontab -u apigee -e
  5. Добавьте следующее задание cron в crontab пользователя 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. Сохраните crontab и отслеживайте ротацию журналов во время следующего запуска задания cron.

Проверка ротации журналов для Edge-message-processor.log в процессоре сообщений

  1. После запуска запланированного задания cron файл журнала будет заменен. В приведенном выше примере запланировано выполнение задания cron каждый день в 00:00 для ротации файла edge-message- processor.log .

  2. Перейдите в каталог /opt/apigee/var/log/edge-message-processor/ и убедитесь, что файл edge-message-processor.log повернут.

    Пример списка файлов журналов

    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

    Приведенный выше вывод показывает, что файлы edge-message-processor.log поворачиваются и сохраняются как файл GZ.

  3. Если вы не видите, что файлы edge-message-processor.log ротируются, убедитесь, что вы правильно выполнили все шаги, описанные в разделе Включение ротации журналов для Edge-message-processor.log на процессорах сообщений . Если вы пропустили какой-либо шаг, повторите все шаги еще раз правильно.
  4. Если вам по-прежнему не удается заставить работать ротацию журналов, обратитесь в службу поддержки Apigee Edge .