Редактирование: Установка и первоначальная настройка ZABBIX


Перед установкой Zabbix, у Вас должен быть настроен и запущен сервер PostgreSQL или MySQL, с созданным пользователем zabbix и созданной базой zabbix.

Для управления системой мониторинга и чтения данных используется веб-интерфейс, написанный на PHP, соответственно должен быть настроен и запущен веб-сервер (Apache, Nginx).

== Установка Zabbix-сервера ==

=== Создание базы данных ===

В процессе установки Zabbix-сервера должна быть создана база данных Zabbix.

==== PostgreSQL ====

В [[p9]] на данный момент поддерживается несколько версий PostgreSQL. В данной статье мы будем использовать версию postgresql 9.6.

Установить PostgreSQL, Zabbix-сервер и дополнительную утилиту {{pkg|fping}}:
<source lang="text" highlight="1"># apt-get install postgresql9.6-server zabbix-server-pgsql fping</source>

Подготовить к запуску и настроить службы PostgreSQL: 
*создать системные базы данных:
*:<source lang="text" highlight="1">
# /etc/init.d/postgresql initdb
</source>
*включить по умолчанию и запустить службу:
*:<source lang="text" highlight="1">
# systemctl enable --now postgresql
</source>

Создать базу данных Zabbix:
*создать пользователя zabbix (пароль необходимо запомнить) и базу данных zabbix (под правами root):
*:<source lang="text" highlight="1,4">
# su - postgres -s /bin/sh -c 'createuser --no-superuser --no-createdb --no-createrole --encrypted --pwprompt zabbix'
Введите пароль для новой роли: 
Повторите его:
# su - postgres -s /bin/sh -c 'createdb -O zabbix zabbix'
</source>
*добавить в базу данные для веб-интерфейса (последовательность команд важна, в разных версиях путь будет отличаться, версия помечена звёздочкой):
*:<source lang="text" highlight="1"> # su - postgres -s /bin/sh -c 'psql -U zabbix -f /usr/share/doc/zabbix-common-database-pgsql-*/schema.sql zabbix'</source>
*:если вы создаете базу данных для Zabbix прокси, следующие команды выполнять не нужно
*:<source lang="text" highlight="1,2">
# su - postgres -s /bin/sh -c 'psql -U zabbix -f /usr/share/doc/zabbix-common-database-pgsql-*/images.sql zabbix'
# su - postgres -s /bin/sh -c 'psql -U zabbix -f /usr/share/doc/zabbix-common-database-pgsql-*/data.sql zabbix'
</source>

==== MySQL/MariaDB ====

Установить сервер MySQL или MariaDB (в данном случае MariaDB), Zabbix-сервер и дополнительную утилиту {{pkg|fping}}:
<source lang="text" highlight="1"># apt-get install mariadb-server zabbix-server-mysql fping</source>

Включить по умолчанию и запустить службу mysqld:
<source lang="text" highlight="1">
# systemctl enable --now mysqld
</source>

Создать базу данных Zabbix:
*создать пользователя zabbix и базу данных zabbix (пароль необходимо запомнить):
*:<source lang="text" highlight="1,3-5">
$ mysql -uroot -p
Enter password:
MariaDB [(none)]> create database zabbix character set utf8 collate utf8_bin;
MariaDB [(none)]> grant all privileges on zabbix.* to zabbix@localhost identified by '<пароль>';
MariaDB [(none)]> quit;
</source>
*добавить в базу данные для веб-интерфейса (последовательность команд важна, в разных версиях путь будет отличаться, версия помечена звёздочкой):
*:<source lang="text" highlight="1"> $ mysql -uzabbix -p<пароль> zabbix < /usr/share/doc/zabbix-common-database-mysql-*/schema.sql</source>
*:если вы создаете базу данных для Zabbix прокси, следующие команды выполнять не нужно
*:<source lang="text" highlight="1,2">
$ mysql -uzabbix -p<пароль> zabbix < /usr/share/doc/zabbix-common-database-mysql-*/images.sql 
$ mysql -uzabbix -p<пароль> zabbix < /usr/share/doc/zabbix-common-database-mysql-*/data.sql
</source>

=== Установка Apache2 ===
Установить необходимые пакеты:
<source lang="text" highlight="1">
# apt-get install apache2 apache2-mod_php7
</source>
Добавить в автозапуск и запустить  apache2:
<source lang="text" highlight="1">
# systemctl enable --now httpd2
</source>

=== Установка PHP ===

{{Note|Начиная с Zabbix 5.0 для веб-интерфейса требуется PHP версии 7.2 или выше.}}

Установить необходимые пакеты:
*если Zabbix устанавливается с PostgreSQL:
*:<source lang="text" highlight="1">
# apt-get install php7 php7-mbstring php7-sockets php7-gd2 php7-xmlreader php7-pgsql php7-ldap
</source>
*если Zabbix устанавливается с MySQL:
*:<source lang="text" highlight="1">
# apt-get install php7 php7-mbstring php7-sockets php7-gd2 php7-xmlreader php7-mysqlnd-mysqli php7-ldap
</source>

