DOCS ЖУРНАЛЛИСТ LOGG

Appearance

YADRO KORNFELD ​

Сетевое оборудование YADRO KORNFELD генерирует системные сообщения о работе интерфейсов, протоколов маршрутизации и коммутации, аппаратных компонентов, действиях администраторов, изменениях конфигурации, ошибках и других событиях.

В актуальной линейке YADRO представлены датацентровые коммутаторы KORNFELD DC, включая D1156 и D2132, а также кампусная серия KORNFELD SE C3000. Для KORNFELD DC используется собственная сетевая операционная система Kornfeld OS. Производитель документирует поддержку CLI, Syslog, SNMP, gNMI, sFlow, NTP и средств автоматизации. (Yadro)

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

Примеры CLI ниже ориентированы прежде всего на KORNFELD DC и Kornfeld OS. Между поколениями KORNFELD DC, KORNFELD SE и версиями ПО синтаксис может отличаться. Перед массовым применением рекомендуется проверить команды на конкретной версии программного обеспечения.

Что можно собирать ​

В LOGG могут передаваться события:

  • физических и логических интерфейсов;
  • PortChannel и LACP;
  • VLAN;
  • STP;
  • LLDP;
  • MC-LAG;
  • BGP;
  • OSPF;
  • EVPN;
  • VXLAN;
  • VRF;
  • аппаратных компонентов;
  • питания, вентиляторов и температуры;
  • перезагрузок;
  • системных процессов Kornfeld OS;
  • SSH и административных сессий;
  • AAA, RADIUS и TACACS+;
  • действий пользователей;
  • выполненных CLI-команд;
  • изменений конфигурации;
  • ошибок и предупреждений.

Особенно интересна встроенная регистрация действий пользователей. В официальном руководстве Kornfeld OS показано, что системный журнал фиксирует вход и выход пользователя, а также выполняемые им CLI-команды. (Yadro Documentation)

Типовая схема подключения ​

LOGG используется как удаленный Syslog-сервер:

text
YADRO KORNFELD
      │
      │ Syslog
      ▼
     LOGG

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

text
UDP/514

Перед настройкой необходимо убедиться, что сервер LOGG доступен из сети управления коммутатором.

Вход в режим конфигурации ​

Kornfeld OS использует привычную сетевым инженерам модель CLI.

В официальной документации YADRO используется:

text
kornfeld# configure terminal
kornfeld(config)#

Например:

text
kornfeld# configure terminal
kornfeld(config)# hostname DC1-KF-LEAF-01
kornfeld(config)# exit

Такой же CLI используется производителем в примерах настройки MC-LAG, интерфейсов, AAA и других функций. (Yadro)

Базовая настройка LOGG ​

Для SONiC-подобного CLI, используемого Kornfeld OS, конфигурация удаленного Syslog-сервера имеет вид:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10

kornfeld(config)# exit

Где:

text
192.0.2.10 = IP-адрес сервера LOGG

Типовая схема:

text
KORNFELD
   │
   │ UDP/514
   ▼
 LOGG

Команда logging server характерна для современного SONiC CLI, на архитектуре и синтаксисе которого основана значительная часть интерфейса Kornfeld OS. Для конкретного релиза Kornfeld OS рекомендуется проверить доступные параметры командой контекстной помощи ?.

Настройка severity ​

Если версия Kornfeld OS поддерживает расширенные параметры logging server, можно сразу определить минимальный уровень передаваемых сообщений.

Например:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10 severity info

kornfeld(config)# exit

Для постоянного эксплуатационного мониторинга уровень info / informational обычно является хорошей отправной точкой.

Он позволяет видеть не только ошибки, но и изменения состояния инфраструктуры.

Уровни журналирования ​

Syslog использует стандартные severity:

УровеньНазваниеНазначение
0Emergencyсистема неработоспособна
1Alertтребуется немедленное вмешательство
2Criticalкритическая ошибка
3Errorошибка
4Warningпредупреждение
5Noticeважное штатное событие
6Informational / Infoинформационное событие
7Debugотладочная информация

