[comment]: # (tags: snmp gateway)

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

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

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

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

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

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

Данные извлекаются по OID, который представляет собой комбинацию общего базового значения и конкретного суффикса. Общий **base** задается в конфигурационном файле 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 **suffix** задается в конфигурации триггеров на узле сети как **tag** (например, `OIDSuffix:3`) во веб-интерфейсе.

В этом случае вся информация для триггера будет доступна по адресу `OID=1.3.6.1.4.1.3043.7.55.X.3`. Здесь "X" — это количество полей данных триггера (то есть 1 - suffix, 2 - ID, 3 - expression, 4 - description и т. д.).

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

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

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

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

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

[comment]: # ({/9b3e35c2-47cd8028})

[comment]: # ({00cc632f-c3269fdf})
#### Получение данных

После того как все правильно настроено, вы можете использовать команды `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-c3269fdf})

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

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

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

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

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

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