Изменить некоторые опции php в файле {{path|/etc/php/7.3/apache2-mod_php/php.ini}} (версия PHP может быть другой):
<source lang="text">
memory_limit = 256M
post_max_size = 32M
max_execution_time = 600
max_input_time = 600
date.timezone = Europe/Moscow (регион вписать свой)
always_populate_raw_post_data = -1
</source>

Перезапустить apache2: 
<source lang="text" highlight="1">
# systemctl restart httpd2
</source>

=== Настройка и запуск Zabbix-сервера ===

Внести изменения в конфигурационный файл {{path|/etc/zabbix/zabbix_server.conf}}:
<source lang="text">
DBHost=localhost
DBName=zabbix
DBUser=zabbix
DBPassword=Пароль
</source>

В параметре DBPassword используйте пароль от MySQL базы данных Zabbix; пароль пользователя PosgreSQL для PosgreSQL. 

Добавить Zabbix server в автозапуск и запустить его:
*если Zabbix устанавливается с PostgreSQL:
*:<source lang="text" highlight="1">
# systemctl enable --now zabbix_pgsql
</source>
*если Zabbix устанавливается с MySQL:
*:<source lang="text" highlight="1">
# systemctl enable --now zabbix_mysql
</source>

=== Установка веб-интерфейса Zabbix ===

Установить метапакет:
<source lang="text" highlight="1">
# apt-get install zabbix-phpfrontend-apache2-mod_php7
</source>

Включить аддоны в apache2:
<source lang="text" highlight="1">
# ln -s /etc/httpd2/conf/addon.d/A.zabbix.conf /etc/httpd2/conf/extra-enabled/
</source>

Перезапустить apache2:
<source lang="text" highlight="1">
# service httpd2 restart
</source>

Изменить права доступа к конфигурационному каталогу веб-интерфейса, чтобы веб-установщик мог записать конфигурационный файл:
<source lang="text" highlight="1">
# chown apache2:apache2 /var/www/webapps/zabbix/ui/conf
</source>

{{Note| Если устанавливается Zabbix4, команда будет такой:
<source lang="text" highlight="1">
# chown apache2:apache2 /var/www/webapps/zabbix/frontends/php/conf
</source>}}

В браузере перейти на страницу установки Zabbix-сервера:

http://<ip-сервера>/zabbix

