Zabbix
Zabbix is a full-featured monitoring solution for larger networks. It can discover all kind of networking devices using different methods, check machine states and applications, sending pre-defined alarm messages and visualize complex data correlations.
Server setup
Zabbix-server installation
Install the zabbix-server package. This includes the necessary scripts for use with MariaDB or PostgreSQL. The rest of this guide will assume that you will be using MariaDB.
Zabbix-frontend installation
Install the zabbix-frontend-php package. You also have to choose a web server with PHP support, e.g.:
Or one of the other servers found in Category:Web server.
Configuration
Symlink the Zabbix web application directory to your http document root, e.g.:
$ ln -s /usr/share/webapps/zabbix /srv/http/zabbix
To get working apache out of the box you need to enable php integration:
Make sure to adjust following variables to these minimal values in your /etc/php/php.ini
:
extension=bcmath extension=gd extension=sockets extension=mysqli extension=gettext post_max_size = 16M max_execution_time = 300 max_input_time = 300 date.timezone = "UTC"
MySQL
In this example, we create on localhost a MariaDB database called zabbix
for the user zabbix
identified by the password test
and then import the database templates. This connection will be later used by the Zabbix server and web application:
$ mysql -u root -p -e "create database zabbix character set utf8 collate utf8_bin" $ mysql -u root -p -e "grant all on zabbix.* to zabbix@localhost identified by 'test'" $ mysql -u zabbix -p -D zabbix < /usr/share/zabbix-server/mysql/schema.sql $ mysql -u zabbix -p -D zabbix < /usr/share/zabbix-server/mysql/images.sql $ mysql -u zabbix -p -D zabbix < /usr/share/zabbix-server/mysql/data.sql
PostgreSQL
For PostgreSQL, these commands will create a database zabbix
for user zabbix
, which are the default settings in zabbix_server.conf
, then import the schema and initial data:
$ createuser zabbix $ createdb zabbix -O zabbix $ cat /usr/share/zabbix-server/postgresql/{schema,images,data}.sql | psql -U zabbix -d zabbix
Database Configuration
Now edit /etc/zabbix/zabbix_server.conf
with the database settings:
/etc/zabbix/zabbix_server.conf
DBName=zabbix DBUser=zabbix DBPassword=test LogType=system
Starting
Enable and start the zabbix-server-mysql.service
unit, if you are using MariaDB, or zabbix-server-pgsql.service
if using PostgreSQL.
Finally you can access Zabbix via your local web server, e.g.: http://localhost/zabbix/, finish the installation wizard and access the frontend the first time. The default username is and password zabbix
.
See appendix for a link to the official documentation, which explains all further steps in using it.
Agent setup
Installation
Install for each monitoring target, including your monitoring server where zabbix-server is installed. zabbix-server no longer includes zabbix-agent
.
Configuration
Simply edit the and replace the server variable with the IP of your monitoring server. Only servers from this/these IP will be allowed to access the agent.
Server=<IP of Zabbix server> ServerActive=<IP of Zabbix server>
Further make sure the port 10050
on your device being monitored is not blocked and is properly forwarded.
Tips and tricks
Debugging a Zabbix agent
On the client site, you can check the state of an item like this:
$ zabbix_agentd -t hdd.smart[sda,Temperature_Celsius]
On the server/monitoring site, try this:
$ zabbix_get -s host -k hdd.smart[sda,Temperature_Celsius]
Monitor Arch Linux system updates
Here is an approach on how to monitor your Arch Linux clients for available system update using a custom :
You have to restart to apply the new configuration. The keyword for the item you later use in the web frontend is . It returns an integer representing the count of available updates.
Troubleshooting
Error "Specified key was too long; max key length is 767 bytes"
While importing the databases, you might get this error message. In order to solve this, you will have to change the code page configuration for your MariaDB database: MariaDB#Using UTF8MB4.
See also
- Official manual
- Zabbix Share – Zabbix templates, modules & more