# Конфигурация подключения Zabbix

Для интеграции Zabbix с HOSTVM VDI воспользуйтесь готовым шаблоном и скриптами.

Архив доступен для скачивания в личном кабинете.

{% hint style="info" %}
Примечание: необходима версия Zabbix 6 и выше
{% endhint %}

### Настройка Zabbix-сервера <a href="#server" id="server"></a>

1\. Установите базовую конфигурацию Zabbix-сервера с помощью [инструкции](https://www.zabbix.com/ru/download?zabbix=6.0\&os_distribution=centos\&os_version=8\&components=server_frontend_agent\&db=mysql\&ws=nginx) с сайта разработчика.

2\. Авторизуйтесь через браузер по указанному в процессе установки адресу, используя Admin/zabbix в качестве логина/пароля

3\. Загрузите в Zabbix шаблон из ЛК hostvm\_vdi\_zabbix\_template в раздел Configuration -> Templates -> Import

4\. Добавьте хост в разделе Configuration -> Hosts -> Create Host.\
При добавлении укажите имя хоста, адрес Zabbix-агента и присоедините импортированный шаблон.

### Настройка Zabbix-агента на HOSTVM VDI Broker <a href="#agent-broker" id="agent-broker"></a>

1\. Установите базовую конфигурацию Zabbix-агента на HOSTVM VDI Broker с помощью [инструкции](https://www.zabbix.com/ru/download?zabbix=6.0\&os_distribution=debian\&os_version=11\&components=agent\&db=\&ws=) с сайта разработчика.

2\. Загрузите архив на машину брокера и распакуйте:

```
tar xvzf hostvm_vdi_zabbix_template.tar.gz 
```

3\. Создайте директорию scripts:

```
mkdir -p /etc/zabbix/scripts
```

4\. Скопируйте файл `zbx-hostvm_vdi.conf` в директорию `/etc/zabbix/zabbix_agentd.d/`:

```
cp hostvm_vdi_zabbix_template/zbx-hostvm_vdi.conf /etc/zabbix/zabbix_agentd.d/zbx-hostvm_vdi.conf
```

5\. Скопируйте файлы `zbx-hostvm_vdi.py`  и `zbx-hostvm_db_check.py` в директорию `/etc/zabbix/scripts/`:

```
cp hostvm_vdi_zabbix_template/zbx-hostvm_vdi.py /etc/zabbix/scripts/zbx-hostvm_vdi.py
cp hostvm_vdi_zabbix_template/zbx-hostvm_db_check.py /etc/zabbix/scripts/zbx-hostvm_db_check.py
```

6\. Скопируйте директорию `apiclient` в директорию `/etc/zabbix/scripts/`:

```
cp -r hostvm_vdi_zabbix_template/apiclient /etc/zabbix/scripts/apiclient
```

7\. Установите необходимые права для файла `zbx-hostvm_vdi.py`:

```
chmod 0755 /etc/zabbix/scripts/zbx-hostvm_vdi.py
```

\
8\. Если на Брокере запущен фаервол, то необходимо разрешить подключение по порту 10050/tcp (либо другому, указанному в конфигурации агента). Пример для ufw:

```
sudo ufw allow 10050/tcp
```

9\. Откройте файл `/etc/zabbix/zabbix_agentd.conf` и внесите изменения, пример изменяемых параметров:

{% code overflow="wrap" %}

```
Server = 10.1.99.30
# IP-адрес Вашего Zabbix-сервера
ServerActive = 10.1.99.30
# IP-адрес Вашего Zabbix-сервера
ListenPort = 10050
# Порт, указанный на Zabbix-сервере при добавлении хоста, в случае, если порт другой, то необходимо добавить для него соответствующее правило фаервола (см. пункт 7)
Hostname = vdi.pvhostvm.ru
# FQDN Вашего хоста, должен быть аналогичен указанному на Zabbix-сервере
Timeout=30
Include=/etc/zabbix/zabbix_agentd.d/zbx-hostvm_vdi.conf 
# В случае, если путь до конфигурационного файла другой, то его нужно изменить
```

{% endcode %}

10\. Откройте файл `/etc/zabbix/scripts/zbx-hostvm_vdi.py` и внесите изменения, указав параметры Вашего брокера:

```
vdi = apiclient.Client(  # Параметры подключения
    '10.1.99.58',  # адрес брокера
    'admin',  # аутентификатор
    'root',  # пользователь
    'udsmam0'  # пароль
)
```

11\. Перезагрузите агент:

```
systemctl restart zabbix-agent
```

После выполненных действий дождитесь появления объектов в панели управления Zabbix.

### Настройка Zabbix-агента на HOSTVM VDI Tunneler <a href="#agent-tunneler" id="agent-tunneler"></a>

1\. Установите базовую конфигурацию Zabbix-агента на HOSTVM VDI Tunneler с помощью [инструкции](https://www.zabbix.com/ru/download?zabbix=6.0\&os_distribution=debian\&os_version=11\&components=agent\&db=\&ws=) с сайта разработчика.

2\. Загрузите архив на машину брокера и распакуйте:

```
tar xvzf hostvm_vdi_tunneler_zabbix_template.tar.gz 
```

3\. Создайте директорию scripts:

```
mkdir -p /etc/zabbix/scripts
```

4\. Скопируйте файл `zbx-hostvm_vdi_tunneler.conf` в директорию `/etc/zabbix/zabbix_agentd.d/`:

```
cp hostvm_vdi_tunneler_zabbix_template/zbx-hostvm_vdi_tunneler.conf /etc/zabbix/zabbix_agentd.d/zbx-hostvm_vdi_tunneler.conf
```

5\. Скопируйте файл `zbx-hostvm_tun_check.py` в директорию `/etc/zabbix/scripts/`:

```
cp hostvm_vdi_tunneler_zabbix_template/zbx-hostvm_tun_check.py /etc/zabbix/scripts/zbx-hostvm_tun_check.py
```

6\. Установите необходимые права для файла `zbx-hostvm_tun_check.py`:

```
chmod 0755 /etc/zabbix/scripts/zbx-hostvm_tun_check.py
```

\
7\. Если на Туннелере запущен фаервол, то необходимо разрешить подключение по порту 10050/tcp (либо другому, указанному в конфигурации агента). Пример для ufw:

```
sudo ufw allow 10050/tcp
```

8\. Откройте файл `/etc/zabbix/zabbix_agentd.conf` и внесите изменения, пример изменяемых параметров:

{% code overflow="wrap" %}

```
Server = 10.1.99.30
# IP-адрес Вашего Zabbix-сервера
ServerActive = 10.1.99.30
# IP-адрес Вашего Zabbix-сервера
ListenPort = 10050
# Порт, указанный на Zabbix-сервере при добавлении хоста, в случае, если порт другой, то необходимо добавить для него соответствующее правило фаервола (см. пункт 7)
Hostname = tunneler.pvhostvm.ru
# FQDN Вашего хоста, должен быть аналогичен указанному на Zabbix-сервере
Timeout=30
Include=/etc/zabbix/zabbix_agentd.d/zbx-hostvm_vdi_tunneler.conf 
# В случае, если путь до конфигурационного файла другой, то его нужно изменить
```

{% endcode %}

9\. Откройте файл `/etc/zabbix/scripts/zbx-hostvm_tun_check.py` и внесите изменения, указав параметры Вашего туннелера:

```
UserParameter=vdi.tunnel_check, /usr/bin/python3 /etc/zabbix/scripts/zbx-hostvm_tun_check.py X.X.X.X
```

X.X.X.X – IP-адрес туннелера

Если для подключения к туннелеру настроен не порт по умолчанию (443), необходимо указать\
адрес в формате: -p YY X.X.X.X, где YY – порт подключения к туннелеру, XXXX – IP-адрес туннелера.\
Например:

```
UserParameter=vdi.tunnel_check, /usr/bin/python3 /etc/zabbix/scripts/zbx-hostvm_tun_check.py -p 544 10.10.10.10
```

10\. Перезагрузите агент:

```
systemctl restart zabbix-agent
```

После выполненных действий дождитесь появления объектов в панели управления Zabbix.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-installation-guide/zabbix-config.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
