Версия: 8.5

Прием SNMP трапов

Для приема SNMP трапов в Monq воспользуемся агентом и плагином агента snmpTraps.

На целевом сервере установите агент Monq (версии 2.1.0 или выше)
Сконфигурируйте агент следующим образом
```
# Базовый URI системы Monq
BaseUri="https://<Enter MONQ-GLOBAL-DOMAIN>"
# API-ключ координатора для авторизации агента
ApiKey="<Enter API-KEY>"
FileStorage=""
Timeout=100
[Plugins]
CSharpPath="/opt/monq-agent/plugins"
[Connection]
Timeout=100
RetryCount=12
[Agent]
Description=""
SlotsCount=2
[WorkConfigs]
Path="/opt/monq-agent/workconfigs"
```
- BaseUri - укажите адрес вашего пространства Monq
- ApiKey - укажите API-ключ координатора агентов
- WorkConfigs.Path - укажите путь к каталогу с рабочими конфигурациями (например, /opt/monq-agent/workconfigs)
Создайте каталог /opt/monq-agent/workconfigs и перейдите в него
Создайте каталог snmp-mibs и скопируйте в него имеющиеся у вас MIB файлы. Выполняется опционально, для возможности декодирования OID-ов в читаемый текст.

Создайте файл рабочей конфигурации в текущем каталоге (например, snmp-traps.yaml) в формате YAML:

continuous-jobs:
  - init-step:
      plugin: snmpTrap
      with:
        listen: 0.0.0.0
        port: 162
        mibPath: /opt/monq-agent/workconfigs/snmp-mibs/
        bufferType: memory
        bufferSize: 32768
        chunkSize: 32768
        bufferInputName: snmp.job1
        streamKey: b67b2268-f45d-4434-bef4-a11502c1f271

streamKey - укажите API-ключ потока данных, в который будут отправлены полученные трапы

Запустите агент при помощи команды monqagent start или в качестве службы

В логах агента вы должны увидеть следующие записи:

[2024-09-02 09:16:07 +03:00 INF]  Loading work configurations from /opt/monq-agent/workconfigs...
[2024-09-02 09:16:07 +03:00 INF]  1 work configurations were loaded.
[2024-09-02 09:16:07 +03:00 INF]  Establishing connection.
[2024-09-02 09:16:08 +03:00 INF]  Connection established.
[2024-09-02 09:16:09 +03:00 INF] [e75fa98a-4fde-4c3e-9ead-893c7e2aacfd] Listening on UDP port 162.
[2024-09-02 09:16:09 +03:00 INF] [e75fa98a-4fde-4c3e-9ead-893c7e2aacfd] Waiting for UDP broadcast...

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