Для LOGG обычно имеет смысл собирать события до уровня:

text
info

или эквивалентного ему informational — в зависимости от синтаксиса конкретной версии Kornfeld OS.

Уровень debug рекомендуется использовать только временно при диагностике конкретной проблемы.

Настройка Source Interface ​

В датацентровой сети коммутатор обычно имеет несколько L3-интерфейсов.

Чтобы LOGG всегда видел устройство с одного и того же адреса, рекомендуется использовать Loopback или management-интерфейс как источник Syslog.

На SONiC-style CLI типовая команда выглядит так:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10 source-interface Loopback 0

kornfeld(config)# exit

В итоге:

text
DC1-KF-LEAF-01
Loopback0: 10.10.10.11
        │
        │ Syslog
        ▼
       LOGG

Использование постоянного source address особенно важно в Leaf-Spine инфраструктурах с ECMP.

Syslog через VRF ​

Management-трафик в ЦОД часто выносится в отдельный VRF.

В версиях CLI с поддержкой VRF типовая конфигурация может выглядеть следующим образом:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10 vrf mgmt

kornfeld(config)# exit

или совместно с source interface:

text
kornfeld(config)# logging server 192.0.2.10 \
    source-interface Management 0 \
    vrf mgmt

Таким образом, Syslog не смешивается с пользовательским трафиком:

text
             Management VRF
                   │
KORNFELD ──────────┼──── LOGG
                   │
             NTP / SSH / SNMP

Изменение порта ​

Стандартный Syslog использует UDP/514.

Если LOGG принимает сообщения, например, на UDP/1514, на CLI с поддержкой remote-port используется схема:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10 remote-port 1514

kornfeld(config)# exit

Для современной SONiC CLI параметры удаленного сервера могут включать адрес, port, severity, source interface и VRF. Такой синтаксис документируется в актуальных SONiC-реализациях. (Cisco DevNet)

Перед использованием дополнительных параметров на KORNFELD следует проверить их наличие:

text
kornfeld(config)# logging server ?

Несколько серверов ​

При поддержке нескольких destinations можно настроить основной и резервный сервер:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10
kornfeld(config)# logging server 192.0.2.11

kornfeld(config)# exit

Например:

text
                  ┌── LOGG-1
KORNFELD ─────────┤
                  └── LOGG-2

или:

text
                  ┌── LOGG
KORNFELD ─────────┤
                  └── SIEM

Это удобно для резервирования, параллельного анализа или миграции между системами.

Просмотр системного журнала ​

Для Kornfeld OS официально документирована команда:

text
kornfeld# show logging lines

Например, можно вывести события, относящиеся к определенному пользователю:

text
kornfeld# show logging lines | grep admin

В официальном примере YADRO журнал содержит информацию об успешной авторизации пользователя и выполненных CLI-командах. (Yadro Documentation)

Это позволяет быстро проверить, что устройство действительно генерирует необходимые сообщения еще до диагностики удаленной доставки.

Контроль административных действий ​

Для LOGG это один из наиболее интересных сценариев KORNFELD.

Kornfeld OS регистрирует:

text
Login
Logout
CLI Command
Configuration Mode
User Management
AAA Events

Например, последовательность может выглядеть так:

text
14:05:03  admin authenticated
14:06:11  admin entered configuration mode
14:06:37  configuration command executed
14:06:40  Ethernet12 changed state
14:06:41  BGP neighbor changed
14:06:44  EVPN routes changed

LOGG позволяет сохранить такую историю централизованно и сопоставить административные действия с изменениями состояния сети.

AAA, RADIUS и TACACS+ ​

Kornfeld OS поддерживает централизованную аутентификацию через RADIUS и TACACS+.

Например, официальная документация приводит конфигурацию:

text
kornfeld# configure terminal

kornfeld(config)# aaa authentication login default group tacacs+ local
kornfeld(config)# aaa authentication failthrough enable

kornfeld(config)# exit

