Azubarev: Новая страница: « == Возможности расширения == Расширение предназначено для удалённого мониторинга сетевых устройств Cisco по протоколу SNMP. '''Идентификатор расширения:''' `ru.ruscomtech.extension.snmp-generic-cisco-device` '''Версия расширения:''' `3.2.7` '''Минимальная версия Ключ-АСТРОМ...»

2026-09-25T18:44:29Z

Новая страница: « == Возможности расширения == Расширение предназначено для удалённого мониторинга сетевых устройств Cisco по протоколу SNMP. '''Идентификатор расширения:''' <code>ru.ruscomtech.extension.snmp-generic-cisco-device</code> '''Версия расширения:''' <code>3.2.7</code> '''Минимальная версия Ключ-АСТРОМ...»

Новая страница

== Возможности расширения ==

Расширение предназначено для удалённого мониторинга сетевых устройств Cisco по протоколу SNMP.

'''Идентификатор расширения:''' <code>ru.ruscomtech.extension.snmp-generic-cisco-device</code>

'''Версия расширения:''' <code>3.2.7</code>

'''Минимальная версия Ключ-АСТРОМ:''' <code>1.310.0</code>

'''Минимальная версия контроллера выполнения расширений:''' <code>1.307.0</code>

Расширение позволяет контролировать:

* загрузку процессора и использование памяти;
* время работы устройства после перезапуска;
* состояние и загрузку сетевых интерфейсов;
* входящий и исходящий трафик;
* ошибки, отброшенные пакеты и ошибки CRC;
* использование полосы пропускания;
* состояние вентиляторов, датчиков и блоков питания;
* пулы памяти;
* состояние активного и резервного супервизоров;
* статистику TCP и UDP;
* состояние SNMP;
* соседние устройства, обнаруженные через LLDP;
* соседей и состояние протоколов BGP, OSPF и EIGRP;
* физические заменяемые компоненты устройства.

Расширение также добавляет:

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

== Поддерживаемые устройства ==

Расширение предназначено для устройств Cisco, которые:

* доступны по SNMP;
* поддерживают необходимые стандартные и Cisco MIB;
* возвращают используемые расширением OID.

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

== Требования ==

Для работы расширения необходимы:

* Ключ-АСТРОМ версии <code>1.310.0</code> или новее;
* контроллер выполнения расширений версии <code>1.307.0</code> или новее;
* шлюз, с которого доступны контролируемые устройства;
* разрешённый SNMP на устройствах Cisco;
* сетевой доступ от шлюза к UDP-порту <code>161</code>;
* учётные данные SNMP с правами чтения.

Поддерживаются:

* SNMP v2c;
* SNMP v3.

В целях безопасности рекомендуется использовать SNMP v3 с аутентификацией и шифрованием.

== Установка расширения ==

# Откройте раздел управления расширениями в Ключ-АСТРОМ.
# Загрузите пакет <code>cisco 3.2.7.zip</code>.
# Убедитесь, что расширение <code>ru.ruscomtech.extension.snmp-generic-cisco-device</code> успешно установлено.
# Создайте конфигурацию мониторинга.
# Выберите группу шлюзов, с которой доступны устройства Cisco.
# Добавьте устройства и параметры подключения SNMP.
# Выберите необходимые наборы функций.
# Настройте фильтры интерфейсов.
# Сохраните и включите конфигурацию.

В одну конфигурацию можно добавить несколько устройств с одинаковыми параметрами мониторинга.

== Настройка подключения ==

