Инструкция по использованию шаблона Zabbix Microdrive by SNMP
Шаблон для мониторинга роутеров Microdrive по SNMP
Назначение
Документ описывает импорт шаблона, добавление устройства в Zabbix, проверку SNMP-опроса, работу автообнаружения, пороговые значения и типовые проблемы.
1. Назначение шаблона
Шаблон Microdrive by SNMP предназначен для мониторинга роутеров Microdrive в системе Zabbix по протоколу SNMP. Он собирает не общесистемные параметры Linux, а данные, специфичные для устройств Microdrive: LTE-модемы, SIM-карты, регистрацию в мобильной сети, параметры сигнала, температуру модема и данные GNSS/GPS.
Шаблон использует enterprise OID Microdrive:
1.3.6.1.4.1.60641| Что контролируется | Примеры данных |
|---|---|
| LTE-модемы | Количество модемов, модель, IMEI, версия baseband, поддерживаемые диапазоны |
| SIM-карта | Статус SIM, активный слот, IMSI, ICCID |
| Мобильная сеть | Регистрация, PLMN, оператор, технология 2G/3G/LTE, Cell ID, Band |
| Сигнал | RSSI, RSRP, RSRQ, SINR, уровни по антеннам A1–A4 |
| Температура | Температура LTE-модема |
| GNSS/GPS | Спутники, координаты, высота, скорость, направление, UTC-время |
2. Требования
- Zabbix версии 7.0 или совместимой.
- Включенный SNMP на роутере Microdrive.
- Доступность роутера от Zabbix-сервера по UDP-порту 161.
- Правильно указанная SNMP community, например
public. - Поддержка устройством OID-ветки
1.3.6.1.4.1.60641.
Рекомендация
Шаблон Microdrive by SNMP лучше использовать совместно со стандартными шаблонами Linux by SNMP и Interfaces by SNMP. Они отвечают за интерфейсы, uptime, CPU, RAM и другие общесистемные параметры.
3. Настройка SNMP на роутере
На роутере необходимо включить SNMP-сервис. Обычно используются следующие параметры:
| Параметр | Значение |
|---|---|
| SNMP | Включен |
| Версия | SNMP v2c |
| Community | public или другое заданное значение |
| Порт | 161/UDP |
Если на роутере используется firewall, необходимо разрешить входящие SNMP-запросы от IP-адреса Zabbix-сервера.
4. Проверка доступности SNMP
Перед импортом и привязкой шаблона желательно проверить, отвечает ли роутер по SNMP. Проверку можно выполнить с Zabbix-сервера:
snmpwalk -v2c -c public 192.168.1.1 1.3.6.1.4.1.60641Где public — SNMP community, а 192.168.1.1 — IP-адрес роутера. Если устройство отвечает, в выводе должны появиться значения из OID-ветки Microdrive.
5. Импорт шаблона в Zabbix
- Откройте веб-интерфейс Zabbix.
- Перейдите в раздел Data collection → Templates (Сбор данных → Шаблоны).
- Нажмите Import (Импорт).
- Выберите файл
microdrive_snmp_template.yaml. - Нажмите Import (Импортировать).
- После успешного импорта в списке появится шаблон Microdrive by SNMP.
6. Добавление роутера в Zabbix
- Перейдите в раздел Data collection → Hosts (Сбор данных → Узлы сети).
- Нажмите Create host (Создать узел сети).
- Укажите имя хоста, например
Microdrive Router 1. - Добавьте хост в нужную группу, например
Network devices. - В разделе Interfaces добавьте SNMP-интерфейс: IP-адрес роутера и порт 161.
- В разделе Templates привяжите шаблон Microdrive by SNMP.
- При необходимости дополнительно привяжите Linux by SNMP и Interfaces by SNMP.
| Поле | Пример значения |
|---|---|
| Host name | Microdrive Router 1 |
| Groups | Network devices |
| Interface type | SNMP |
| IP address | IP-адрес роутера |
| Port | 161 |
| Template | Microdrive by SNMP |
7. Как работает автообнаружение
7.1. LTE modem discovery
Правило автообнаружения LTE modem discovery запускается каждые 5 минут. Оно автоматически находит LTE-модемы в устройстве и создает для каждого найденного модема отдельные элементы данных, триггеры и графики.
| Создаваемые элементы | Описание |
|---|---|
| SIM status / Current SIM slot | Статус SIM-карты и активный SIM-слот |
| IMSI / ICCID | Идентификаторы SIM-карты |
| Registration status | Статус регистрации в мобильной сети |
| Operator PLMN / Service provider | PLMN и оператор |
| Access technology | Технология подключения: 2G, 3G или LTE |
| Cell ID / Band | Сота и частотный диапазон |
| RSSI / RSRP / RSRQ / SINR | Основные параметры LTE-сигнала |
| Temperature | Температура LTE-модема |
| Antenna A1–A4 signal | Уровни сигнала по антенным входам |
7.2. LTE modem device discovery
Правило LTE modem device discovery запускается один раз в час. Оно собирает паспортную информацию о LTE-модеме, которая меняется редко.
| Элемент | Что показывает |
|---|---|
| Model | Модель LTE-модема |
| Baseband version | Версия прошивки модема |
| IMEI | IMEI модема |
| Supported bands | Поддерживаемые диапазоны |
| GNSS support | Наличие поддержки GNSS |
| SIM slots | Количество SIM-слотов |
| Antenna count | Количество антенн |
8. Проверка получения данных
После привязки шаблона к хосту необходимо подождать несколько минут. Проверить поступление данных можно в разделе Monitoring → Latest data (Мониторинг → Последние данные).
Для фильтрации можно использовать ключевые слова:
LTE, GNSS, RSRP, RSRQ, SINR, Temperature, SIM
Если данные появились, шаблон работает корректно.
9. Пороговые значения
В шаблоне используются макросы, через которые можно менять пороги срабатывания триггеров. Их можно изменить на уровне шаблона или конкретного хоста.
| Макрос | Значение по умолчанию | Назначение |
|---|---|---|
{$MD.LTE.RSRP.WARN} | -110 | Порог слабого RSRP, dBm |
{$MD.LTE.RSRQ.WARN} | -15 | Порог плохого RSRQ, dB |
{$MD.LTE.SINR.WARN} | 0 | Порог низкого SINR, dB |
{$MD.LTE.TEMP.HIGH} | 70 | Порог высокой температуры LTE-модема, °C |
{$MD.GNSS.SAT.MIN} | 3 | Минимальное допустимое количество GNSS-спутников |
10. Триггеры
Шаблон автоматически создает события при следующих условиях:
- LTE-модем не зарегистрирован в мобильной сети.
- Технология подключения отличается от LTE.
- Слабый RSRP.
- Плохой RSRQ.
- Низкий SINR.
- Высокая температура LTE-модема.
- Малое количество GNSS-спутников.
Статусы регистрации
Нормальными статусами регистрации считаются 1 — registered-home и 5 — registered-roaming. Если статус отличается от этих значений, Zabbix создаст проблему по регистрации модема.
11. Графики
Для каждого найденного LTE-модема шаблон автоматически создает графики:
| График | Данные |
|---|---|
| LTE modem X: Signal | RSRP, RSSI, RSRQ, SINR |
| LTE modem X: Temperature | Температура LTE-модема |
| LTE modem X: Antennas | Уровни сигнала по антеннам A1, A2, A3, A4 |
12. Возможные проблемы и проверка
| Проблема | Что проверить |
|---|---|
| Нет данных по шаблону | Включен ли SNMP, правильный ли IP-адрес, community и доступен ли UDP-порт 161. |
| Не появились LTE-модемы | Подождать до 5 минут и проверить доступность таблицы 1.3.6.1.4.1.60641.1.2.2.1. |
| Не появились модель, IMEI или baseband | Эти данные собираются раз в час, поэтому могут появиться не сразу. |
| SNMP-запросы не проходят | Проверить firewall на роутере и маршрутизацию между Zabbix-сервером и устройством. |
13. Краткая схема работы
Zabbix Server
|
| SNMP v2c, UDP/161
v
Microdrive Router
|
| OID: 1.3.6.1.4.1.60641
v
LTE / SIM / Signal / Temperature / GNSS data
|
v
Items, LLD, graphs and triggers in Zabbix14. Кратко
Шаблон Microdrive by SNMP импортируется в Zabbix, привязывается к хосту с SNMP-интерфейсом и автоматически начинает опрашивать роутер Microdrive по SNMP. Он находит LTE-модемы, собирает параметры SIM-карт, регистрации, оператора, сигнала, температуры, GNSS/GPS и создает предупреждения при проблемах со связью, слабом сигнале или перегреве модема.