====== Подключение Ubuntu VM к серверу мониторинга Zabbix ======

===== Действия на стороне Ubuntu =====

==== 1. Установка Zabbix агента на Ubuntu VM ====

Зайдите на вашу Ubuntu VM под пользователем с правами sudo.

Добавьте официальный репозиторий Zabbix:

<code bash>
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-4+ubuntu22.04_all.deb
sudo dpkg -i zabbix-release_6.0-4+ubuntu22.04_all.deb
sudo apt update
</code>

Установите Zabbix агент:

<code bash>
sudo apt install zabbix-agent
</code>

==== 2. Настройка Zabbix агента ====

Откройте конфигурационный файл агента:

<code bash>
sudo nano /etc/zabbix/zabbix_agentd.conf
</code>

Найдите строки ''Server'' и ''ServerActive'' и пропишите IP-адрес или доменное имя вашего Zabbix сервера:

<code>
Server=10.0.1.23
ServerActive=10.0.1.23
</code>

Также в конфиге можно указать имя хоста, которое будет отображаться в веб-интерфейсе Zabbix:

<code>
Hostname=имя_вашей_вм
</code>

Сохраните изменения и закройте редактор (''Ctrl+O'', ''Enter'', ''Ctrl+X'').

==== 3. Запуск и включение агента ====

Запустите сервис агента и включите его автозапуск:

<code bash>
sudo systemctl restart zabbix-agent
sudo systemctl enable zabbix-agent
</code>

Проверьте статус агента:

<code bash>
sudo systemctl status zabbix-agent
</code>

==== 4. Проверка работы агента ====

Убедитесь, что агент слушает порт 10050:

<code bash>
sudo ss -tulpn | grep 10050
</code>

===== Команды для управления сервисом Zabbix Agent =====

==== Управление сервисом ====

Запуск сервиса:

<code bash>
sudo systemctl start zabbix-agent
</code>

Остановка сервиса:

<code bash>
sudo systemctl stop zabbix-agent
</code>

Перезапуск сервиса:

<code bash>
sudo systemctl restart zabbix-agent
</code>

Перезагрузка конфигурации без остановки сервиса:

<code bash>
sudo systemctl reload zabbix-agent
</code>

Проверка статуса сервиса:

<code bash>
sudo systemctl status zabbix-agent
</code>

Включение автозапуска при загрузке системы:

<code bash>
sudo systemctl enable zabbix-agent
</code>

Отключение автозапуска:

<code bash>
sudo systemctl disable zabbix-agent
</code>

Проверка, включен ли автозапуск:

<code bash>
sudo systemctl is-enabled zabbix-agent
</code>

==== Просмотр логов ====

Просмотр последних 50 строк лога:

<code bash>
sudo tail -n 50 /var/log/zabbix/zabbix_agentd.log
</code>

Просмотр логов в реальном времени:

<code bash>
sudo tail -f /var/log/zabbix/zabbix_agentd.log
</code>

Просмотр логов через journalctl:

<code bash>
sudo journalctl -u zabbix-agent
</code>

Просмотр логов в реальном времени через journalctl:

<code bash>
sudo journalctl -u zabbix-agent -f
</code>

Просмотр последних 100 строк логов:

<code bash>
sudo journalctl -u zabbix-agent -n 100
</code>

Просмотр логов за последний час:

<code bash>
sudo journalctl -u zabbix-agent --since "1 hour ago"
</code>

Просмотр логов за сегодня:

<code bash>
sudo journalctl -u zabbix-agent --since today
</code>

Просмотр логов с ошибками:

<code bash>
sudo journalctl -u zabbix-agent -p err
</code>

==== Проверка конфигурации ====

Проверка конфигурационного файла на ошибки:

<code bash>
sudo zabbix_agentd -t agent.ping
</code>

Тестирование конкретного параметра:

<code bash>
sudo zabbix_agentd -t system.cpu.load[all,avg1]
</code>

Просмотр конфигурации:

<code bash>
sudo cat /etc/zabbix/zabbix_agentd.conf
</code>

Просмотр конфигурации без комментариев:

<code bash>
sudo grep -v "^#" /etc/zabbix/zabbix_agentd.conf | grep -v "^$"
</code>

==== Диагностика и отладка ====

Проверка, слушает ли агент порт 10050:

<code bash>
sudo ss -tulpn | grep 10050
</code>

Альтернативная проверка порта:

<code bash>
sudo netstat -tulpn | grep 10050
</code>

Проверка процесса Zabbix агента:

<code bash>
ps aux | grep zabbix_agentd
</code>

Проверка доступности Zabbix сервера:

<code bash>
ping -c 4 10.0.1.23
</code>

Проверка доступности порта Zabbix сервера:

<code bash>
telnet 10.0.1.23 10051
</code>

Или с помощью nc:

<code bash>
nc -zv 10.0.1.23 10051
</code>

Проверка версии агента:

<code bash>
zabbix_agentd -V
</code>

Запуск агента в режиме отладки (для диагностики проблем):

<code bash>
sudo zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf -f
</code>

''Нажмите Ctrl+C для остановки''

==== Работа с файлами конфигурации ====

Создание резервной копии конфигурации:

<code bash>
sudo cp /etc/zabbix/zabbix_agentd.conf /etc/zabbix/zabbix_agentd.conf.backup-$(date +%Y%m%d)
</code>

Восстановление конфигурации из резервной копии:

<code bash>
sudo cp /etc/zabbix/zabbix_agentd.conf.backup-20241216 /etc/zabbix/zabbix_agentd.conf
sudo systemctl restart zabbix-agent
</code>