{{note|Если при входе на страницу у Вас будет 403 ошибка (доступ запрещен), обратитесь к [[Zabbix_заметки#Настройка_Apache2]]}}

При первом заходе на страницу запустится мастер, который шаг за шагом проверит возможности веб-сервера, интерпретатора PHP и сконфигурирует подключение к базе данных. 

Для начала установки необходимо нажать кнопку ''Next Step'', что осуществит переход на страницу проверки предварительных условий:

[[Файл:Zabbix-2.png|Страница проверки предварительных условий zabbix]]

Необходимо доустановить то, что требуется и перейти на следующую страницу.

Здесь необходимо ввести параметры подключения к базе данных (параметры подключения нужно указывать такие же, как у сервера Zabbix).

Если база в PostgreSQL, по умолчанию в качестве Database schema необходимо указать «public»:
 
[[Файл:Zabbix-3.png|Параметры подключения к базе данных PostgreSQL]]

{{Note|Параметры подключения к базе данных MySQL:

[[Файл:Zabbix-mysql.png|Zabbix. Параметры подключения к базе данных MySQL]]
}}

На следующей странице можно задать имя сервера:

[[Файл:Zabbix-4.png|Настройки zabbix-сервера]]

После окончания установки на экране будет отображаться форма входа в интерфейс управления системой мониторинга. Параметры доступа по умолчанию:
<source lang="text">
Логин: Admin
Пароль: zabbix
</source>

[[Файл:Zabbix-7.png|Форма входа в интерфейс управления системой мониторинга]]

Войдя в систему, нужно сменить пароль пользователя ({{nav|Administration|Users}}), завести других пользователей и можно начать настраивать Zabbix. 

[[Файл:Zabbix-8.png|800px|Интерфейс управления системой мониторинга]]

{{Note|В профиле пользователя можно настроить некоторые функции веб-интерфейса Zabbix, такие, как язык интерфейса, цветовая тема, количество отображаемых строк в списках и т.п. Сделанные в профиле изменения будут применены только к пользователю, в профиле которого были сделаны эти изменения. }}

== Установка и первоначальная установка клиента Zabbix ==

Установить необходимый пакет:
<source lang="text" highlight="1">
# apt-get install zabbix-agent
</source>

Если Zabbix-агент устанавливается не на сам сервер мониторинга, то в файле конфигурации агента {{path|/etc/zabbix/zabbix_agentd.conf}} нужно задать следующие параметры:
<source lang="text">
Server=<ip-сервера>
ServerActive=<ip-сервера>
Hostname=freeipa.example.test
</source>

где freeipa.example.test — имя узла мониторинга, которое будет указано на сервере Zabbix; 

<ip-сервера> — адрес сервера, которому разрешенно обращаться к агенту.

{{Note|Если параметр Hostname будет пустой или закомментирован, то узел добавится под системным именем. }}

Добавить Zabbix-агент в автозапуск и запустить его:
<source lang="text" highlight="1">
# systemctl enable --now zabbix_agentd.service
</source>


== Мониторинг CEPH ==
=== Настройка ноды ===

Установить на ноду CEPH необходимые пакеты:
<source lang="text" highlight="1">
# apt-get install zabbix-agent-sudo git
</source>

Загрузить необходимые файлы:
<source lang="text" highlight="1">
# git clone https://github.com/thelan/ceph-zabbix.git
</source>

Создать директорию и скопировать файлы:
<source lang="text" highlight="1-3">
# mkdir /etc/zabbix/zabbix_ceph
# cp ceph-status.sh /etc/zabbix/zabbix_ceph/
# cp zabbix_agent_ceph_plugin.conf /etc/zabbix/zabbix_agentd.conf.d/
</source>

Изменить путь расположения скрипта в файле {{path|zabbix_agent_ceph_plugin.conf}}:
<source lang="text" highlight="1">
# sed -i 's/\/opt/sudo \/etc\/zabbix\/zabbix_ceph/' /etc/zabbix/zabbix_agentd.conf.d/zabbix_agent_ceph_plugin.conf
</source>

Добавить скрипту права на запуск:
<source lang="text" highlight="1">
# chmod +x /etc/zabbix/zabbix_ceph/ceph-status.sh
</source>

=== Настройка Zabbix-сервера ===
В веб-интерфейсе сервера необходимо перейти на вкладку {{nav|Configuration|Templates}}, нажать кнопку ''Import''.

Импортировать файлы {{path|zbx_ceph_mon_template.xml}} {{path|zbx_ceph_osd_template.xml}} {{path|zbx_ceph_cluster_template.xml}} {{path|zbx_ceph_mds_template.xml}} из директории {{path|zabbix_templates}}, которая находится в склонированной раннее директории.

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

== Возможные проблемы ==
=== Не работает обнаружение при помощи ICMP Ping ===
В журнале {{path|/var/log/zabbix/zabbix_server.log}} присутствуют различные ошибки касающиеся команд {{cmd|fping}}, {{cmd|fping6}}: 

*'''failed: /usr/sbin/fping6: can't create raw socket (must run as root?) : Permission denied'''
*:Для разрешения проблемы необходимо обеспечить запуск программ {{cmd|fping}} и {{cmd|fping6}} с повышением привилегий. Так как сервер запускается от пользователя zabbix входящего в группу zabbix, то 
*:<source lang="text" highlight="1-6">
chown root:zabbix /usr/sbin/fping
chown root:zabbix /usr/sbin/fping6
chmod 710 /usr/sbin/fping
chmod 710 /usr/sbin/fping6
chmod ug+s /usr/sbin/fping
chmod ug+s /usr/sbin/fping6
</source>

*'''ping failed: *.*.*.*: Address family for hostname not supported'''
*:Если вы не используете полноценно ipv6 в вашей сети, рекомендуется отключить использование {{cmd|fping6}}. Для этого в конфигурационном файле {{path|/etc/zabbix/zabbix_server.conf}} раскомментируйте и оставьте без значения параметр
*:<source lang="text">
Fping6Location=
</source>
*:Также бывает полезно указать точное нахождение {{cmd|fping}}, в этом же файле директива:
*:<source lang="text">
FpingLocation=/usr/sbin/fping
</source>

Вы всегда можете проверить корректность работы команд {{cmd|fping}} и {{cmd|fping6}} из терминала авторизовавшись пользователем zabbix:
<source lang="text" highlight="1-2">
# su zabbix -s /bin/sh
$ fping 192.168.0.1
192.168.0.1 is alive
</source>

Разрешения выполнения команды {{cmd|fping}}, управляемой control:
<source lang="text" highlight="1">
# control fping help
public: Any user can execute /usr/sbin/fping
netadmin: Only "netadmin" group members can execute /usr/sbin/fping
restricted: Only root can execute /usr/sbin/fping
</source>

Переключить control для {{cmd|fping}}:
<source lang="text" highlight="1">
# control fping public 
</source>

== Каталоги для архива ==
<pre>
mysqldump -uroot -pzabbix -A>zabb_bk.sql
/etc/zabbix
/var/www/webapps/zabbix
/etc/httpd2/conf/addon.d
/etc/httpd2/conf/sites-available
/etc/php/x.x/apache2-mod_php/php.ini
</pre>


== Полезные ссылки ==
Zabbix 5.0 официальная документация: https://www.zabbix.com/documentation/5.0/ru/manual

== Примечания ==
<references />
{{Category navigation|title=Zabbix|category=ZABBIX|sortkey={{SUBPAGENAME}}}}
[[Категория:Руководства]]