Общая информация

Системный журнал работы syslog позволяет накапливать информацию об истории работы терминала и, в дальнейшем, осуществлять ее просмотр. Для настройки системного журнала используются понятия модуля, уровня фильтрации и устройства вывода. Принцип работы механизма логирования событий описывается диаграммой:

На OLT существует ряд системных модулей (служб), каждый из которых фиксирует события в процессе своей работы и перенаправляет их в syslog-журнал. За то, насколько детальным будет лог для каждого модуля, отвечают loglevel-фильтры, которые могут быть настроены для каждого модуля. По умолчанию для всех модулей настроен loglevel уровня notice. В свою очередь, устройства вывода данных настраиваются на прием сообщений определенного уровня логирования. Существуют следующие модули, уровни логирования и устройства вывода. Настраиваемые loglevel-фильтры и устройства вывода идентичны для всех серий OLT нового поколения: LTP-N, LTX, MA5160.

Подробнее об устройствах вывода:

• console:  вывод журнала осуществляется в терминал консольного подключения для устройств подключенных к последовательному порту OLT "Console". Позволяет видеть сообщения системы сразу после их возникновения и сразу отображать их на терминале;
• file: вывод журнала в файл представляет собой перенаправление сообщений о возникающих событиях в файлы, хранящиеся в памяти OLT. Данный способ позволяет фиксировать события OLT в файле, который может быть в дальнейшем просмотрен средствами CLI OLT, либо путем выгрузки на файловый сервер FTP/TFTP/HTTP в сети управления;
• rsh: обеспечивает вывод журнала, аналогичный методу console, только для терминалов удаленных подключений по сети по протоколам telnet/SSH;
• remote: обеспечивает отправку событий журнала на удаленный syslog сервер, доступный из сети управления.

В свою очередь, по настраиваемым модулям между разными линейками устройств есть некоторые отличия, обусловленные архитектурными особенностями. Так, на LTP-N, LTX модули настраиваются глобально для всего устройства, а на MA5160 существует часть модулей, принадлежащих к управляющим платам FC и часть модулей, принадлежащих к линейным платам LC.

Настройка логирования

Настройка логирования осуществляется в logging разделе CLI. Наиболее полным и информативным является отладочный уровень сообщений. Однако использовать данный уровень рекомендуется только для диагностики для выявления каких-либо проблем. После снятия отладочного лога рекомендуется возвращать дефолтный уровень логирования – notice. Рассмотрим пример настройки вывода отладочных сообщений для логирования деталей активации и работы определенного ONT. Дополнительно рассмотрим настройку отправки отладочных сообщений на удаленный syslog-сервер.

Настройка логирования LTP-N, LTX

1. Перейдите в режим конфигурирования OLT, далее в logging view.
   

   LTP-16N# configure terminal
   LTP-16N(configure)# logging

2. Включите отладку по модулю DNA с фильтром по ONT с индексом 1/1. 
   

   LTP-16N(config)(logging)# module dna interface ont 1/1 loglevel debug

3. Включите запись сообщений уровня debug в локальный файл, в терминал консольного подключения, а так же отправку сообщений уровня debug на удаленный syslog-сервер.
   

   LTP-16N(config)(logging)# file loglevel debug
   LTP-16N(config)(logging)# console loglevel debug
   LTP-16N(config)(logging)# remote loglevel debug

4. Укажите адрес удаленного syslog-сервера для отправки сообщений лога, примените и сохраните выполненные изменения в энергонезависимую память.
   

   LTP-16N(config)(logging)# remote server ip 10.10.0.111
   LTP-16N(config)(logging)# exit
   LTP-16N(configure)# exit
   LTP-16N# commit
   LTP-16N# save

Настройка логирования MA5160

1. Перейдите в режим конфигурирования OLT, далее в logging view.
   

   MA5160# configure terminal
   MA5160(configure)# logging

2. Перейдите в режим конфигурирования логирования на слоту 16, включите отладку по модулю DNA с фильтром по ONT с индексом 16/1/1. Здесь же настройте запись лога уровня debug в лог файл, соответствующий логу слота 16. Настройка перенаправления лога со слота 16 на удаленный syslog-сервер настраивается здесь же. Перейдите в глобальные настройки логирования командой exit.
   

   MA5160(config)(logging)# slot 16
   MA5160(config)(slot-16)(logging)# module dna interface ont 1/1 loglevel debug
   MA5160(config)(slot-16)(logging)# file loglevel debug
   MA5160(config)(slot-16)(logging)# forward remote loglevel debug
   MA5160(config)(slot-16)(logging)# exit

3. В разделе корневом разделе настроек логирования включите запись сообщений уровня debug в терминал консольного подключения, а так же отправку сообщений уровня debug на удаленный syslog-сервер.
   

   MA5160(config)(logging)# console loglevel debug
   MA5160(config)(logging)# remote loglevel debug

4. Укажите адрес удаленного syslog-сервера для отправки сообщений лога, примените и сохраните выполненные изменения в энергонезависимую память.
   

   MA5160(config)(logging)# remote server ip 10.10.0.111
   MA5160(config)(logging)# exit
   MA5160(configure)# exit
   MA5160# commit
   MA5160# confirm

Просмотр лог файлов

Просмотр отладочных сообщений возможен на удаленном syslog-сервере либо локально в CLI. Кроме того, локальный syslog-файл может быть выгружен на удаленный TFTP/HTTP/FTP-сервер.

Просмотр списка локальных файлов логов на OLT:

LTP-16N# show log files

Просмотр содержимого логфайла (system.log.1 - имя файла):

 LTP-16N# show log system.log.1

 Выгрузка локального логфайла на удаленный сервер (в примере TFTP-сервер с адресом 10.10.0.112)

copy fs://logfile/system.log.1 tftp://10.10.0.112/system.log.1