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_server.conf
The file contains configuration parameters for zabbix_server. 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_server.pid | Name of file to store PID. |
|---|
| PingerFrequency | No | 30 | zabbix_server pings servers once per PingerFrequency seconds (1-3600) |
|---|
| SenderFrequency | No | 30 | The parameter defines how often the daemon must try to send alerts (in seconds) |
|---|
| StartPollers | No | 5 | Number of pollers (processes which retrieve data from agents) to start (4-255) |
|---|
| StartTrappers | No | 5 | Number of trappers to start (4-255) |
|---|
| TrapperTimeout | No | 5 | Do not spend more than Timeout seconds on processing of traps (1-255) |
|---|
| ListenPort | No | 10051 | Port number to listen by trapper processes |
|---|
| 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_server.conf |
|---|
| UnavailableDelay | No | 60 | How ofter try to connect to unavailable host |
|---|
| UnreachableDelay | No | 15 | How ofter try to connect to unreachable host |
|---|
| UnreachablePeriod | No | 45 | If a host was unreachable for more than UnreachablePeriod second, change host status to Unavailable |
|---|
/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 |
|---|
| DisableActive | No | 0 | Disable processing of active checks. The agent will not connect to ZABBIX server to get list of active items. |
|---|
| EnableRemoteCommands | No | 0 | Enable remote commans. ZABBIX server will be able to send commands for execution by the agent. |
|---|
| 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
|
|---|
| Hostname | Yes | - | Unique host name. The hostname is used for active checks only. |
|---|
| ListenIP | No | - | IP address to bind agent to. Useful if the host has multiple interfaces. |
|---|
| ListenPort | No | 10050 | 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_agentd.pid | Name of file to store PID. |
|---|
| RefreshActiveChecks | No | 120 | The agent will refresh list of active checks once per 120 (default) seconds. |
|---|
| Server | Yes | - | Comma-delimited list of IP addresses of ZABBIX servers. Connections from other IP addresses will be rejected. |
|---|
| ServerPort | No | 10051 | The agent will connect to this server port for processing active checks. |
|---|
| 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 |
|---|
| 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
|
Advanced