Поиск параметра в конфигурации:

<code bash>
sudo grep "Server=" /etc/zabbix/zabbix_agentd.conf
</code>

Редактирование конфигурации:

<code bash>
sudo nano /etc/zabbix/zabbix_agentd.conf
</code>

После изменения конфигурации проверьте синтаксис и перезапустите:

<code bash>
sudo zabbix_agentd -t agent.ping
sudo systemctl restart zabbix-agent
</code>

===== Автоматическая установка с помощью скрипта =====

Для быстрой установки и настройки можно использовать готовый скрипт:

<code bash>
#!/bin/bash

# Параметры подключения к Zabbix серверу
ZABBIX_SERVER_IP="10.0.1.23"

# Обновляем систему и устанавливаем необходимые пакеты
sudo apt update
sudo apt install -y wget nano

# Скачиваем и устанавливаем репозиторий Zabbix для Ubuntu 22.04
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-4+ubuntu22.04_all.deb
sudo dpkg -i zabbix-release_6.0-4+ubuntu22.04_all.deb
sudo apt update

# Устанавливаем zabbix-agent
sudo apt install -y zabbix-agent

# Резервируем оригинальный конфиг
sudo cp /etc/zabbix/zabbix_agentd.conf /etc/zabbix/zabbix_agentd.conf.bak

# Редактируем конфигурационный файл
sudo sed -i "s/^Server=.*/Server=${ZABBIX_SERVER_IP}/" /etc/zabbix/zabbix_agentd.conf
sudo sed -i "s/^ServerActive=.*/ServerActive=${ZABBIX_SERVER_IP}/" /etc/zabbix/zabbix_agentd.conf

# Если строки Server и ServerActive не были найдены, добавляем их
grep -q "^Server=" /etc/zabbix/zabbix_agentd.conf || echo "Server=${ZABBIX_SERVER_IP}" | sudo tee -a /etc/zabbix/zabbix_agentd.conf
grep -q "^ServerActive=" /etc/zabbix/zabbix_agentd.conf || echo "ServerActive=${ZABBIX_SERVER_IP}" | sudo tee -a /etc/zabbix/zabbix_agentd.conf

# Запускаем агент и включаем его автозапуск
sudo systemctl restart zabbix-agent
sudo systemctl enable zabbix-agent

echo "Установка и настройка Zabbix агента завершены."
echo "Server и ServerActive установлены в: $ZABBIX_SERVER_IP"
</code>

**Использование скрипта:**

  - Сохраните скрипт в файл, например ''install_zabbix_agent.sh''
  - Сделайте файл исполняемым: ''chmod +x install_zabbix_agent.sh''
  - Запустите скрипт: ''sudo ./install_zabbix_agent.sh''

===== Действия на стороне Zabbix сервера =====

==== 1. Добавление хоста в веб-интерфейсе Zabbix ====

  - Откройте веб-интерфейс Zabbix
  - Перейдите в **Configuration** → **Hosts**
  - Нажмите **Create host**
  - Заполните поля:
    * **Host name**: имя вашей VM (должно совпадать с параметром ''Hostname'' в конфиге агента)
    * **Groups**: выберите группу или создайте новую
    * **Interfaces**: добавьте Agent interface с IP-адресом вашей VM
  - На вкладке **Templates** добавьте шаблон мониторинга (например, ''Linux by Zabbix agent'')
  - Нажмите **Add**

==== 2. Проверка подключения ====

После добавления хоста подождите несколько минут и проверьте:

  * В списке хостов появится значок **ZBX** зеленого цвета (агент доступен)
  * В разделе **Monitoring** → **Latest data** начнут появляться данные с VM

===== Возможные проблемы =====

==== Агент не подключается к серверу ====

Проверьте firewall на Ubuntu:

<code bash>
sudo ufw status
sudo ufw allow 10050/tcp
</code>

Проверьте логи агента:

<code bash>
sudo tail -f /var/log/zabbix/zabbix_agentd.log
</code>

==== Ошибка "Cannot connect to Zabbix server" ====

Убедитесь, что:

  * IP-адрес Zabbix сервера указан правильно в конфиге агента
  * Сервер доступен по сети: ''ping 10.0.1.23''
  * На Zabbix сервере порт 10051 открыт

==== Агент запущен, но не отвечает ====

Проверьте, работает ли процесс:

<code bash>
sudo systemctl status zabbix-agent
ps aux | grep zabbix_agentd
</code>

Запустите агент в режиме отладки:

<code bash>
sudo systemctl stop zabbix-agent
sudo zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf -f
</code>

===== Дополнительные настройки =====

==== Настройка пассивных проверок ====

В конфиге агента можно настроить дополнительные параметры:

<code>
# Интервал обновления активных проверок (в секундах)
RefreshActiveChecks=120

# Таймаут соединения
Timeout=30

# Разрешить удаленные команды
EnableRemoteCommands=1

# Уровень отладки (0-5, где 5 - максимальный)
DebugLevel=3
</code>

После изменений перезапустите агент:

<code bash>
sudo systemctl restart zabbix-agent
</code>

===== Полезные ссылки =====

  * [[https://www.zabbix.com/documentation/current/en/manual|Официальная документация Zabbix]]
  * [[https://www.zabbix.com/documentation/current/en/manual/appendix/config/zabbix_agentd|Параметры конфигурации агента]]
  * [[https://www.zabbix.com/documentation/current/en/manual/config/items/itemtypes/zabbix_agent|Мониторинг через Zabbix Agent]]