Monitor OPNsense with Zabbix: Complete Template Installation Guide

Template Download

OPNsense is a fork of pfSense with the same infrastructure. To monitor OPNsense with Zabbix, use the pfSense template available from the GitHub repository.

Import the Template

Import zbx_template_pfsense.xml into Zabbix Server.

Add OPNsense Group

Create a host group for OPNsense devices.

Enable Zabbix Agent on OPNsense

Navigate to System → Firmware → Plugins , locate the os‑zabbix‑agent plugin and click the + button to install.

Execute the installation and restart the agent after configuration.

Configure Zabbix Agent

Go to Services → Zabbix Agent and set the required parameters, then restart the agent.

Test Agent Connectivity

telnet 192.168.99.55 10050

zabbix_get -s 192.168.99.55 -k agent.ping

Add Custom Agent Commands

Edit /usr/local/etc/zabbix_agentd.conf.d/opnsense_zabbix.conf and add the following UserParameter definitions:

vi /usr/local/etc/zabbix_agentd.conf.d/opnsense_zabbix.conf</code>
<code>UserParameter=pfsense.states.max,grep "limit states" /tmp/rules.limits | cut -f4 -d ' '</code>
<code>UserParameter=pfsense.states.current,grep "current entries" /tmp/pfctl_si_out | tr -s ' ' | cut -f4 -d ' '</code>
<code>UserParameter=pfsense.mbuf.current,netstat -m | grep "mbuf clusters" | cut -f1 -d ' ' | cut -d '/' -f1</code>
<code>UserParameter=pfsense.mbuf.cache,netstat -m | grep "mbuf clusters" | cut -f1 -d ' ' | cut -d '/' -f2</code>
<code>UserParameter=pfsense.mbuf.max,netstat -m | grep "mbuf clusters" | cut -f1 -d ' ' | cut -d '/' -f4

Test Custom Parameters

zabbix_get -s 192.168.99.55 -k pfsense.states.current</code>
<code>5</code>
<code>zabbix_get -s 192.168.99.55 -k pfsense.mbuf.current</code>
<code>541</code>
<code>zabbix_get -s 192.168.99.55 -k pfsense.mbuf.cache</code>
<code>729</code>
<code>zabbix_get -s 192.168.99.55 -k pfsense.mbuf.max</code>
<code>125376

Zabbix Server Configuration

Add a new host for the OPNsense device and attach the imported template.

After applying the template, the host appears online and starts showing data.

Latest monitoring data is displayed in the Zabbix dashboard.