Системный журнал работы позволяет накапливать информацию об истории работы терминала и, в дальнейшем, осуществлять ее просмотр. Для настройки системного журнала используются понятия модуля, уровня фильтрации и устройства вывода. Диаграмма, описывающая принцип настройки логирования на LTP представлена ниже.
Для каждого модуля возможна настройка определенного уровня логирования, что позволяет включить расширенный уровень логирования, либо исключить журналирование лишних сообщений только для необходимых модулей. Список модулей, для которых доступна настройка системного журнала:
- alarm - сообщения журнала аварий;
- snmp - сообщения от SNMP-агента;
- dhcpd - сообщения от встроенного сервера DHCP;
- pmchal-ipc - сообщения от подсистемы межпроцессного взаимодействия pmchal;
- pmchal-gpon - события GPON;
- pmchal-machine - сообщения о работе машин состояний OLT, каналов и ONT;
- pmchal-olt - информация, связанная с OLT чипом в целом;
- pmchal-gpon-port - информация, связанная с работой GPON-каналов;
- pmchal-ont - информация, связанная с работой ONT;
- pmchal-scheduler - сообщения от подсистемы планировщика заданий;
- pmchal-rdn - сообщения, связанные с резервированием GPON-каналов;
- pmchal-dhcpra - сообщения от DHCP Relay Agent;
- pmchal-dhcpv6ra - сообщения от DHCPv6 Relay Agent;
- pmchal-pppoeia - сообщения от PPPoE Intermediate Agent.
Для каждого модуля доступны следующие уровни фильтрации системного журнала:
- emergency - система не может продолжать работу;
- alert - необходимо оперативное вмешательство;
- critical - критически важные события;
- error - ошибки в работе;
- warning - предупреждения;
- notice - важные уведомления при нормальной работе;
- info - информационные сообщения;
- debug - отладочные сообщения;
- none - не записывать сообщения в журнал.
Доступны следующие направления вывода системного журнала:
- system - системный журнал. Вывод журнала в системный журнал позволяет просматривать журнал работы локально либо использовать удалённый syslog-сервер;
- console - консоль. Вывод журнала в консоль позволяет видеть сообщения системы сразу после их появления на терминале, подключенном к порту Console терминала;
- rsh - сессии CLI. Вывод журнала в сессии CLI позволяет видеть сообщения системы сразу после их появления во всех сессиях CLI, подключенных через telnet или SSH;
- file - файл. Вывод журнала в файл позволяет записывать сообщения системы непосредственно в файл, который в дальнейшем можно передать в техподдержку для анализа. При настройке вывода в файл, сообщения необходимого уровня логирования будут записываться в общий файл локального хранилища логов LTP. В дальнейшем посмотреть лог можно командой show log ltp.
Рассмотрим пример включения расширенного логирования для модуля pmchal-ont, позволяющего получить подробную информацию о процедуре активации онт.
Укажем уровень логирования для самого модуля pmchal-ont.
LTP-4X# configure terminal LTP-4X(config)# logging module pmchal-ont loglevel debug
Включим вывод debug-сообщений в системный журнал
LTP-4X(config)# logging system loglevel debug
Включим запись сообщений уровня debug в локальный файл.
LTP-4X(config)# logging file loglevel debug
Применим и сохраним изменения.
LTP-4X(config)# do commit LTP-4X(config)# do save
Для просмотра текущих настроек логирования используйте команды:
LTP-4X# show logging settings Log: Remote syslog: 0.0.0.0 Port: 514 Size: 16384 Origin-id: Type: ip Save logs between boots: false Log input commands: false Destinations: System: notice Console: critical Remote shells: critical File: notice LTP-4X# show logging module all Log: Submodule [pmchal-gpon]: Log level: notice Submodule [pmchal-ipc]: Log level: notice Submodule [pmchal-machine]: Log level: notice Submodule [pmchal-olt]: Log level: notice Submodule [pmchal-ont]: Log level: notice Submodule [pmchal-gpon-port]: Log level: notice Submodule [pmchal-scheduler]: Log level: notice Submodule [pmchal-dhcpra]: Log level: notice Submodule [pmchal-pppoeia]: Log level: notice Submodule [pmchal-rdn]: Log level: notice Submodule [snmp]: Log level: notice Submodule [alarm]: Log level: notice Submodule [dhcpd]: Log level: notice Submodule [pmchal-dhcpv6ra]: Log level: notice LTP-4X#
Для настройки отправки лога на удаленный syslog-сервер выполните следующие шаги:
Укажите адрес syslog-сервера (должен быть доступен из management подсети OLT). Дополнительными аргументами можно указать номер порта, который слушает syslog-сервер, а так же размер буфера отправки.
LTP-4X# configure terminal LTP-4X(config)# logging remote 192.168.11.35
При необходимости можно добавить один из доступных методов добавления origin-id к сообщениям.
LTP-4X(config)# logging origin-id hostname The sysname will be used as the hostname field of a syslog message string The user defined string will be used as the hostname field of syslog header ip The IP address of the sending interface will be used as the hostname field of a syslog message
Примените и сохраните выполненные изменения.
LTP-4X(config)# do commit LTP-4X(config)# do save