Configuration files
All ZABBIX processes can be configured by changing appropriate configuration files. After a change was
made, a restart of the process required.
All ZABBIX configuration files are stored in the directory /etc/zabbix/.
Configuration files must have read permissions.
/etc/zabbix/zabbix_suckerd.conf
The file contains configuration parameters for zabbix_suckerd. The file must exist and it should have read
permissions for user zabbix. Supported parameters:
| Parameter | Mandatory | Default value | Description |
| AlertScriptsPath | No | /home/zabbix/bin | Location of scripts for user-defined media types. |
| DBHost | No | localhost | DB host name. |
| DBName | Yes | - | Database name. Usually “zabbix”. |
| DBSocket | No | - | DB socket name. Used for non-TCP connection to MySQL database.
Example: /tmp/mysql.sock |
| DBPassword | No | NULL | User’s password. If password is not used, then this parameter must be commented. |
| DBUser | No | NULL | User name for connecting to the database |
| DebugLevel | No | 3 | Debug level ( 0 - none, 1 - critical, 2 - error, 3 - warnings, 4 - debug) |
| DisableHousekeeping | No | 0 | If set to 1, housekeeping procedure will be disabled |
| DisablePinger | No | 0 | If set to 1, pinging will be disabled |
| HousekeepingFrequency | No | 1 | The parameter defines how often the daemon must perform housekeeping procedure (in hours). If PostgreSQL is used set the value to 24 as it will perform command VACUUM. |
| FpingLocation | No | /usr/sbin/fping | Location of ICMP pinger. It must have setuid flag set. |
| LogFile | No | - | Name of log file. If not set, syslog is used. |
| NoTimeWait | No | - | Experimental parameter. If set, no sockets in TIME_WAIT state will exist. Works on Free BSD. |
| PidFile | No | /tmp/zabbix_suckerd.pid | Name of file to store PID. |
| PingerFrequency | No | 30 | zabbix_suckerd pings servers once per PingerFrequency seconds. |
| SenderFrequency | No | 30 | The parameter defines how often the daemon must try to send alerts (in seconds) |
| StartSuckers | No | 5 | Number of zabbix_suckerd to start (4-255) |
| Timeout | No | 5 | Do not spend more than Timeout seconds on retrieving requested value (1-255) Note: Example of the configuration file can be found at misc/conf/zabbix_suckerd.conf |
/etc/zabbix/zabbix_agentd.conf
The file contains configuration parameters for zabbix_agentd. The file must exist and it should have read
permissions for user zabbix. Supported parameters:
| Parameter | Mandatory | Default value | Description |
| DBHost | No | localhost | DB host name. |
| DBUser | No | NULL | User name for connecting to the database |
| DebugLevel | No | 3 | Debug level ( 0 - none, 1 - critical, 2 - error, 3 - warnings, 4 - debug) |
| EnableProxy | No | 0 | 0 – request forwarding is prohibited
1 – agent will be able to forward requests |
| ListenIP | No | - | IP address to bind agent to. Useful if the host has multiple interfaces. |
| ListenPort | No | 10000 | Port number to listen |
| LogFile | No | - | Name of log file. If not set, syslog is used. |
| NoTimeWait | No | - | Experimental parameter. If set, no sockets in TIME_WAIT state will exist. Works on FreeBSD. |
| PidFile | No | /tmp/zabbix_suckerd.pid | Name of file to store PID. |
| Server | Yes | - | Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected. |
| StartAgents | No | 5 | Number of agents to start |
| UserParameter | No | - | User-defined parameter to monitor. There can be several user-defined parameters. Value has form ,
Example:UserParameter=users,who|wc -l Note: Example of the configuration file can be found at misc/conf/zabbix_agentd.conf |
| Timeout | No | 3 | Do not spend more that Timeout seconds on getting requested value (1-255). The agent does not kill timeouted User Parameters processes! |
/etc/zabbix/zabbix_agent.conf
The file contains configuration parameters for zabbix_agent. The file must exist and it should have
read permissions for user zabbix. Supported parameters:
| Parameter | Mandatory | Default value | Description |
| Enable Proxy | No | 0 | 0 – request forwarding is prohibited
1 – agent will be able to forward requests |
| Server | Yes | - | Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected. |
| Timeout | No | 3 | Do not spend more that Timeout seconds on getting requested value (1-255). The agent does not kill timeouted User Parameters processes! |
| UserParameter | No | - | User-defined parameter to monitor. There can be several user-defined parameters. Value has form ,
Example:UserParameter=users,who|wc -l |
Note:Example of the configuration file can be found at misc/conf/zabbix_agent.conf
/etc/zabbix/zabbix_trapper.conf
The file contains configuration parameters for zabbix_trapper. The file must exist and it should have read
permissions for user zabbix.
Supported parameters:
| Parameter | Mandatory | Default value | Description |
| DBHost | No | localhost | DB host name. |
| DBName | Yes | - | Database name. Usually “zabbix”. |
| DBPassword | No | NULL | User’s password. If password is not used, then this parameter must be commented. |
| DBSocket | No | - | DB socket name. Used for non-TCP connection to MySQL database. Example: /tmp/mysql.sock |
| DBUser | No | NULL | User name for connecting to the database |
| DebugLevel | No | 3 | Debug level ( 0 - none, 1 - critical, 2 - error, 3 - warnings, 4 - debug) |
| LogFile | No | - | Name of log file. If not set, syslog is used. |
| NoTimeWait | No | - | Experimental parameter. If set, no sockets in TIME_WAIT state will exist. Works on FreeBSD. |
| PidFile | No | /tmp/zabbix_suckerd.pid | Name of file to store PID. |
| Timeout | No | 5 | Do not spend more than Timeout seconds on retrieving requested value (1-255) |
Note:Example of the configuration file can be found at misc/conf/zabbix_trapper.conf
/etc/zabbix/zabbix_trapperd.conf
The file contains configuration parameters for zabbix_trapperd. The file must exist and it should have read permissions for user zabbix.
Supported parameters:
| Parameter | Mandatory | Default value | Description |
| DBConnectOnEach | No | 0 | If 1, zabbix_trapperd will connect to the database on each value received. |
| DBHost | No | localhost | DB host name. |
| DBName | Yes | - | Database name. Usually “zabbix”. |
| DBPassword | No | NULL | User’s password. If password is not used, then this parameter must be commented. |
| DBSocket | No | - | DB socket name. Used for non-TCP connection to MySQL database. Example: /tmp/mysql.sock |
| DBUser | No | NULL | User name for connecting to the database |
| DebugLevel | No | 3 | Debug level ( 0 - none, 1 - critical, 2 - error, 3 - warnings, 4 - debug) |
| ListenPort | No | 10001 | - |
| LogFile | No | - | Name of log file. If not set, syslog is used. |
| NoTimeWait | No | - | Experimental parameter. If set, no sockets in TIME_WAIT state will exist. Works on FreeBSD. |
| PidFile | No | /tmp/zabbix_suckerd.pid | Name of file to store PID. |
| StartTrappers | No | 5 | - |
| Timeout | No | 5 | Do not spend more than Timeout seconds on retrieving requested value (1-255) Note: Example of the configuration file can be found at misc/conf/zabbix_trapperd.conf |
|
Initial