После этого действия идентифицированных пользователей фиксируются в системном журнале. (Yadro Documentation)

В связке с LOGG это дает централизованную историю:

text
кто
   ↓
когда вошел
   ↓
что выполнил
   ↓
что изменилось
   ↓
какой был эффект

События Leaf-Spine ​

KORNFELD DC ориентирован на построение сетей ЦОД и поддерживает Leaf-Spine/CLOS архитектуру, VXLAN и современные механизмы отказоустойчивости. (Yadro)

В такой сети событие редко ограничивается одним устройством.

Например:

text
Physical Link Down
        ↓
PortChannel Changed
        ↓
BGP Neighbor Changed
        ↓
EVPN Route Withdrawn
        ↓
Traffic Reconvergence

Каждый коммутатор показывает только свою часть этой цепочки.

LOGG собирает сообщения от Leaf, Spine, Border Leaf, серверов и приложений и позволяет видеть общую последовательность.

MC-LAG ​

KORNFELD поддерживает MC-LAG, а YADRO публикует практические CLI-примеры его настройки. (Yadro)

Например:

text
kornfeld# configure terminal

kornfeld(config)# mclag domain 1
kornfeld(config-mclag-domain-1)# source-ip 10.10.10.1
kornfeld(config-mclag-domain-1)# peer-ip 10.10.10.2
kornfeld(config-mclag-domain-1)# no shutdown

Для диагностики связанных аварий особенно полезно собирать журналы с обоих MC-LAG peers.

Тогда LOGG может сопоставить:

text
KF1: peer-link changed
KF2: peer state changed
KF1: PortChannel changed
Server: bond state changed
Application: connection timeout

и выстроить единую временную последовательность.

EVPN / VXLAN ​

Новые версии Kornfeld OS развивают поддержку EVPN, включая EVPN Multihoming в Kornfeld OS 1.7. (Yadro)

Для современной fabric-сети цепочка событий может выглядеть так:

text
Physical Interface
        ↓
Underlay
        ↓
BGP
        ↓
EVPN
        ↓
VXLAN
        ↓
Application

Например:

text
uplink down
    ↓
BGP adjacency changed
    ↓
EVPN route withdrawn
    ↓
VTEP reachability changed
    ↓
service connectivity affected

Такие события особенно полезно анализировать централизованно.

Настройка NTP ​

Для корректного восстановления последовательности событий все KORNFELD должны использовать синхронизированное время.

Kornfeld OS поддерживает NTP.

Пример из официальной документации:

text
kornfeld# configure terminal

kornfeld(config)# ntp server 192.0.2.20
kornfeld(config)# ntp source-interface Management 0

kornfeld(config)# end

Просмотреть серверы:

text
kornfeld# show ntp server

Проверить ассоциации:

text
kornfeld# show ntp associations

Официальное руководство также показывает использование NTP через VRF и source interface. (Yadro Documentation)

Почему точное время важно ​

В сетях ЦОД события могут происходить практически одновременно:

text
10:21:14.102  LEAF-01   Ethernet12 Down
10:21:14.211  LEAF-01   PortChannel Changed
10:21:14.386  SPINE-02  BGP Neighbor Changed
10:21:14.614  LEAF-07   EVPN Route Withdrawn
10:21:15.103  APP-04    Connection Timeout

Без синхронизации NTP эти записи остаются отдельными сообщениями.

С синхронизированным временем LOGG может восстановить фактический порядок развития события.

Проверка конфигурации ​

Текущую конфигурацию Kornfeld OS можно посмотреть:

text
kornfeld# show running-configuration

Для поиска настроек журналирования:

text
kornfeld# show running-configuration | grep logging

Посмотреть системный журнал:

text
kornfeld# show logging lines

Ограничить количество выводимых сообщений:

text
kornfeld# show logging lines 20

или выполнить поиск:

text
kornfeld# show logging lines | grep Ethernet

Команда show logging lines подтверждена официальным руководством Kornfeld OS. (Yadro Documentation)