{| class="wikitable"
! Параметр
! Описание
|-
|Имя конфигурации
|Произвольное понятное имя конфигурации мониторинга.
|-
|Группа шлюзов
|Группа шлюзов, выполняющая SNMP-запросы.
|-
|Адрес устройства
|IP-адрес или DNS-имя устройства Cisco.
|-
|Порт
|Порт SNMP. По умолчанию используется UDP <code>161</code>.
|-
|Версия SNMP
|Версия протокола: SNMP v2c или SNMP v3.
|-
|Community
|Строка сообщества для SNMP v2c.
|-
|Имя пользователя
|Имя пользователя SNMP v3.
|-
|Уровень безопасности
|Для SNMP v3 поддерживаются <code>NoAuthNoPriv</code>, <code>authNoPriv</code> и <code>authPriv</code>.
|-
|Протокол аутентификации
|Алгоритм аутентификации SNMP v3, например SHA или SHA256.
|-
|Пароль аутентификации
|Пароль пользователя SNMP v3.
|-
|Протокол шифрования
|Алгоритм шифрования SNMP v3, например AES.
|-
|Пароль шифрования
|Пароль конфиденциальности SNMP v3.
|-
|Наборы функций
|Группы метрик, которые необходимо получать с устройства.
|}

== Дополнительные параметры ==

{| class="wikitable"
! Параметр
! Описание
|-
|Extension activation tag
|Тег, добавляемый к данным и сущностям конфигурации.
|-
|Pattern to filter capturing of Interfaces by Name
|Фильтр интерфейсов по имени.
|-
|Pattern to filter capturing of Interfaces by Admin Status
|Фильтр по административному состоянию интерфейса.
|-
|Pattern to filter capturing of Interfaces by Operational Status
|Фильтр по фактическому состоянию интерфейса.
|-
|Pattern to filter capturing of Interfaces by Alias
|Фильтр интерфейсов по значению Alias.
|-
|Pattern to filter capturing of Interfaces by Type
|Фильтр по типу интерфейса.
|}

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

Чтобы полностью исключить интерфейсы из сбора, можно указать в фильтре интерфейсов:

<pre>
$eq(!)
</pre>

Значения административного состояния интерфейса:

{| class="wikitable"
! Значение
! Состояние
|-
|1
|Up
|-
|2
|Down
|-
|3
|Testing
|}

Значения рабочего состояния интерфейса:

{| class="wikitable"
! Значение
! Состояние
|-
|1
|Up
|-
|2
|Down
|-
|3
|Testing
|-
|4
|Unknown
|-
|5
|Dormant
|-
|6
|Not present
|-
|7
|Lower layer down
|}

== Наборы функций ==

{| class="wikitable"
! Набор
! Назначение
|-
|Default
|Основные сведения об устройстве, время работы, процессор и память.
|-
|Control Plane
|Загрузка процессора и память управляющей плоскости.
|-
|Interfaces
|Состояние, скорость, ошибки и отброшенные пакеты интерфейсов.
|-
|Interfaces 32-bit
|Счётчики трафика с разрядностью 32 бита.
|-
|Interfaces 64-bit
|Высокоразрядные счётчики трафика для скоростных интерфейсов.
|-
|Memory pools
|Использование 32- и 64-разрядных пулов памяти.
|-
|High availability
|Состояние активного супервизора и синхронизации.
|-
|Sensors
|Температура и состояние вентиляторов.
|-
|Sensors (Advanced)
|Дополнительные физические датчики устройства.
|-
|Power supply
|Состояние блоков питания.
|-
|FRUs
|Состояние заменяемых блоков питания и вентиляторных модулей.
|-
|Health
|Ошибки и состояние подсистемы SNMP.
|-
|Traffic
|Статистика TCP- и UDP-трафика.
|-
|Neighbor discovery
|Обнаружение соседних сетевых устройств по LLDP.
|-
|BGP
|Состояние соседей BGP из стандартного BGP4-MIB.
|-
|Cisco BGP
|Состояние и статистика соседей из CISCO-BGP4-MIB.
|-
|OSPF
|Состояние соседей OSPF.
|-
|EIGRP
|Время прохождения пакетов до соседей EIGRP.
|}

Для высокоскоростных интерфейсов рекомендуется использовать набор <code>Interfaces 64-bit</code>. Счётчики из набора <code>Interfaces 32-bit</code> могут быстро переполняться.

== Основные метрики ==

