> For the complete documentation index, see [llms.txt](https://itgro-aly.gitbook.io/test-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://itgro-aly.gitbook.io/test-docs/for-admins/status-monitoring/primer-monitoringa-cherez-zabbix.md).

# primer monitoringa cherez zabbix

Zabbix шаблон для мониторинга модуля Itgrix BX

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

* Zabbix версии 6.0 или выше. Более ранние версии Zabbix не тестировались.
* На хосте, с которого будет производится наблюдение, помимо Zabbix агента должна быть установлена утилита curl.

### Настройка

В качестве контролирующего может быть настроен любой хост, подключенный к Zabbix и имеющий доступ через веб к модулю Itgrix BX.

Для этого на настраиваемом хосте найдите папку с пользовательскими настройками Zabbix агента. Скорее всего она будет располагаться в `/etc/zabbix/` и называться `zabbx_agentd.d` либо `zabbix_agent2.d` в зависимости от используемой версии Zabbix агента. Точный путь до папки с пользовательскими настройками можно посмотреть в конфигурационном файле агента (значения параметра Include).

В этой папки создайте файл с именем `userparameter_itgrix-bx.conf` со следующим содержимым:

```
UserParameter=itgrix.bx.curl.auth[*],curl -s $4 -u '$2':'$3' '$1'
```

Перезагрузите сервис Zabbix агент с помощью команды

```bash
systemctl restart zabbix-agent
```

либо команды (если используется Zabbix Agent 2)

```
systemctl restart zabbix-agent2
```

### Импорт и настройка шаблона в Zabbix

В веб-интерфейсе Zabbix сервера в навигационном меню откройте пункт Настройка/Шаблоны (Configuration/Templates), нажмите кнопку Импорт (Import) и загрузите файл `template/zbx_template_itgrix_bx.xml`.

Затем в разделе Настройка/Узлы (Configuration/Hosts) найдите контролирующий узел, откройте его настройки и добавьте шаблон Template Itgrix BX. Сохранив изменения, перейдите к настройкам макросов узла. Как минимум, необходимо задайть свои значения для `{$ITGRIX_BX_STATUS_URL}`, `{$ITGRIX_BX_USER}` и `{$ITGRIX_BX_PASSWORD}`.

### Макросы

| Имя                         | Описание                                  | Значение по умолчанию      |
| --------------------------- | ----------------------------------------- | -------------------------- |
| `{$ITGRIX_BX_STATUS_URL}`   | Проверяемый адрес                         | sip.example.ru:8077/status |
| `{$ITGRIX_BX_USER}`         | Имя пользователя модуля                   | user                       |
| `{$ITGRIX_BX_PASSWORD}`     | Пароль пользователя                       | secret                     |
| `{$ITGRIX_BX_CURL_OPT}`     | Опции curl                                | --digest                   |
| `{$ITGRIX_BX_LICENSE_WARN}` | Срок предупреждения об истечении лицензии | 7                          |

Примера конфигурационных файлов: