Zabbix-agent and zabbix-proxy configuration
active-server
This command sets the address and port of the Zabbix server for active checks.
The use of a negative form (no) of the command removes server for active checks.
Syntax
active-server <ADDR> [ port <PORT> ]
no active-server
Parameters
<ADDR> – server IP address, defined as AAA.BBB.CCC.DDD where each part takes values of [0..255];
<PORT> – port number, set in the range of [1..65535].
Default value
None
Required privilege level
10
Command mode
CONFIG-ZABBIX-AGENT
Example
esr(config-zabbix-agent)# active-server 192.168.16.54
config-retrieve
This command is used to set the interval for updating configuration data from the server.
The use of a negative form (no) of the command restores the default value.
Syntax
config-retrieve <SEC>
no config-retrieve
Parameters
<SEC> – time interval in seconds, takes values of [1..604800].
Default value
3600
Required privilege level
10
Command mode
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-proxy)# config-retrieve 200
database
This command is used to set the storage location of the zabbix-proxy database.
The use of a negative form (no) of the command sets the default value.
Syntax
database <PATH>
no database
Parameters
<PATH> – zabbix-proxy database storage location.
Default value
By default, the zabbix database is stored in the router volatile memory.
Required privilege level
10
Command mode
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# database flash:data/zabbix.dat
enable
This command enables the functionality of the Zabbix agent.
The use of a negative form (no) of the command disables Zabbix agent functionality.
Syntax
[no] enable
Parameters
None.
Default value
Disabled.
Required privilege level
10
Command mode
CONFIG-ZABBIX-AGENT
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# enable
hostname
This command sets agent name. Hostname must match the hostname in the Zabbix control panel.
The use of a negative form (no) of the command sets the default agent name.
Syntax
hostname <NAME>
no hostname
Parameters
<NAME> – system name identifier, set by the string of up to 255 characters.
Default value
Same as the configured hostname of the router.
Required privilege level
10
Command mode
CONFIG-ZABBIX-AGENT
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# hostname branch_12
port
This command sets the TCP port that will be used for Zabbix server requests to the agent.
The use of a negative form (no) of the command removes the value of TCP port.
Syntax
port <PORT>
[no] port
Parameters
<PORT> – port number, set in the range of [1024..32767].
Default value
None
Required privilege level
10
Command mode
CONFIG-ZABBIX-AGENT
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# port 20050
remote-commands
This command enables the ability to execute commands on the router from the Zabbix server.
The use of a negative form (no) of the command disables the ability to execute commands on the router from the Zabbix server.
Syntax
[no] remote-commands
Parameters
None.
Default value
Disabled.
Required privilege level
15
Command mode
CONFIG-ZABBIX-AGENT
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# remote-commands
server
This command sets the IP address of the Zabbix server for zabbix agent from which incoming connections are allowed.
The use of a negative form (no) of the command removes Zabbix server IP address.
Syntax
server <ADDR>
no server
Parameters
<ADDR> – server IP address, defined as AAA.BBB.CCC.DDD where each part takes values of [0..255].
Default value
None
Required privilege level
10
Command mode
CONFIG-ZABBIX-AGENT
Example
esr(config-zabbix-agent)# server 192.168.18.54
server
This command sets the IP address and port of the Zabbix server for zabbix proxy from which incoming connections are allowed.
The use of a negative form (no) of the command removes Zabbix server configuration for zabbix-proxy.
Syntax
server <ADDR> [port <PORT>]
no server
Parameters
<ADDR> – server IP address, defined as AAA.BBB.CCC.DDD where each part takes values of [0..255];
<PORT> – UDP port number, set in the range of [1024..32767].
Default value
<ADDR> – none;
<PORT> – 10051.
Required privilege level
10
Command mode
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# server 192.168.18.54 port 1285
show zabbix-agent configuration
This command displays the Zabbix agent configuration.
Syntax
show zabbix-agent configuration
Parameters
None.
Required privilege level
1
Command mode
ROOT
Example
esr# show zabbix-agent configuration
VRF: --
State: Enabled
Active server: --
Active server port: --
Hostname: esr
Port: --
Remote commands: Disabled
Server: 192.168.18.54
Source address: --
Timeout: 3
show zabbix-proxy configuration
This command displays the Zabbix proxy configuration.
Syntax
show zabbix-proxy configuration
Parameters
None.
Required privilege level
1
Command mode
ROOT
Example
esr# show zabbix-proxy configuration
VRF: --
State: Enabled
Hostname: ESR-10SLA
Port: --
Remote commands: Enabled
Server: 192.168.32.228
Server port: --
Source address: --
Timeout: 3
Configuration retrieve: 30
source-address
This command specifies the address from which the connection to the Zabbix server will be established.
The use of a negative form (no) of the command sets the default value.
Syntax
source-address <ADDR>
no source-address
Parameters
<ADDR> – IP address, defined as AAA.BBB.CCC.DDD where each part takes values of [0..255];
Default value
IP address of the interface from which NTP packet is sent.
Required privilege level
10
Command mode
CONFIG-ZABBIX-AGENT
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# source-address 192.168.1.57
timeout
This command sets the maximum time for processing a Zabbiz-server request.
The use of a negative form (no) of the command sets the default value.
Syntax
timeout
no timeout
Parameters
<SEC> – time interval in seconds, takes values of [1..30].
Default value
3
Required privilege level
10
Command mode
CONFIG-ZABBIX-AGENT
CONFIG-ZABBIX-PROXY
Example
esr(config-zabbix-agent)# timeout 20
zabbix-agent
This command switches to the configuration mode of the Zabbix agent in global mode or VRF.
The use of a negative form (no) of the command removes the Zabbix agent settings in global mode or VRF.
Syntax
[no] zabbix-agent [ vrf <VRF> ]
Parameters
<VRF> – VRF instance name, set by the string of up to 31 characters.
Default value
Disabled.
Required privilege level
10
Command mode
CONFIG
Example
esr(config)# zabbix-agent
zabbix-proxy
This command switches to the configuration mode of the Zabbix proxy in global mode or VRF.
The use of a negative form (no) of the command removes the Zabbix proxy settings in global mode or VRF.
Syntax
[no] zabbix-proxy [ vrf <VRF> ]
Parameters
<VRF> – VRF instance name, set by the string of up to 31 characters;
Default value
None
Required privilege level
10
Command mode
CONFIG
Example
esr(config)# zabbix-proxy