{| class="wikitable"
! Метрика
! Описание
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.cpm.cpu.total.1min.rev</code>
|Средняя загрузка процессора за одну минуту.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.cpm.cpu.memory.hc.used</code>
|Использованная память процессора.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.sys.uptime</code>
|Время работы устройства после перезапуска.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.if.hc.in.octets.count</code>
|Количество байтов, полученных интерфейсом.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.if.hc.out.octets.count</code>
|Количество байтов, переданных интерфейсом.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.if.in.errors.count</code>
|Количество ошибок при приёме.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.if.out.errors.count</code>
|Количество ошибок при передаче.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.if.in.crc_errors.count</code>
|Количество входящих пакетов с ошибками CRC.
|-
|<code>func:ru.ruscomtech.extension.snmp-generic-cisco-device.if.bandwidth</code>
|Общая загрузка полосы пропускания интерфейса.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.envmon.fan.state</code>
|Состояние вентилятора.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.power_supply.state</code>
|Состояние блока питания.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.cbgp.peer.state</code>
|Состояние соседа Cisco BGP.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.ospf.nbr.state</code>
|Состояние соседа OSPF.
|-
|<code>ru.ruscomtech.extension.snmp-generic-cisco-device.eigrp.peer.srtt</code>
|Сглаженное время прохождения пакетов до соседа EIGRP.
|}

== Оповещения ==

Расширение содержит следующие шаблоны оповещений:

{| class="wikitable"
! Оповещение
! Условие по умолчанию
|-
|Высокая загрузка входящей полосы пропускания
|Загрузка выше 90% как минимум в трёх из пяти последовательных измерений.
|-
|Высокая загрузка исходящей полосы пропускания
|Загрузка выше 90% как минимум в трёх из пяти последовательных измерений.
|}

Пороговые значения следует скорректировать с учётом характеристик сети.

== Проверка работы ==

После сохранения конфигурации:

# Проверьте состояние конфигурации расширения.
# Убедитесь, что устройство отвечает на SNMP-запросы со стороны выбранного шлюза.
# Проверьте поступление метрики <code>ru.ruscomtech.extension.snmp-generic-cisco-device.sys.uptime</code>.
# Откройте обзорную панель устройств Cisco.
# Проверьте создание сущности устройства и связанных сетевых интерфейсов.

Для проверки SNMP v2c можно использовать команду:

<pre>
snmpwalk -v2c -c <community> <адрес_устройства> 1.3.6.1.2.1.1
</pre>

== Устранение неполадок ==

Если метрики не поступают, проверьте:

* доступность UDP-порта <code>161</code>;
* правильность версии SNMP;
* строку сообщества либо параметры SNMP v3;
* список разрешённых адресов на устройстве;
* доступность устройства со стороны выбранного шлюза;
* поддержку необходимых MIB и OID;
* применённые фильтры интерфейсов;
* включённые наборы функций.

Ошибка тайм-аута обычно указывает на проблемы сетевой доступности, межсетевого экрана или параметров SNMP.

Ошибки <code>noSuchObject</code> и <code>noSuchInstance</code> обычно означают, что устройство не поддерживает запрашиваемый OID. Отключите соответствующий набор функций.

== История версий ==

{| class="wikitable"
! Версия
! Изменения
|-
|3.2.7
|
* Версия расширения для Ключ-АСТРОМ <code>1.310.0+</code>.
* Минимальная версия контроллера выполнения расширений повышена до <code>1.307.0</code>.
* Добавлен мониторинг соседей BGP, OSPF и EIGRP.
* Добавлено обнаружение соседних устройств через LLDP.
* Добавлен сбор состояния заменяемых компонентов и дополнительных датчиков.
* Добавлен сбор ошибок CRC сетевых интерфейсов.
* Обновлены обзорная панель, топология устройств и экраны анализа.
|-
|2.1.6
|
* Добавлены наборы мониторинга пулов памяти, BGP и высокой доступности.
* Добавлены фильтры интерфейсов по имени, типу, Alias и состоянию.
* Добавлен сбор 32- и 64-разрядных показателей памяти.
* Интервал показателей загрузки процессора приведён к одной минуте.
* Исправлено применение наборов функций и фильтров к метрикам устройств и интерфейсов, что уменьшило объём лишних данных.
|}

Мониторинг устройств Cisco по SNMP - История изменений