Проверка доступности LOGG ​

Проверьте IP-связность:

text
kornfeld# ping 192.0.2.10

Если используется отдельный management VRF, необходимо проверить доступность LOGG именно через него.

После этого создайте безопасное контролируемое событие — например, административный вход — и убедитесь, что оно:

  1. появилось в show logging lines;
  2. поступило в LOGG;
  3. имеет корректный hostname;
  4. имеет ожидаемый source IP;
  5. содержит корректное время.

Если сообщения не поступают ​

Проверьте:

  1. Настроен ли удаленный Syslog-сервер.
  2. Правильно ли указан IP LOGG.
  3. Правильно ли указан UDP-порт.
  4. Есть ли маршрут до LOGG.
  5. Правильно ли выбран VRF.
  6. Правильно ли выбран source interface.
  7. Не блокируется ли UDP/514 ACL или межсетевым экраном.
  8. Генерируются ли события локально.
  9. Отображаются ли они через show logging lines.
  10. Принимает ли LOGG данные на соответствующем порту.
  11. Синхронизировано ли время.

Для первичной диагностики:

text
kornfeld# show logging lines
kornfeld# show running-configuration | grep logging
kornfeld# show ntp associations
kornfeld# ping 192.0.2.10

Рекомендуемый шаблон ​

Для KORNFELD DC с версией Kornfeld OS, поддерживающей расширенный SONiC-style logging server, шаблон может выглядеть так:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10 severity info
kornfeld(config)# logging server 192.0.2.10 remote-port 514
kornfeld(config)# logging server 192.0.2.10 source-interface Loopback 0
kornfeld(config)# ntp server 192.0.2.20

kornfeld(config)# exit

Если LOGG находится в management VRF:

text
kornfeld# configure terminal

kornfeld(config)# logging server 192.0.2.10 \
    source-interface Management 0 \
    vrf mgmt \
    severity info

kornfeld(config)# exit

Перед применением расширенных аргументов необходимо проверить синтаксис установленной версии:

text
kornfeld(config)# logging server ?

Массовая настройка ​

Для десятков или сотен KORNFELD Syslog следует рассматривать как единую эксплуатационную политику:

text
YADRO KORNFELD
      │
      ├── SPINE
      ├── LEAF
      ├── BORDER LEAF
      └── CAMPUS

Политика должна определять:

  • hostname;
  • адрес LOGG;
  • transport и port;
  • severity;
  • source interface;
  • management VRF;
  • NTP;
  • локальное журналирование;
  • аудит действий пользователей.

KORNFELD также поддерживает автоматизацию через CLI, API и Ansible, поэтому такую конфигурацию целесообразно распространять централизованно. (Yadro)

Что дает подключение YADRO KORNFELD к LOGG ​

Сам коммутатор может показать:

text
Ethernet Down
PortChannel Changed
BGP Neighbor Changed
EVPN Route Withdrawn

Но каждый узел видит только собственную часть происходящего.

LOGG объединяет журналы Leaf, Spine, серверов, систем хранения, операционных систем и приложений.

Вместо отдельных сообщений появляется последовательность:

физический линк потерян → агрегированный канал изменился → BGP-соседство перестроилось → EVPN-маршруты изменились → трафик ушел на другой путь → сервис испытал деградацию.

Дополнительно журналы Kornfeld OS позволяют увидеть, не предшествовало ли этому изменение, выполненное администратором.

Так Syslog превращается из архива сообщений в источник знаний о поведении инфраструктуры.

Множество устройств — единая картина событий.

LOGG: события, связи, влияние.

Примечание по CLI: поддержка Syslog у KORNFELD официально заявлена YADRO, а команды просмотра журналов, NTP, AAA и общий формат Kornfeld CLI подтверждены эксплуатационной документацией. Расширенный синтаксис команды logging server следует проверять для конкретного релиза Kornfeld OS, поскольку открытое руководство YADRO, доступное на момент подготовки материала, не содержит полного CLI Reference для удаленного Syslog.