Как включить ротацию журналов для edge-router.log

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

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

В Edge для частного облака некоторые основные файлы журналов для каждого из компонентов Apigee настроены с механизмом ротации по умолчанию.

Например, в компоненте Router следующие файлы настроены с механизмом ротации по умолчанию:

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

Однако в компонентах Apigee есть определенные файлы журналов, для которых не настроена ротация по умолчанию. Файл edge-router.log компонента Apigee Router – один из тех файлов, для которых по умолчанию не настроена ротация журналов.

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

Подготовка

Как включить ротацию журнала edge-router.log на маршрутизаторе

В этом разделе рассказывается, как включить ротацию журналов /opt/apigee/var/log/edge-router/edge-router.log на маршрутизаторах Edge.

Ниже описано, как включить ротацию журнала для файла edge-router.log.

  1. Откройте файл /opt/apigee/edge-router/logrotate/logrotate.conf на компьютере маршрутизатора в редакторе. Если файла нет, создайте его. Пример:

    vi /opt/apigee/edge-router/logrotate/logrotate.conf
    
  2. Добавьте в файл фрагмент кода, похожий на приведенный ниже:
    /opt/apigee/var/log/edge-router/edge-router.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 -f /opt/apigee/edge-router/logrotate/logrotate.conf
  6. Сохраните файл crontab и отслеживайте ротацию журналов во время следующего выполнения задания cron.

Проверка ротации журнала edge-router.log на маршрутизаторе

  1. После выполнения запланированного задания cron файл журнала будет повернут. В приведенном выше примере задание cron запланировано на 00:00 каждый день для ротации файла edge-router.log.
  2. Перейдите в каталог /opt/apigee/var/log/edge-router/ и убедитесь, что файл edge-router.log повернут.

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

    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

    Приведенный выше вывод указывает на то, что файлы edge-router.log были повернуты и сохранены как файлы GZ.

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