Вы просматриваете документацию по 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.
Подготовка
- Если вы не знакомы с конфигурациями
logrotate, прочитайте руководство по logrotate. - Если вы не знакомы с конфигурациями
crontab, прочитайте руководство по crontab.
Как включить ротацию журнала edge-router.log на маршрутизаторе
В этом разделе рассказывается, как включить ротацию журналов /opt/apigee/var/log/edge-router/edge-router.log на маршрутизаторах Edge.
Ниже описано, как включить ротацию журнала для файла edge-router.log.
-
Откройте файл
/opt/apigee/edge-router/logrotate/logrotate.confна компьютере маршрутизатора в редакторе. Если файла нет, создайте его. Пример:vi /opt/apigee/edge-router/logrotate/logrotate.conf
- Добавьте в файл фрагмент кода, похожий на приведенный ниже:
/opt/apigee/var/log/edge-router/edge-router.log { missingok copytruncate rotate 5 size 10M compress delaycompress notifempty nocreate sharedscripts }
- Сохраните изменения.
- Откройте файл
crontabпользователя Apigee с помощью следующей команды:sudo crontab -u apigee -e
- Добавьте следующую задачу cron в файл
crontabпользователя Apigee:0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
- Сохраните файл
crontabи отслеживайте ротацию журналов во время следующего выполнения задания cron.
Проверка ротации журнала edge-router.log на маршрутизаторе
- После выполнения запланированного задания cron файл журнала будет повернут. В приведенном выше примере задание cron запланировано на 00:00 каждый день для ротации файла
edge-router.log. - Перейдите в каталог
/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. - Если вы не видите, что файлы
edge-router.logсменяются, проверьте, правильно ли вы выполнили все шаги, описанные в разделе Включение ротации журналов для edge-router.log на маршрутизаторе. Если вы пропустили какой-либо шаг, повторите все действия заново. - Если вам не удается настроить ротацию журналов, обратитесь в службу поддержки Apigee Edge.