Всем привет.
В Zabbix появился официальный Template DB PostgreSQL. В этой статье настроим его в Zabbix 4.4.
1. Переходим в домашний каталог.
2. Скачиваем утилиту git и клонируем официальный репозиторий Zabbix, который находится на GitHub.
3. Переходим в каталог с шаблоном PostgreSQL.
1. Подключимся к PostgreSQL.
2. Создадим пользователя zbx_monitor только для чтения с доступом к серверу PostgreSQL.
Для PostgreSQL версии 10 и выше:
Для PostgreSQL версии 9.6 и ниже:
3. Скопируем каталог postgresql/ в каталог /var/lib/zabbix/. Если у вас в /var/lib/ отсутствует каталог zabbix/, то создайте его. Каталог postgresql / содержит файлы, необходимые для получения метрик из PostgreSQL.
4. Затем скопируем файл template_db_postgresql.conf в каталог конфигурации агента Zabbix /etc/zabbix/zabbix_agentd.d/ и перезапустите агента Zabbix.
5. Теперь отредактируем файл pg_hba.conf, чтобы разрешить подключение к Zabbix. Подробнее о файле pg_hba.conf: https://www.postgresql.org/docs/current/auth-pg-hba-conf.html.
Откройте файл:
Добавьте одну из строк (Если не понимаете зачем это нужно, то добавьте только первую строку.):
Считаю, что те, кому требуется снимать метрики с PostgreSQL итак знают как добавлять шаблоны. Поэтому опишу процесс кратко.
Ждём некоторое время и наконец, переходим в "Monitoring" => "Latest data" => "Hosts" выбираем сервер с PostgreSQL => нажимаем "Apply".
Enjoy!
В Zabbix появился официальный Template DB PostgreSQL. В этой статье настроим его в Zabbix 4.4.
ПРИМЕЧАНИЕ
Если у вас все хорошо с английским, то рекомендую установить шаблон по официальному мануалу
github.com/zabbix/zabbix/tree/master/templates/db/postgresql
Тем не менее в моей статье учтены нюансы, которых нет по этой ссылке.
Подготовка шаблона
1. Переходим в домашний каталог.
cd ~2. Скачиваем утилиту git и клонируем официальный репозиторий Zabbix, который находится на GitHub.
yum -y install git
git clone https://github.com/zabbix/zabbix.git3. Переходим в каталог с шаблоном PostgreSQL.
cd zabbix/templates/db/postgresql/Настройка шаблона для агента Zabbix
1. Подключимся к PostgreSQL.
psql -U postgres2. Создадим пользователя zbx_monitor только для чтения с доступом к серверу PostgreSQL.
Для PostgreSQL версии 10 и выше:
CREATE USER zbx_monitor WITH PASSWORD '<ВАШ_ПАРОЛЬ>' INHERIT; GRANT pg_monitor TO zbx_monitor;Для PostgreSQL версии 9.6 и ниже:
CREATE USER zbx_monitor WITH PASSWORD '<ВАШ_ПАРОЛЬ>';
GRANT SELECT ON pg_stat_database TO zbx_monitor;
--Для сбора метрик WAL пользователь должен быть superuser.
ALTER USER zbx_monitor WITH SUPERUSER;3. Скопируем каталог postgresql/ в каталог /var/lib/zabbix/. Если у вас в /var/lib/ отсутствует каталог zabbix/, то создайте его. Каталог postgresql / содержит файлы, необходимые для получения метрик из PostgreSQL.
cp -r postgresql/ /var/lib/zabbix/4. Затем скопируем файл template_db_postgresql.conf в каталог конфигурации агента Zabbix /etc/zabbix/zabbix_agentd.d/ и перезапустите агента Zabbix.
cp template_db_postgresql.conf /etc/zabbix/zabbix_agentd.d/5. Теперь отредактируем файл pg_hba.conf, чтобы разрешить подключение к Zabbix. Подробнее о файле pg_hba.conf: https://www.postgresql.org/docs/current/auth-pg-hba-conf.html.
Откройте файл:
vi /var/lib/pgsql/12/data/pg_hba.confДобавьте одну из строк (Если не понимаете зачем это нужно, то добавьте только первую строку.):
host all zbx_monitor 127.0.0.1/32 trust
host all zbx_monitor 0.0.0.0/0 md5
host all zbx_monitor ::0/0 md5ПРИМЕЧАНИЕ
Если PostgreSQL установлен из репозитория PGDG, добавьте путь к pg_isready в переменную среды PATH для пользователя zabbix.
Как вариант:
ln -s /usr/pgsql-12/bin/pg_isready /usr/bin/pg_isready
* — так как у меня pgsql 12 версии, то у вас вместо pgsql-12 будет другой путь.
Если этого не сделать, то Status: Ping всегда будет в состоянии Down.
Добавление шаблона на фронтенде Zabbix
Считаю, что те, кому требуется снимать метрики с PostgreSQL итак знают как добавлять шаблоны. Поэтому опишу процесс кратко.
- Заходим на страницу Zabbix;
- Переходим на страницу "Configuration" => "Host";
- Нажимаем на кнопку "Create host" или выбираем существующий хост;
- На странице создания/редактирования хоста выбираем вкладку "Templates" и и жмём на линк "Add";
- В «Group» из списка выбираем «Templates/Databases», выбираем шаблон "Template DB PostgreSQL", жмём кнопку "Select" и нажимаем кнопку "Update";
Ждём некоторое время и наконец, переходим в "Monitoring" => "Latest data" => "Hosts" выбираем сервер с PostgreSQL => нажимаем "Apply".
Enjoy!
Комментарии (12)
lokks
13.11.2019 12:52Спасибо за статью!
Требуется ли обновление самих заббикс-агентов на серверах до новой go-шной версии?
Или со старыми агентами (работавшими с libzbxpgsql например) всё подхватится?
Sleuthhound
13.11.2019 15:12Требуется как минимум zabbix-server 4.4, а zabbix-agent может быть и 3-й версии.
zabbix-agent2 на Go тут не нужен.
И libzbxpgsql тут наверно будет более интересен, т.к. это сишный модуль, который работает быстрее, кушает меньше ресурсов и наверно будет более гибок, хотя тут нужно смотреть что Вам проще — писать кастомные sql запросы для libzbxpgsql или правила препроцессинга для zabbix-server 4.4
Pinkerton42
13.11.2019 13:17Тет все метрики через psql -f somefile.sql тянутся. Мне кажется агентов не обязательно обновлять.
Sleuthhound
Для скачивания с Github не обязательно тащить git, можно просто wget'ом/curl скачать github.com/zabbix/zabbix/archive/master.zip
Ну и стиль написания команд в шел привели бы к единому виду, а то где-то в 1 строке по 2 команды через; а где-то построчно. ИМХО более наглядно и удобно когда 1 команда 1 строка.
То есть не освоили/осилили как добавить в PATH для zabbix-agent?
Ну тогда подскажу, для CentOS/RHEL/OracleLinux в файл /etc/sysconfig/zabbix-agent добавить
А в /usr/lib/systemd/system/zabbix-agent.service добавить
потом сделать
и проверить
MaxRAF Автор
Спасибо за замечания.
В чем преимущество вашего примера перед ln -s /usr/pgsql-12/bin/pg_isready /usr/bin/pg_isready?
Sleuthhound
Для меня симлинк — это костыль.
Если у вас на сервере 2-3....10 экземпляров Pg, то в моем случае можно запустить 2-3...10 zabbix-agent на сервере, каждый со своим unit файлом и со с своим EnvironmentFile, а HOME со скриптами будет один. Таким образом каждый агент будет использовать нужную версию psql и pg_isready из своего экземпляра Pg. Да, такая ситуация редкость, но бывает.
Хотя можно все 10 экземпляров Pg с одного агента мониторить, но тут придется надеяться что psql будет присутствовать в системном PATH, но в какой-то момент она может оттуда исчезнуть и… приехали.
Snooper
Лучше использовать systemctl edit --full zabbix-agent.service
Таким образом изменения в юните сохранятся и после установки обновлений.
Sleuthhound
Да, тут вы абсолютно правы.
AlexGluck
Я бы в /etc/systemd/system/zabbix-agent.d/user.service добавил. Так куда понятней для последующей автоматизации через любой scm.
AlexGluck
А в /etc/profiles.d/postgres не лучше? Тогда для всех пользователей обновится path и админы заходя на сервак не будут ломать голову. Это кстати работает на всех дистрибутивах, в отличии от вашего решения.