Интеграция Zabbix ↔ ABillS

Цель интеграции

Обеспечить мониторинг ключевых метрик ABillS через Zabbix:

• Общее количество пользователей
• Количество заблокированных
• Пользователи с долгами/кредитом
• Онлайн/офлайн статистика

Предусловия

Операционная система: Ubuntu 24.04
Zabbix: 6.4 LTS
ABillS: 1.60.25 (рекомендация, не критично)
СУБД: MariaDB/MySQL (уже установлена с ABillS)
Доступы: root на сервере

3. Архитектура решения

Решение построено на одном Zabbix Agent с логическим разделением метрик по хостам в Zabbix.

Zabbix Server
    ↓ запрос через localhost:10051
Zabbix Agent (127.0.0.1:10050)
    ↓ выполняет UserParameter
Perl-скрипты ABillS (/usr/abills/misc/zabbix/*.pl)
    ↓ читают данные
БД ABillS (MariaDB)

Критично:

• Agent работает от пользователя zabbix
• Скрипты должны быть executable для группы zabbix
• Agent слушает только 127.0.0.1 (закрыт от сети)

4. Установка Zabbix Server

4.1. Добавление репозитория

wget https://repo.zabbix.com/zabbix/6.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.4-1+ubuntu24.04_all.deb
dpkg -i zabbix-release_6.4-1+ubuntu24.04_all.deb
apt update

4.2. Установка компонентов

apt install -y zabbix-server-mysql zabbix-sql-scripts zabbix-agent zabbix-frontend-php php8.3-mysql

4.3. Создание БД для Zabbix

mysql

CREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'zabbix'@'localhost' IDENTIFIED BY 'STRONG_PASSWORD_HERE';
GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost';
SET GLOBAL log_bin_trust_function_creators = 1;
FLUSH PRIVILEGES;
EXIT;

⚠️ Замените STRONG_PASSWORD_HERE на реальный пароль.

4.4. Импорт схемы

zcat /usr/share/zabbix-sql-scripts/mysql/server.sql.gz | mysql -u zabbix -p zabbix

Введите пароль пользователя zabbix.

Ожидаемо: импорт занимает 1-2 минуты, предупреждения Using a password — норма.

4.5. Конфигурация Zabbix Server

nano /etc/zabbix/zabbix_server.conf

Найти и задать:

DBHost=localhost
DBName=zabbix
DBUser=zabbix
DBPassword=STRONG_PASSWORD_HERE

4.6. Запуск сервисов

systemctl restart zabbix-server zabbix-agent
systemctl enable zabbix-server zabbix-agent
systemctl status zabbix-server

Ожидаемо: active (running)

5. Настройка Apache для Web-интерфейса

5.1. Конфигурация порта

nano /etc/apache2/ports.conf

Добавить (если нет):

Listen 8080

5.2. VirtualHost для Zabbix

nano /etc/apache2/sites-available/zabbix.conf

<VirtualHost *:8080>
    ServerName zabbix.local
    DocumentRoot /usr/share/zabbix

    <Directory /usr/share/zabbix>
        Options FollowSymLinks
        AllowOverride None
        Require all granted
    </Directory>

    <Directory /usr/share/zabbix/conf>
        Require all denied
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/zabbix_error.log
    CustomLog ${APACHE_LOG_DIR}/zabbix_access.log combined
</VirtualHost>

5.3. Включение PHP-FPM

a2enmod proxy_fcgi setenvif rewrite
a2enconf php8.3-fpm
a2ensite zabbix
systemctl restart php8.3-fpm
systemctl reload apache2

5.4. Настройка PHP

nano /etc/php/8.3/fpm/php.ini

Изменить:

post_max_size = 16M
upload_max_filesize = 16M
max_execution_time = 300
max_input_time = 300

systemctl restart php8.3-fpm

5.5. Генерация locale (если нужно)

locale-gen en_US.UTF-8
update-locale LANG=en_US.UTF-8
systemctl reload apache2

6. Web Setup Wizard

Открыть в браузере: http://YOUR_SERVER_IP:8080

Шаги мастера:

1. Welcome → Next
2. Pre-requisites → все должно быть OK → Next
3. Database connection:
   • Type: MySQL
   • Host: localhost
   • Name: zabbix
   • User: zabbix
   • Password: STRONG_PASSWORD_HERE → Next
4. Zabbix server details:
   • Host: localhost
   • Port: 10051
   • Name: Abills Monitoring → Next
5. Summary → Next/Finish

Первый вход:

Login: Admin
Password: zabbix

⚠️ КРИТИЧНО: сразу после входа сменить пароль Admin:
User settings → Change password

7. Защита Zabbix Agent

7.1. Ограничение сетевого доступа

nano /etc/zabbix/zabbix_agentd.conf

ListenIP=127.0.0.1
Server=127.0.0.1
ServerActive=127.0.0.1
EnableRemoteCommands=0

7.2. Запрет небезопасных команд

nano /etc/zabbix/zabbix_agentd.conf

Убедиться:

DenyKey=system.run[*]

Или явно разрешить только для ABillS (см. раздел 8.3).

systemctl restart zabbix-agent

7.3. Проверка

ss -tulpn | grep 10050

Ожидаемо: 127.0.0.1:10050 (НЕ 0.0.0.0)

8. Интеграция с ABillS

8.1. Проверка наличия скриптов

ls -l /usr/abills/misc/zabbix/

Ожидаемо:

• zabbix_users.pl
• zabbix_internet_online.pl
• zabbix_payments_types.pl

8.2. Установка прав доступа (КРИТИЧНО)

Проблема: по умолчанию скрипты принадлежат root:root с правами 644 — Zabbix Agent не может их выполнить.

Решение:

chgrp zabbix /usr/abills/misc/zabbix/*.pl
chmod 750 /usr/abills/misc/zabbix/*.pl

Проверка:

ls -l /usr/abills/misc/zabbix/zabbix_users.pl

Ожидаемо: -rwxr-x--- root zabbix

8.3. Создание UserParameter

Создать файл:

bash

nano

 /etc/zabbix/zabbix_agentd.d/abills_users.conf

Вставить:

UserParameter=abills.UserAll.value,/usr/abills/misc/zabbix/zabbix_users.pl total
UserParameter=abills.UserDisabled.value,/usr/abills/misc/zabbix/zabbix_users.pl disabled
UserParameter=abills.UserDebt.value,/usr/abills/misc/zabbix/zabbix_users.pl debt
UserParameter=abills.UserCredit.value,/usr/abills/misc/zabbix/zabbix_users.pl credit
UserParameter=abills.UserOnline.value,/usr/abills/misc/zabbix/zabbix_internet_online.pl online
UserParameter=abills.UserReconnect.value,/usr/abills/misc/zabbix/zabbix_internet_online.pl reconnect
UserParameter=abills.UserRecovery.value,/usr/abills/misc/zabbix/zabbix_internet_online.pl recovery
UserParameter=abills.UserZapped.value,/usr/abills/misc/zabbix/zabbix_internet_online.pl zapped

⚠️ Примечание: это не стандартная конфигурация ABillS, добавляется вручную.

8.4. Разрешение выполнения (только если был установлен DenyKey)

Если в zabbix_agentd.conf явно запрещены все команды:

nano /etc/zabbix/zabbix_agentd.conf

Добавить ДО строки DenyKey=system.run[*]:

AllowKey=system.run[/usr/abills/misc/zabbix/*.pl *]

⚠️ Внимание: порядок важен — AllowKey должен быть ДО DenyKey.

8.5. Перезапуск агента

systemctl restart zabbix-agent

8.6. Локальная проверка

sudo -u zabbix /usr/abills/misc/zabbix/zabbix_users.pl total

Ожидаемо: число (например, 17100)

zabbix_agentd -t abills.UserAll.value

Ожидаемо: abills.UserAll.value [t|17100]

9. Настройка в Zabbix Web

9.1. Импорт шаблона

Файл zbx_export_abills.yaml 

zabbix_export:
  version: '6.4'
  template_groups:
    - uuid: fd4a65755652473987656d02b16b58a4
      name: Шаблоны
  templates:
    - uuid: 6127246501214ee1b16124c97467ab95
      template: Abills
      name: Abills
      groups:
        - name: Шаблоны
      items:
        - uuid: f30f04215d5d4c51b945b19458fbf6c0
          name: 'User Total'
          key: abills.UserAll.value
        - uuid: 08c25a4ce9f34b6b97ea7ef5923a8a14
          name: 'User Credit'
          key: abills.UserCredit.value
        - uuid: bfdfa9d359b1479e8364bf7c73d25f92
          name: 'User Debt'
          key: abills.UserDebt.value
        - uuid: 0d1bc4b2c8624c269c6ef2c1ed1a1e92
          name: 'User Disabled'
          key: abills.UserDisabled.value
        - uuid: b31ba8c8b63745199e639aa34adf5791
          name: 'User Online'
          key: abills.UserOnline.value

В Zabbix Web:

1. Configuration → Templates → Import
2. Выбрать файл zbx_export_abills.yaml
3. Import

Результат: появится шаблон Abills.

9.2. Создание отдельного хоста для ABillS

Configuration → Hosts → Create host

• Host name: Abills
• Groups: Linux servers (или создать свою)
• Interfaces → Add:
  • Type: Agent
  • IP: 127.0.0.1
  • Port: 10050

⚠️ Критично: IP должен быть 127.0.0.1 (локальный агент).

9.3. Привязка шаблона

В настройках хоста Abills:

1. Templates → Link new template
2. Выбрать Abills
3. Add → Update

9.4. Проверка данных

Через 1-2 минуты:

Monitoring → Latest data → Host: Abills

Ожидаемо:

• User Total — число
• User Debt — число
• User Credit — число
• User Disabled — число
• User Online — число
• Все items в статусе Supported

10. Критичные моменты

10.1. Права доступа к скриптам

Симптом: Permission denied в значениях items.

Причина: скрипты не executable для пользователя zabbix.

Решение: см. раздел 8.2.

10.2. Проверка всего пути к скриптам

Если sudo -u zabbix не работает, проверить права на каталоги:

namei -l /usr/abills/misc/zabbix/zabbix_users.pl

Все каталоги должны иметь x (execute) для group или others.

10.3. Type mismatch (string вместо numeric)

Симптом: Value of type "string" is not suitable for value type "Numeric (unsigned)"

Причина: скрипт не может выполниться → возвращает текст ошибки вместо числа.

Решение: исправить права (см. 8.2), затем перепроверить локально (см. 8.6).

10.4. AllowKey vs DenyKey

Если в zabbix_agentd.conf есть DenyKey=system.run[*] без предшествующих AllowKey, агент не сможет выполнять скрипты ABillS.

Решение: см. раздел 8.4 (добавить AllowKey ДО DenyKey).

11. Безопасность

11.1. Пароли БД

НЕ публиковать в wiki:

• Пароль пользователя zabbix для MariaDB

Использовать placeholder: STRONG_PASSWORD_HERE

11.2. Файлы с паролями

Файл /etc/zabbix/zabbix_server.conf содержит пароль БД → права 640:

chmod 640 /etc/zabbix/zabbix_server.conf
chown root:zabbix /etc/zabbix/zabbix_server.conf

11.3. Доступ к Web-интерфейсу

• Сразу после установки сменить пароль Admin
• Создать отдельного пользователя для работы (не использовать Admin постоянно)
• Рассмотреть добавление Require ip X.X.X.X/24 в VirtualHost для ограничения доступа

11.4. Скрипты ABillS

Скрипты должны быть доступны только root и zabbix:

chmod 750 /usr/abills/misc/zabbix/*.pl
chown root:zabbix /usr/abills/misc/zabbix/*.pl

НЕ использовать 777 или 755.

12. Troubleshooting

12.1. Zabbix Server не стартует

Проверка:

systemctl status zabbix-server
journalctl -u zabbix-server -n 50

Частые причины:

• Неверный пароль БД в /etc/zabbix/zabbix_server.conf
• БД не создана или схема не импортирована

12.2. Items в статусе "Unsupported"

Проверка в Web: Monitoring → Hosts → Abills → Items → смотреть Error.

Локальная проверка:

zabbix_agentd -t abills.UserAll.value

Частые причины:

• UserParameter не создан (/etc/zabbix/zabbix_agentd.d/abills_users.conf)
• Агент не перезапущен после изменений
• Права доступа к скриптам (см. 8.2)

12.3. Web-интерфейс не открывается

Проверка:

ss -tulpn | grep 8080
systemctl status apache2
systemctl status php8.3-fpm

Частые причины:

• Apache не слушает 8080 (см. 5.1)
• VirtualHost не включен (a2ensite zabbix)
• PHP-FPM не запущен

12.4. Логи

• Zabbix Server: /var/log/zabbix/zabbix_server.log
• Zabbix Agent: /var/log/zabbix/zabbix_agentd.log
• Apache: /var/log/apache2/zabbix_error.log

13. Что НЕ делать

13.1. Не давать SUPER привилегии пользователю zabbix в MariaDB

Используйте SET GLOBAL log_bin_trust_function_creators = 1 вместо SUPER.

13.2. Не использовать chmod 777 на скрипты

Это создает угрозу безопасности. Используйте 750 с группой zabbix.

13.3. Не оставлять Agent доступным из сети

ListenIP должен быть 127.0.0.1, НЕ 0.0.0.0.

13.4. Не оставлять стандартный пароль Admin

Это главная причина компрометации Zabbix.

13.5. Не использовать EnableRemoteCommands=1

Это устаревший и небезопасный параметр. Используйте AllowKey/DenyKey.