Перейти к основному содержимому

How-To Guide: Работа с логами на оборудовании SNR Wi-Fi AP

Назначение​

Документ описывает общий порядок работы с логами на устройсвах управляемых ОС NWS.

В инструкции рассматриваются две связанные задачи:

  • настройка логирования: выбор уровня и включение записи или передачи логов;
  • выгрузка файлов логов с контроллера или с управляемой точки доступа.

Действия можно выполнять через CLI или через WEB-интерфейс, если соответствующие функции доступны в текущей версии ПО.

Основные понятия​

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

В этой инструкции настройки логирования включают две группы параметров:

  • уровень логирования;
  • ведение логов: запись в локальный файл и/или отправку на syslog-сервер.

Уровень логирования задаётся отдельно и применяется к выбранной области настройки: Profile или Device.

loglevel <level>

Запись или передача логов включается отдельными настройками:

logserver file
logserver syslog <A.B.C.D>
logserver syslog <A.B.C.D:PORT>

logserver file и logserver syslog ... не задают отдельный уровень логирования. Они определяют, вести ли логи в файл и/или отправлять их на syslog-сервер.

Настройки доступны на уровне Profile и Device.

Уровень Profile​

Настройки на уровне Profile применяются ко всем AP, которые используют этот профиль.

Используйте Profile, если нужно задать одинаковое поведение логирования для группы устройств.

Уровень Device​

Настройки на уровне Device применяются к конкретной AP.

Используйте Device, если для отдельной точки нужен индивидуальный уровень логирования или нужно отдельно включить/отключить ведение логов.

Если один и тот же параметр задан и в Profile, и в Device, итоговое поведение для AP определяется конфигурацией устройства с учётом Device override.

System monitor​

system monitor не является частью настроек логирования. Это system-команда для просмотра потока системных логов в текущей CLI-сессии.

Команда не настраивает постоянную запись логов и не создаёт файлы для последующей выгрузки.

Ведение и просмотр логов​

Запись в файл​

Запись логов в локальные файлы включается настройкой:

logserver file

Файлы логов хранятся в памяти устройства.

предупреждение

При записи в файл логи циклически перезаписываются в памяти устройства. Максимальный размер файла логов — 128 КБ. После заполнения файла старые записи заменяются новыми.

Используйте запись в файл, если нужно вести локальные логи на устройстве и затем выгрузить их командой system log download или через WEB-интерфейс.

Отправка на syslog-сервер​

Отправка логов на внешний syslog-сервер настраивается командами:

logserver syslog <A.B.C.D>
logserver syslog <A.B.C.D:PORT>

Если порт не указан, используется стандартный порт syslog.

Используйте syslog-сервер, если нужно вести логи вне устройства, выполнять централизованный поиск или сохранять данные дольше, чем позволяет локальный файл устройства.

Потоковый просмотр​

Для временного просмотра потока логов в CLI используется:

system monitor

Остановить поток:

no system monitor

system monitor удобен для ручной проверки текущих событий, но не заменяет logserver file и logserver syslog.

Уровень логирования​

Уровень логирования задаётся командой:

loglevel <level>

Возможны значения:

  ALERT    Alert
  CRIT     Critical
  DEBUG    Debug
  EMERG    Emergency
  ERR      Error
  INFO     Info
  NOTICE   Notice
  WARNING  Warning

Удалить явно заданный уровень логирования из текущего context:

no loglevel

Настройка через CLI​

Настроить логирование на уровне Profile​

Пример настройки записи в файл и отправки на syslog-сервер для всех AP профиля:

configure
profile snr-ap622-i DEFAULT
 loglevel INFO
 logserver file
 logserver syslog 192.168.88.100:514
 exit
commit

Если настройки должны сохраниться после перезагрузки:

commit write

Настроить логирование на уровне Device​

Пример индивидуальной настройки для одной AP:

configure
device ap622-i-63-41-89
 loglevel DEBUG
 logserver file
 exit
commit

Проверить итоговую конфигурацию AP:

show device-config ap622-i-63-41-89

Проверить текущие настройки​

Применённая конфигурация контроллера:

show running-config

Итоговая конфигурация AP:

show device-config <AP ID>

Ищите строки:

loglevel <level>
logserver file
logserver syslog <A.B.C.D>
logserver syslog <A.B.C.D:PORT>

Изменить уровень логирования​

configure
profile snr-ap622-i DEFAULT
 loglevel DEBUG
 exit
commit

Вернуть уровень:

configure
profile snr-ap622-i DEFAULT
 loglevel INFO
 exit
commit

Удалить временный уровень логирования​

configure
device ap622-i-63-41-89
 no loglevel
 exit
commit

Отключение логирования​

no logserver file syslog

Выгрузка файлов логов​

Выгрузка логов используется для передачи локальных файлов логов на TFTP-, FTP- или SFTP-сервер.

Выгружаются только уже существующие файлы. Команда выгрузки не включает запись логов, не меняет уровень логирования и не создаёт новый архив.

Форматы URL​

tftp://<hostname|IP>[:<port>]/<path>/
ftp://<user>:<password>@<hostname|IP>[:<port>]/<path>/
sftp://<user>:<password>@<hostname|IP>[:<port>]/<path>/

Указывайте каталог назначения. Файлы сохраняются с исходными именами.

Сетевая связность​

Для выгрузки логов контроллера контроллер должен иметь сетевую связность с сервером.

Для выгрузки логов с AP сетевая связность нужна между AP и сервером.

предупреждение

При выгрузке логов с точки доступа файлы отправляются с AP напрямую на указанный сервер, мимо контроллера. Контроллер не проксирует передачу. Сервер должен быть доступен с точки по сети

Перед выгрузкой с AP проверьте:

  • AP имеет маршрут до сервера;
  • firewall между AP и сервером пропускает выбранный протокол;
  • сервер принимает подключение от IP-адреса AP;
  • для FTP/SFTP корректны учётные данные;
  • целевой каталог существует и доступен на запись.

Выгрузка через CLI​

Выгрузить логи контроллера​

system log download <URL>

Пример:

system log download tftp://192.168.88.100/logs/controller/

Выгрузить логи AP​

system log download ap <AP ID> <URL>

Пример:

system log download ap ap622-i-63-41-89 tftp://192.168.88.100/logs/ap622-i-63-41-89/

Ожидаемый вывод во время передачи:

Uploading log files...
******************                                  50%
Log files uploaded successfully.

Команда выполняется сразу, не требует commit и не изменяет running-config или startup-config.

Настройка через WEB​

Работа с логами доступна через WEB интерфейс.

Настройки на уровне профиля​

Перейдите в настройки на уровне профиля.

Настройки логирования на уровне профиля

Открыть настройки устройства​

Перейдите в настройки на уровне устройства Для этой настройки, так же как у везде в системе действует принцип переопределения, настройки сделанные на уровне устройства приоритетнее настроек на уровне профиля.

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

Изменение настроек​

Настраиваемые параметры на уровне устройства и на уровне профиля идентичны.

Выбрать уровень логирования​

В меню Log level выберите нужный уровень:

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

Включить запись в файл​

Включите параметр File logging для записи в файл.

Файлы логов хранятся в памяти устройства.

предупреждение

При записи в файл логи циклически перезаписываются в памяти устройства. Максимальный размер файла логов — 128 КБ. После заполнения файла старые записи заменяются новыми.

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

Настроить syslog-сервер​

Если нужно отправлять логи на внешний сервер, включите параметр Syslog и укажите адресс сервера и опционально порт

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

Применить и сохранить изменения​

Примените настройки и сохрание конфигурацию

Скриншот: применение logging-настроек

Последнее обновление