[comment]: # (tags: snmp gateway)

[comment]: # ({6f013aad-20100ba3})
# 3. SNMP gateway

[comment]: # ({/6f013aad-20100ba3})

[comment]: # ({8efbf69b-8cb5033f})
#### Обзор

Zabbix SNMP gateway — это AgentX-расширение для snmpd, поддерживающее как опрос, так и приём SNMP трапов.

С помощью Zabbix SNMP gateway можно использовать протокол SNMP для получения:

-    данных триггера;
-    данных триггера проблем;
-    состояния группы узлов сети (количество триггеров по состоянию триггера на группу) 

Данные извлекаются по OID, который представляет собой комбинацию общей базы и определённого суффикса. Общая **база** задается в файле конфигурации SNMP gateway, например: 

-    `BaseOID=1.3.6.1.4.1.3043.7.55` — для данных любого триггера; 
-    `ProblemBaseOID=1.3.6.1.4.1.3047.7.55` — для данных триггера проблем;
-    `BaseOID=1.3.6.1.4.1.3046.7.55` — для состояния группы узлов сети.

**Суффикс** OID задаётся в веб-интерфейсе в конфигурации триггеров узлов сети как **тег** (например, `OIDSuffix:3`).

В данном случае вся информация для триггера будет доступна в `OID=1.3.6.1.4.1.3043.7.55.X.3`. «X» здесь будет номером полей данных триггера (т. е. 1 — суффикс, 2 — ID, 3 — выражение, 4 — описание и т. д.).

Более подробное описание и пример файла конфигурации смотрите в [файле readme шлюза SNMP \[en\]](https://git.zabbix.com/projects/ZT/repos/snmp-gateway/browse/README.md).

[comment]: # ({/8efbf69b-8cb5033f})

[comment]: # ({9b3e35c2-7863edd2})
#### Установка и настройка

Смотрите файл [readme \[en\]](https://git.zabbix.com/projects/ZT/repos/snmp-gateway/browse/README.md) шлюза SNMP для получения инструкций по:

-    установке и настройке snmpd;
-    включению поддержки AgentX;
-    настройке Zabbix SNMP gateway;
-    настройке SNMP трапов на изменения состояния триггера.

[comment]: # ({/9b3e35c2-7863edd2})

[comment]: # ({00cc632f-b9326041})
#### Извлечение данных

Если все настроено правильно, вы можете использовать команды `snmpwalk` и `snmpget` для извлечения данных:

```
[user@localhost ~]# snmpget -v2c -c public 127.0.0.1 1.3.6.1.4.1.3043.7.55.2.3
SNMPv2-SMI::enterprises.3043.7.55.2.3 = INTEGER: 15247
```

```
[user@localhost ~]# snmpwalk -v2c -c public 127.0.0.1 1.3.6.1.4.1.3043.7.55
SNMPv2-SMI::enterprises.3043.7.55.1.1 = INTEGER: 1
SNMPv2-SMI::enterprises.3043.7.55.1.3 = INTEGER: 3
SNMPv2-SMI::enterprises.3043.7.55.1.4 = INTEGER: 4
SNMPv2-SMI::enterprises.3043.7.55.1.5 = INTEGER: 5
SNMPv2-SMI::enterprises.3043.7.55.1.6 = INTEGER: 6
SNMPv2-SMI::enterprises.3043.7.55.1.10 = INTEGER: 10
SNMPv2-SMI::enterprises.3043.7.55.2.1 = INTEGER: 15367
SNMPv2-SMI::enterprises.3043.7.55.2.3 = INTEGER: 15247
SNMPv2-SMI::enterprises.3043.7.55.2.4 = INTEGER: 15365
SNMPv2-SMI::enterprises.3043.7.55.2.5 = INTEGER: 15366
SNMPv2-SMI::enterprises.3043.7.55.2.6 = INTEGER: 13493
SNMPv2-SMI::enterprises.3043.7.55.2.10 = INTEGER: 13503
...
```

[comment]: # ({/00cc632f-b9326041})

[comment]: # ({3ac4c983-c8ec7b72})
##### Параметры фильтрации

Вы можете ограничить информацию о триггере проблем в  настройках SNMP gateway:

- по важности (по умолчанию `ProblemMinSeverity=-1`)
- по скрытию подтверждённых проблем (по умолчанию `ProblemHideAck=false`)

Вы можете ограничить количество проблем на группу узлов сети в настройках SNMP gateway:

- по триггерам с неизвестным состоянием (по умолчанию `CountUnknown=false`)
- по триггерам с подтверждёнными/неподтверждёнными/всеми проблемами (по умолчанию `CountAcknowledgeStatus=all`)

[comment]: # ({/3ac4c983-c8ec7b72})