Page MenuHomeVyOS Platform

Native Zabbix Support
Open, WishlistPublicFEATURE REQUEST


We need to implement native support for Zabbix
like configuration via CLI and corresponding templates for Zabbix
so no additional software installation needed


Difficulty level
Hard (possibly days)
Is it a breaking change?
Perfectly compatible

Related Objects

Event Timeline

syncer created this object with edit policy "Administrators".

@higebu seems correct.
It will be a good start

I've update installation manual of Zabbix agent for VyOS 1.2
It is easier to maintain now because of using of standard Jessie repository.
Only VyOS scripts should be maintained.

Original implementation is running good both on 1.1.8 and 1.2

I made zabbix-agent and zabbix-proxy support in 1.2, could someone watch on it? Is it ok or not?
(I have no github, only local copy, could we discuss it on russian in telegram?)

syncer changed the subtype of this task from "Task" to "Feature Request".Oct 19 2018, 9:14 AM

To install the zabbix-agent (for rolling) you need:

dpkg -i zabbix-agent_4.0.17-2%2Bbuster_amd64.deb

The minimal configuration which are needed.
Specify ip address of server (ip zabbix-server) and active server (ip zabbix-server):

root@vyos:/home/sever# cat /etc/zabbix/zabbix_agentd.conf | egrep -v "#|^$"
Hostname=Zabbix server

Minimal commands :

set service zabbix-agent server
set service zabbix-agent server-active

Minimal Xml:

<?xml version="1.0"?>
<!-- Zabbix-agent configuration -->
  <node name="service">
      <node name="zabbix-agent" owner="${vyos_conf_scripts_dir}/">
          <help>Zabbix-agent settings</help>
          <leafNode name="server">
              <help>x.x.x.x ipv4 address of the zabbix-server</help>
                <description>Address zabbix-server</description>
                <validator name="ipv4-address"/>
          <leafNode name="server-active">
              <help>x.x.x.x ipv4 address for active-checks</help>
                <description>Address zabbix-server-active</description>
                <validator name="ipv4-address"/>
sever@vyos:~$ sudo systemctl status zabbix-agent
● zabbix-agent.service - Zabbix Agent
   Loaded: loaded (/lib/systemd/system/zabbix-agent.service; disabled; vendor preset: enabled)
   Active: active (running) since Sat 2020-02-01 20:31:10 UTC; 13h ago
 Main PID: 2609 (zabbix_agentd)
    Tasks: 6 (limit: 549)
   Memory: 6.6M
   CGroup: /system.slice/zabbix-agent.service
           ├─2609 /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf
           ├─2611 /usr/sbin/zabbix_agentd: collector [idle 1 sec]
           ├─2612 /usr/sbin/zabbix_agentd: listener #1 [waiting for connection]
           ├─2613 /usr/sbin/zabbix_agentd: listener #2 [waiting for connection]
           ├─2614 /usr/sbin/zabbix_agentd: listener #3 [waiting for connection]
           └─2615 /usr/sbin/zabbix_agentd: active checks #1 [idle 1 sec]

Feb 01 20:31:10 vyos systemd[1]: Starting Zabbix Agent...
Feb 01 20:31:10 vyos systemd[1]: zabbix-agent.service: Can't open PID file /run/zabbix/ (yet?) after start: No such file or directory
Feb 01 20:31:10 vyos systemd[1]: Started Zabbix Agent.

Can someone write a python handler?

@Viacheslav let's discuss
I think we need to implement template for the server (both SNMP based and agent-based)
Need to decide what we expose, but most likely, interfaces, VRRP, VPN metrics, etc
I also add this to collect user feedback

@syncer One thing to consider. If dynamic interfaces are used and there are several thousand of them (ipoe/ppp), this will kill the server, if we try to pull this data.

good point,
probably need to handle this via excluding such interfaces

Template for zabbix-server on base zabbix-agent checks (without SNMP).
Dynamically creates items and some graphs for:

  • CPU
  • Memory
  • Cpu Cores
  • Interfaces rate bps/pps
  • Interfaces drops/errors
  • State some services (OpenVPN/VRRP)
  • Conntrack entries (used for nat)

Next step - create Template for SNMP checks.
Maybe add information about bgp/state neighbors?


ListenIP : List of comma delimited IP addresses that the agent should listen on. -> allow multiple ips.
Server/ServerActive: Multiple comma-delimited addresses can be provided to use several independent Zabbix servers in parallel -> allow multiple servers
UserParameter: User-defined parameter to monitor.

Template VyOS for Zabbix 4.x version with SNMPv2 checks.
No need to install any additional programs.

Low level discovery (lld) for interfaces and their aliases.
Memory/CPU Utilization
VRRP state changes
BGP neighbors autodiscovery

high CPU utilization
low RAM memory
VRRP state was changed
BGP neighbor state not established.

dmbaturin set Version to 1.2.
dmbaturin set Is it a breaking change? to Perfectly compatible.
dmbaturin removed subscribers: VyOS 2.0.x, VyOS 1.2 Crux.