VOOZH about

URL: https://www.zabbix.com/integrations/pfsense

⇱ pfSense monitoring and integration with Zabbix


Propose integration

pfSense

pfSense is a firewall/router computer software distribution based on FreeBSD. The open source pfSense Community Edition and pfSense Plus is installed on a physical computer or a virtual machine to make a dedicated firewall/router for a network.

Available solutions




This template is for Zabbix version: 7.4

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/7.4

PFSense by SNMP

Overview

Template for monitoring pfSense by SNMP

Requirements

Zabbix version: 7.4 and higher.

Tested versions

This template has been tested on:

  • pfSense 2.5.0, 2.5.1, 2.5.2, 2.7.2

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Macros used

Name Description Default
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status.

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

(^pflog[0-9.]*$|^pfsync[0-9.]*$)
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6).

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90

Items

Name Description Type Key and additional info
SNMP walk network interfaces

Discovering interfaces from IF-MIB.

SNMP agent net.if.walk
SNMP walk pf network interfaces

MIB: BEGEMOT-PF-MIB

SNMP walk through pfInterfacesIfTable. The collected data used in network interfaces LLD for dependent item prototypes.

SNMP agent net.if.pf.walk

Preprocessing

  • SNMP walk to JSON

SNMP walk software

MIB: HOST-RESOURCES-MIB

SNMP walk through hrSWRunTable. The collected data used in dependent service status items.

SNMP agent pfsense.sw.walk

Preprocessing

  • SNMP walk to JSON

SNMP walk pf counters

MIB: BEGEMOT-PF-MIB

SNMP walk through pfCounter. The collected data used in dependent pf counter items.

SNMP agent pfsense.pf_counters.walk
SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible values:

0 - not available

1 - available

2 - unknown

Zabbix internal zabbix[host,snmp,available]
Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled.

SNMP agent pfsense.pf.status
States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP agent pfsense.state.table.count
States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP agent pfsense.state.table.limit
States table utilization in %

Utilization of state table in %.

Calculated pfsense.state.table.pused
Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP agent pfsense.source.tracking.table.count
Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP agent pfsense.source.tracking.table.limit
Source tracking table utilization in %

Utilization of source tracking table in %.

Calculated pfsense.source.tracking.table.pused
DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

Dependent item pfsense.dhcpd.status

Preprocessing

  • JSON Path: $[?(@.hrSWRunName == 'dhcpd')].hrSWRunStatus.first()

    ⛔️Custom on fail: Set value to: 0

DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

Dependent item pfsense.dns.status

Preprocessing

  • JSON Path: $[?(@.hrSWRunName == 'unbound')].hrSWRunStatus.first()

    ⛔️Custom on fail: Set value to: 0

State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

Dependent item pfsense.nginx.status

Preprocessing

  • JSON Path: $[?(@.hrSWRunName == 'nginx')].hrSWRunStatus.first()

    ⛔️Custom on fail: Set value to: 0

Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.match

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.1.0

  • Change per second
Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.bad.offset

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.2.0

  • Change per second
Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.fragment

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.3.0

  • Change per second
Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.short

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.4.0

  • Change per second
Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.normalize

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.5.0

  • Change per second
Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.mem.drop

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.6.0

  • Change per second
Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP agent pfsense.rules.count

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

max(/PFSense by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 Warning
PFSense: Packet filter is not running

Please check PF status.

last(/PFSense by SNMP/pfsense.pf.status)<>1 High
PFSense: State table usage is high

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

min(/PFSense by SNMP/pfsense.state.table.pused,#3)>{$STATE.TABLE.UTIL.MAX} Warning
PFSense: Source tracking table usage is high

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

min(/PFSense by SNMP/pfsense.source.tracking.table.pused,#3)>{$SOURCE.TRACKING.TABLE.UTIL.MAX} Warning
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

last(/PFSense by SNMP/pfsense.dhcpd.status)=0 Average
PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

last(/PFSense by SNMP/pfsense.dns.status)=0 Average
PFSense: Web server is not running

Please check nginx service status.

last(/PFSense by SNMP/pfsense.nginx.status)=0 Average

LLD rule Network interfaces discovery

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

Dependent item pfsense.net.if.discovery

Preprocessing

  • SNMP walk to JSON

  • Discard unchanged with heartbeat: 1h

Item prototypes for Network interfaces discovery

Name Description Type Key and additional info
Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.in.discards[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.13.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.in.errors[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.14.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.in[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.31.1.1.1.6.{#SNMPINDEX}

  • Change per second:
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.out.discards[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.19.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.out.errors[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.20.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.out[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.31.1.1.1.10.{#SNMPINDEX}

  • Change per second:
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

Dependent item net.if.speed[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.31.1.1.1.15.{#SNMPINDEX}

  • Custom multiplier: 1000000

  • Discard unchanged with heartbeat: 1h

Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

Dependent item net.if.status[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.8.{#SNMPINDEX}

  • Discard unchanged with heartbeat: 6h

Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

Dependent item net.if.type[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.3.{#SNMPINDEX}

  • Discard unchanged with heartbeat: 6h

Interface [{#IFNAME}({#IFALIAS})]: Rules references count

MIB: BEGEMOT-PF-MIB

The number of rules referencing this interface.

Dependent item net.if.rules.refs[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

Dependent item net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

Dependent item net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

Dependent item net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

Dependent item net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

Dependent item net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

Dependent item net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

Dependent item net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

Dependent item net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

Dependent item net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

Dependent item net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

Dependent item net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

Dependent item net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

Dependent item net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

Dependent item net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

Dependent item net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

Dependent item net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second

Trigger prototypes for Network interfaces discovery

Name Description Expression Severity Dependencies and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High input error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.in.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.in[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High output error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.out.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.out[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Acknowledge to close the problem manually.

change(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])<>2) Info Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

This trigger expression works as follows:
1. It can be triggered if the operations status is down.
2. { $IFCONTROL:"{#IFNAME}" }=1 - a user can redefine context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])=2) Average

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums

This template is for Zabbix version: 7.2

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/7.2

PFSense by SNMP

Overview

Template for monitoring pfSense by SNMP

Requirements

Zabbix version: 7.2 and higher.

Tested versions

This template has been tested on:

  • pfSense 2.5.0, 2.5.1, 2.5.2

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Macros used

Name Description Default
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status.

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

(^pflog[0-9.]*$|^pfsync[0-9.]*$)
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6).

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90

Items

Name Description Type Key and additional info
SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible values:

0 - not available

1 - available

2 - unknown

Zabbix internal zabbix[host,snmp,available]
Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled.

SNMP agent pfsense.pf.status
States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP agent pfsense.state.table.count
States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP agent pfsense.state.table.limit
States table utilization in %

Utilization of state table in %.

Calculated pfsense.state.table.pused
Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP agent pfsense.source.tracking.table.count
Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP agent pfsense.source.tracking.table.limit
Source tracking table utilization in %

Utilization of source tracking table in %.

Calculated pfsense.source.tracking.table.pused
DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

SNMP agent pfsense.dhcpd.status

Preprocessing

  • Check for not supported value: any error

    ⛔️Custom on fail: Set value to: 0

DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

SNMP agent pfsense.dns.status

Preprocessing

  • Check for not supported value: any error

    ⛔️Custom on fail: Set value to: 0

State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

SNMP agent pfsense.nginx.status

Preprocessing

  • Check for not supported value: any error

    ⛔️Custom on fail: Set value to: 0

Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.match

Preprocessing

  • Change per second
Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.bad.offset

Preprocessing

  • Change per second
Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.fragment

Preprocessing

  • Change per second
Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.short

Preprocessing

  • Change per second
Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.normalize

Preprocessing

  • Change per second
Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.mem.drop

Preprocessing

  • Change per second
Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP agent pfsense.rules.count

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

max(/PFSense by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 Warning
PFSense: Packet filter is not running

Please check PF status.

last(/PFSense by SNMP/pfsense.pf.status)<>1 High
PFSense: State table usage is high

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

min(/PFSense by SNMP/pfsense.state.table.pused,#3)>{$STATE.TABLE.UTIL.MAX} Warning
PFSense: Source tracking table usage is high

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

min(/PFSense by SNMP/pfsense.source.tracking.table.pused,#3)>{$SOURCE.TRACKING.TABLE.UTIL.MAX} Warning
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

last(/PFSense by SNMP/pfsense.dhcpd.status)=0 Average
PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

last(/PFSense by SNMP/pfsense.dns.status)=0 Average
PFSense: Web server is not running

Please check nginx service status.

last(/PFSense by SNMP/pfsense.nginx.status)=0 Average

LLD rule Network interfaces discovery

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

SNMP agent pfsense.net.if.discovery

Item prototypes for Network interfaces discovery

Name Description Type Key and additional info
Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in.discards[{#SNMPINDEX}]

Preprocessing

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in.errors[{#SNMPINDEX}]

Preprocessing

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in[{#SNMPINDEX}]

Preprocessing

  • Change per second:
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out.discards[{#SNMPINDEX}]

Preprocessing

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out.errors[{#SNMPINDEX}]

Preprocessing

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out[{#SNMPINDEX}]

Preprocessing

  • Change per second:
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

SNMP agent net.if.speed[{#SNMPINDEX}]

Preprocessing

  • Custom multiplier: 1000000

  • Discard unchanged with heartbeat: 1h

Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

SNMP agent net.if.status[{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 6h

Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

SNMP agent net.if.type[{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 6h

Interface [{#IFNAME}({#IFALIAS})]: Rules references count

MIB: BEGEMOT-PF-MIB

The number of rules referencing this interface.

SNMP agent net.if.rules.refs[{#SNMPINDEX}]
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

SNMP agent net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

SNMP agent net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

SNMP agent net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

SNMP agent net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

SNMP agent net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

SNMP agent net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

SNMP agent net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

SNMP agent net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

SNMP agent net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

SNMP agent net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

SNMP agent net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

SNMP agent net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

SNMP agent net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

SNMP agent net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

SNMP agent net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

SNMP agent net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second

Trigger prototypes for Network interfaces discovery

Name Description Expression Severity Dependencies and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High input error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.in.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.in[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High output error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.out.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.out[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Acknowledge to close the problem manually.

change(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])<>2) Info Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

This trigger expression works as follows:
1. It can be triggered if the operations status is down.
2. {$IFCONTROL:"{#IFNAME}"}=1 - a user can redefine context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])=2) Average

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums

This template is for Zabbix version: 7.0

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/7.0

PFSense by SNMP

Overview

Template for monitoring pfSense by SNMP

Requirements

Zabbix version: 7.0 and higher.

Tested versions

This template has been tested on:

  • pfSense 2.5.0, 2.5.1, 2.5.2, 2.7.2

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Macros used

Name Description Default
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status.

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

(^pflog[0-9.]*$|^pfsync[0-9.]*$)
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6).

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90

Items

Name Description Type Key and additional info
SNMP walk network interfaces

Discovering interfaces from IF-MIB.

SNMP agent net.if.walk
SNMP walk pf network interfaces

MIB: BEGEMOT-PF-MIB

SNMP walk through pfInterfacesIfTable. The collected data used in network interfaces LLD for dependent item prototypes.

SNMP agent net.if.pf.walk

Preprocessing

  • SNMP walk to JSON

SNMP walk software

MIB: HOST-RESOURCES-MIB

SNMP walk through hrSWRunTable. The collected data used in dependent service status items.

SNMP agent pfsense.sw.walk

Preprocessing

  • SNMP walk to JSON

SNMP walk pf counters

MIB: BEGEMOT-PF-MIB

SNMP walk through pfCounter. The collected data used in dependent pf counter items.

SNMP agent pfsense.pf_counters.walk
SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible values:

0 - not available

1 - available

2 - unknown

Zabbix internal zabbix[host,snmp,available]
Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled.

SNMP agent pfsense.pf.status
States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP agent pfsense.state.table.count
States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP agent pfsense.state.table.limit
States table utilization in %

Utilization of state table in %.

Calculated pfsense.state.table.pused
Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP agent pfsense.source.tracking.table.count
Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP agent pfsense.source.tracking.table.limit
Source tracking table utilization in %

Utilization of source tracking table in %.

Calculated pfsense.source.tracking.table.pused
DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

Dependent item pfsense.dhcpd.status

Preprocessing

  • JSON Path: $[?(@.hrSWRunName == 'dhcpd')].hrSWRunStatus.first()

    ⛔️Custom on fail: Set value to: 0

DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

Dependent item pfsense.dns.status

Preprocessing

  • JSON Path: $[?(@.hrSWRunName == 'unbound')].hrSWRunStatus.first()

    ⛔️Custom on fail: Set value to: 0

State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

Dependent item pfsense.nginx.status

Preprocessing

  • JSON Path: $[?(@.hrSWRunName == 'nginx')].hrSWRunStatus.first()

    ⛔️Custom on fail: Set value to: 0

Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.match

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.1.0

  • Change per second
Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.bad.offset

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.2.0

  • Change per second
Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.fragment

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.3.0

  • Change per second
Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.short

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.4.0

  • Change per second
Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.normalize

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.5.0

  • Change per second
Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

Dependent item pfsense.packets.mem.drop

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.12325.1.200.1.2.6.0

  • Change per second
Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP agent pfsense.rules.count

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

max(/PFSense by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 Warning
PFSense: Packet filter is not running

Please check PF status.

last(/PFSense by SNMP/pfsense.pf.status)<>1 High
PFSense: State table usage is high

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

min(/PFSense by SNMP/pfsense.state.table.pused,#3)>{$STATE.TABLE.UTIL.MAX} Warning
PFSense: Source tracking table usage is high

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

min(/PFSense by SNMP/pfsense.source.tracking.table.pused,#3)>{$SOURCE.TRACKING.TABLE.UTIL.MAX} Warning
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

last(/PFSense by SNMP/pfsense.dhcpd.status)=0 Average
PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

last(/PFSense by SNMP/pfsense.dns.status)=0 Average
PFSense: Web server is not running

Please check nginx service status.

last(/PFSense by SNMP/pfsense.nginx.status)=0 Average

LLD rule Network interfaces discovery

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

Dependent item pfsense.net.if.discovery

Preprocessing

  • SNMP walk to JSON

  • Discard unchanged with heartbeat: 1h

Item prototypes for Network interfaces discovery

Name Description Type Key and additional info
Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.in.discards[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.13.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.in.errors[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.14.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.in[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.31.1.1.1.6.{#SNMPINDEX}

  • Change per second:
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.out.discards[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.19.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.out.errors[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.20.{#SNMPINDEX}

  • Change per second:
Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

Dependent item net.if.out[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.31.1.1.1.10.{#SNMPINDEX}

  • Change per second:
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

Dependent item net.if.speed[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.31.1.1.1.15.{#SNMPINDEX}

  • Custom multiplier: 1000000

  • Discard unchanged with heartbeat: 1h

Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

Dependent item net.if.status[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.8.{#SNMPINDEX}

  • Discard unchanged with heartbeat: 6h

Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

Dependent item net.if.type[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.3.{#SNMPINDEX}

  • Discard unchanged with heartbeat: 6h

Interface [{#IFNAME}({#IFALIAS})]: Rules references count

MIB: BEGEMOT-PF-MIB

The number of rules referencing this interface.

Dependent item net.if.rules.refs[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

Dependent item net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

Dependent item net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

Dependent item net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

Dependent item net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

Dependent item net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

Dependent item net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

Dependent item net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

Dependent item net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

Dependent item net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

Dependent item net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

Dependent item net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

Dependent item net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
  • Custom multiplier: 8

Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

Dependent item net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

Dependent item net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

Dependent item net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second
Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

Dependent item net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • JSON Path: The text is too long. Please see the template.

  • Change per second

Trigger prototypes for Network interfaces discovery

Name Description Expression Severity Dependencies and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High input error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.in.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.in[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High output error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.out.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.out[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Acknowledge to close the problem manually.

change(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])<>2) Info Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

This trigger expression works as follows:
1. It can be triggered if the operations status is down.
2. { $IFCONTROL:"{#IFNAME}" }=1 - a user can redefine context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])=2) Average

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums

This template is for Zabbix version: 6.4

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/6.4

PFSense by SNMP

Overview

Template for monitoring pfSense by SNMP

Requirements

Zabbix version: 6.4 and higher.

Tested versions

This template has been tested on:

  • pfSense 2.5.0, 2.5.1, 2.5.2

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Macros used

Name Description Default
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status.

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

(^pflog[0-9.]*$|^pfsync[0-9.]*$)
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6).

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90

Items

Name Description Type Key and additional info
PFSense: SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible value:

0 - not available

1 - available

2 - unknown

Zabbix internal zabbix[host,snmp,available]
PFSense: Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled.

SNMP agent pfsense.pf.status
PFSense: States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP agent pfsense.state.table.count
PFSense: States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP agent pfsense.state.table.limit
PFSense: States table utilization in %

Utilization of state table in %.

Calculated pfsense.state.table.pused
PFSense: Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP agent pfsense.source.tracking.table.count
PFSense: Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP agent pfsense.source.tracking.table.limit
PFSense: Source tracking table utilization in %

Utilization of source tracking table in %.

Calculated pfsense.source.tracking.table.pused
PFSense: DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

SNMP agent pfsense.dhcpd.status

Preprocessing

  • Check for not supported value:

    ⛔️Custom on fail: Set value to: 0

PFSense: DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

SNMP agent pfsense.dns.status

Preprocessing

  • Check for not supported value:

    ⛔️Custom on fail: Set value to: 0

PFSense: State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

SNMP agent pfsense.nginx.status

Preprocessing

  • Check for not supported value:

    ⛔️Custom on fail: Set value to: 0

PFSense: Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.match

Preprocessing

  • Change per second
PFSense: Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.bad.offset

Preprocessing

  • Change per second
PFSense: Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.fragment

Preprocessing

  • Change per second
PFSense: Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.short

Preprocessing

  • Change per second
PFSense: Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.normalize

Preprocessing

  • Change per second
PFSense: Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.mem.drop

Preprocessing

  • Change per second
PFSense: Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP agent pfsense.rules.count

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

max(/PFSense by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 Warning
PFSense: Packet filter is not running

Please check PF status.

last(/PFSense by SNMP/pfsense.pf.status)<>1 High
PFSense: State table usage is high

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

min(/PFSense by SNMP/pfsense.state.table.pused,#3)>{$STATE.TABLE.UTIL.MAX} Warning
PFSense: Source tracking table usage is high

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

min(/PFSense by SNMP/pfsense.source.tracking.table.pused,#3)>{$SOURCE.TRACKING.TABLE.UTIL.MAX} Warning
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

last(/PFSense by SNMP/pfsense.dhcpd.status)=0 Average
PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

last(/PFSense by SNMP/pfsense.dns.status)=0 Average
PFSense: Web server is not running

Please check nginx service status.

last(/PFSense by SNMP/pfsense.nginx.status)=0 Average

LLD rule Network interfaces discovery

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

SNMP agent pfsense.net.if.discovery

Item prototypes for Network interfaces discovery

Name Description Type Key and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in.discards[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in.errors[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in[{#SNMPINDEX}]

Preprocessing

  • Change per second:
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out.discards[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out.errors[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out[{#SNMPINDEX}]

Preprocessing

  • Change per second:
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

SNMP agent net.if.speed[{#SNMPINDEX}]

Preprocessing

  • Custom multiplier: 1000000

  • Discard unchanged with heartbeat: 1h

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

SNMP agent net.if.status[{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 6h

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

SNMP agent net.if.type[{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 6h

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Rules references count

MIB: BEGEMOT-PF-MIB

The number of rules referencing this interface.

SNMP agent net.if.rules.refs[{#SNMPINDEX}]
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

SNMP agent net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

SNMP agent net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

SNMP agent net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

SNMP agent net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

SNMP agent net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

SNMP agent net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

SNMP agent net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

SNMP agent net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

SNMP agent net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

SNMP agent net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

SNMP agent net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

SNMP agent net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

SNMP agent net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

SNMP agent net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

SNMP agent net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

SNMP agent net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second

Trigger prototypes for Network interfaces discovery

Name Description Expression Severity Dependencies and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High input error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.in.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.in[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High output error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.out.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.out[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Acknowledge to close the problem manually.

change(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])<>2) Info Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

This trigger expression works as follows:
1. It can be triggered if the operations status is down.
2. {$IFCONTROL:"{#IFNAME}"}=1 - a user can redefine context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])=2) Average

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums

This template is for Zabbix version: 6.2

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/6.2

PFSense by SNMP

Overview

For Zabbix version: 6.2 and higher. Template for monitoring pfSense by SNMP

This template was tested on:

  • pfSense, version 2.5.0, 2.5.1, 2.5.2

Setup

See Zabbix template operation for basic instructions.

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Zabbix configuration

No specific Zabbix configuration is required.

Macros used

Name Description Default
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

`(^pflog[0-9.]*$
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6)

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90

Template links

There are no template links in this template.

Discovery rules

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

SNMP pfsense.net.if.discovery

Filter:

AND

- {#IFADMINSTATUS} MATCHES_REGEX {$NET.IF.IFADMINSTATUS.MATCHES}

- {#IFADMINSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFADMINSTATUS.NOT_MATCHES}

- {#IFOPERSTATUS} MATCHES_REGEX {$NET.IF.IFOPERSTATUS.MATCHES}

- {#IFOPERSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFOPERSTATUS.NOT_MATCHES}

- {#IFNAME} MATCHES_REGEX @Network interfaces for discovery

- {#IFNAME} NOT_MATCHES_REGEX {$NET.IF.IFNAME.NOT_MATCHES}

- {#IFDESCR} MATCHES_REGEX {$NET.IF.IFDESCR.MATCHES}

- {#IFDESCR} NOT_MATCHES_REGEX {$NET.IF.IFDESCR.NOT_MATCHES}

- {#IFALIAS} MATCHES_REGEX {$NET.IF.IFALIAS.MATCHES}

- {#IFALIAS} NOT_MATCHES_REGEX {$NET.IF.IFALIAS.NOT_MATCHES}

- {#IFTYPE} MATCHES_REGEX {$NET.IF.IFTYPE.MATCHES}

- {#IFTYPE} NOT_MATCHES_REGEX {$NET.IF.IFTYPE.NOT_MATCHES}

Items collected

Group Name Description Type Key and additional info
Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in.discards[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in.errors[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out.discards[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out.errors[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

SNMP net.if.speed[{#SNMPINDEX}]

Preprocessing:

- MULTIPLIER: 1000000

- DISCARD_UNCHANGED_HEARTBEAT: 1h

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

SNMP net.if.status[{#SNMPINDEX}]

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

SNMP net.if.type[{#SNMPINDEX}]

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Rules references count

MIB: BEGEMOT-PF-MIB

The number of rules referencing this interface.

SNMP net.if.rules.refs[{#SNMPINDEX}]
Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

SNMP net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

SNMP net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

SNMP net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

SNMP net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

SNMP net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

SNMP net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

SNMP net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

SNMP net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

SNMP net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

SNMP net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

SNMP net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

SNMP net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

SNMP net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

SNMP net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

SNMP net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

SNMP net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled.

SNMP pfsense.pf.status
pfSense PFSense: States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP pfsense.state.table.count
pfSense PFSense: States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP pfsense.state.table.limit
pfSense PFSense: States table utilization in %

Utilization of state table in %.

CALCULATED pfsense.state.table.pused

Expression:

last(//pfsense.state.table.count) * 100 / last(//pfsense.state.table.limit)
pfSense PFSense: Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP pfsense.source.tracking.table.count
pfSense PFSense: Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP pfsense.source.tracking.table.limit
pfSense PFSense: Source tracking table utilization in %

Utilization of source tracking table in %.

CALCULATED pfsense.source.tracking.table.pused

Expression:

last(//pfsense.source.tracking.table.count) * 100 / last(//pfsense.source.tracking.table.limit)
pfSense PFSense: DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

SNMP pfsense.dhcpd.status

Preprocessing:

- CHECK_NOT_SUPPORTED: ``

⛔️ON_FAIL: CUSTOM_VALUE -> 0

pfSense PFSense: DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

SNMP pfsense.dns.status

Preprocessing:

- CHECK_NOT_SUPPORTED: ``

⛔️ON_FAIL: CUSTOM_VALUE -> 0

pfSense PFSense: State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

SNMP pfsense.nginx.status

Preprocessing:

- CHECK_NOT_SUPPORTED: ``

⛔️ON_FAIL: CUSTOM_VALUE -> 0

pfSense PFSense: Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.match

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.bad.offset

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.fragment

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.short

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.normalize

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.mem.drop

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP pfsense.rules.count
Status PFSense: SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible value:

0 - not available

1 - available

2 - unknown

INTERNAL zabbix[host,snmp,available]

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High input error rate

Recovers when below 80% of {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.in.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"}

Recovery expression:

max(/PFSense by SNMP/net.if.in.errors[{#SNMPINDEX}],5m)<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage

The network interface utilization is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.in[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0

Recovery expression:

avg(/PFSense by SNMP/net.if.in[{#SNMPINDEX}],15m)<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: High output error rate

Recovers when below 80% of {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.out.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"}

Recovery expression:

max(/PFSense by SNMP/net.if.out.errors[{#SNMPINDEX}],5m)<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage

The network interface utilization is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.out[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0

Recovery expression:

avg(/PFSense by SNMP/net.if.out[{#SNMPINDEX}],15m)<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Ack to close.

change(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])<>2)

Recovery expression:

(change(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}],#2)>0) or (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])=2)
INFO

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

This trigger expression works as follows:

1. Can be triggered if operations status is down.

2. {$IFCONTROL:"{#IFNAME}"}=1 - user can redefine Context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])=2) AVERAGE
PFSense: Packet filter is not running

Please check PF status.

last(/PFSense by SNMP/pfsense.pf.status)<>1 HIGH
PFSense: State table usage is high

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

min(/PFSense by SNMP/pfsense.state.table.pused,#3)>{$STATE.TABLE.UTIL.MAX} WARNING
PFSense: Source tracking table usage is high

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

min(/PFSense by SNMP/pfsense.source.tracking.table.pused,#3)>{$SOURCE.TRACKING.TABLE.UTIL.MAX} WARNING
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

last(/PFSense by SNMP/pfsense.dhcpd.status)=0 AVERAGE
PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

last(/PFSense by SNMP/pfsense.dns.status)=0 AVERAGE
PFSense: Web server is not running

Please check nginx service status.

last(/PFSense by SNMP/pfsense.nginx.status)=0 AVERAGE
PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

max(/PFSense by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 WARNING

Feedback

Please report any issues with the template at https://support.zabbix.com.

This template is for Zabbix version: 6.0

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/6.0

PFSense by SNMP

Overview

Template for monitoring pfSense by SNMP

Requirements

Zabbix version: 6.0 and higher.

Tested versions

This template has been tested on:

  • pfSense 2.5.0, 2.5.1, 2.5.2

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Macros used

Name Description Default
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status.

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

(^pflog[0-9.]*$|^pfsync[0-9.]*$)
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6).

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90

Items

Name Description Type Key and additional info
PFSense: SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible value:

0 - not available

1 - available

2 - unknown

Zabbix internal zabbix[host,snmp,available]
PFSense: Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled.

SNMP agent pfsense.pf.status
PFSense: States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP agent pfsense.state.table.count
PFSense: States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP agent pfsense.state.table.limit
PFSense: States table utilization in %

Utilization of state table in %.

Calculated pfsense.state.table.pused
PFSense: Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP agent pfsense.source.tracking.table.count
PFSense: Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP agent pfsense.source.tracking.table.limit
PFSense: Source tracking table utilization in %

Utilization of source tracking table in %.

Calculated pfsense.source.tracking.table.pused
PFSense: DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

SNMP agent pfsense.dhcpd.status

Preprocessing

  • Check for not supported value:

    ⛔️Custom on fail: Set value to: 0

PFSense: DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

SNMP agent pfsense.dns.status

Preprocessing

  • Check for not supported value:

    ⛔️Custom on fail: Set value to: 0

PFSense: State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

SNMP agent pfsense.nginx.status

Preprocessing

  • Check for not supported value:

    ⛔️Custom on fail: Set value to: 0

PFSense: Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.match

Preprocessing

  • Change per second
PFSense: Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.bad.offset

Preprocessing

  • Change per second
PFSense: Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.fragment

Preprocessing

  • Change per second
PFSense: Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.short

Preprocessing

  • Change per second
PFSense: Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.normalize

Preprocessing

  • Change per second
PFSense: Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP agent pfsense.packets.mem.drop

Preprocessing

  • Change per second
PFSense: Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP agent pfsense.rules.count

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

max(/PFSense by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 Warning
PFSense: Packet filter is not running

Please check PF status.

last(/PFSense by SNMP/pfsense.pf.status)<>1 High
PFSense: State table usage is high

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

min(/PFSense by SNMP/pfsense.state.table.pused,#3)>{$STATE.TABLE.UTIL.MAX} Warning
PFSense: Source tracking table usage is high

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

min(/PFSense by SNMP/pfsense.source.tracking.table.pused,#3)>{$SOURCE.TRACKING.TABLE.UTIL.MAX} Warning
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

last(/PFSense by SNMP/pfsense.dhcpd.status)=0 Average
PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

last(/PFSense by SNMP/pfsense.dns.status)=0 Average
PFSense: Web server is not running

Please check nginx service status.

last(/PFSense by SNMP/pfsense.nginx.status)=0 Average

LLD rule Network interfaces discovery

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

SNMP agent pfsense.net.if.discovery

Item prototypes for Network interfaces discovery

Name Description Type Key and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in.discards[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in.errors[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.in[{#SNMPINDEX}]

Preprocessing

  • Change per second:
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out.discards[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out.errors[{#SNMPINDEX}]

Preprocessing

  • Change per second:
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP agent net.if.out[{#SNMPINDEX}]

Preprocessing

  • Change per second:
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

SNMP agent net.if.speed[{#SNMPINDEX}]

Preprocessing

  • Custom multiplier: 1000000

  • Discard unchanged with heartbeat: 1h

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

SNMP agent net.if.status[{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 6h

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

SNMP agent net.if.type[{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 6h

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Rules references count

MIB: BEGEMOT-PF-MIB

The number of rules referencing this interface.

SNMP agent net.if.rules.refs[{#SNMPINDEX}]
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

SNMP agent net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

SNMP agent net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

SNMP agent net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

SNMP agent net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

SNMP agent net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

SNMP agent net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

SNMP agent net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

SNMP agent net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

SNMP agent net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

SNMP agent net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

SNMP agent net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

SNMP agent net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing

  • Change per second
  • Custom multiplier: 8

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

SNMP agent net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

SNMP agent net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

SNMP agent net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

SNMP agent net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing

  • Change per second

Trigger prototypes for Network interfaces discovery

Name Description Expression Severity Dependencies and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High input error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.in.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.in[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High output error rate

It recovers when it is below 80% of the {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

min(/PFSense by SNMP/net.if.out.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage

The utilization of the network interface is close to its estimated maximum bandwidth.

(avg(/PFSense by SNMP/net.if.out[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 Warning Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Acknowledge to close the problem manually.

change(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/PFSense by SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/PFSense by SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])<>2) Info Depends on:
  • PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down
PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

This trigger expression works as follows:
1. It can be triggered if the operations status is down.
2. {$IFCONTROL:"{#IFNAME}"}=1 - a user can redefine context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and (last(/PFSense by SNMP/net.if.status[{#SNMPINDEX}])=2) Average

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums

This template is for Zabbix version: 5.4

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/5.4

PFSense SNMP

Overview

For Zabbix version: 5.4 and higher
Template for monitoring pfSense by SNMP

This template was tested on:

  • pfSense, version 2.5.0, 2.5.1, 2.5.2

Setup

See Zabbix template operation for basic instructions.

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Zabbix configuration

No specific Zabbix configuration is required.

Macros used

Name Description Default
{$CPU.UTIL.CRIT}

Threshold of CPU utilization for warning trigger in %.

90
{$ICMP_LOSS_WARN}

Threshold of ICMP packets loss for warning trigger in %.

20
{$ICMP_RESPONSE_TIME_WARN}

Threshold of average ICMP response time for warning trigger in seconds.

0.15
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$LOAD_AVG_PER_CPU.MAX.WARN}

Load per CPU considered sustainable. Tune if needed.

1.5
{$MEMORY.AVAILABLE.MIN}

Threshold of available memory for trigger in bytes.

20M
{$MEMORY.UTIL.MAX}

Threshold of memory utilization for trigger in %

90
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.MATCHES}

This macro used in filters of network interfaces discovery rule.

^em[0-9]+$
{$NET.IF.IFNAME.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

^$
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6)

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90
{$SWAP.PFREE.MIN.WARN}

Threshold of free swap space for warning trigger in %.

50
{$VFS.DEV.DEVNAME.MATCHES}

This macro is used in block devices discovery. Can be overridden on the host or linked template level

.+
{$VFS.DEV.DEVNAME.NOT_MATCHES}

This macro is used in block devices discovery. Can be overridden on the host or linked template level

`^(loop[0-9]*
{$VFS.FS.FSNAME.MATCHES}

This macro is used in filesystems discovery. Can be overridden on the host or linked template level

.+
{$VFS.FS.FSNAME.NOT_MATCHES}

This macro is used in filesystems discovery. Can be overridden on the host or linked template level

`^(/dev
{$VFS.FS.FSTYPE.MATCHES}

This macro is used in filesystems discovery. Can be overridden on the host or linked template level

`.*(9.3
{$VFS.FS.FSTYPE.NOT_MATCHES}

This macro is used in filesystems discovery. Can be overridden on the host or linked template level

^\s$
{$VFS.FS.INODE.PFREE.MIN.CRIT}

Threshold of inodes usage for average severity trigger in %. Can be used with filesystem name as context.

10
{$VFS.FS.INODE.PFREE.MIN.WARN}

Threshold of inodes usage for warning trigger in %. Can be used with filesystem name as context.

20
{$VFS.FS.PUSED.MAX.CRIT}

Threshold of filesystem used space for average severity trigger in %. Can be used with filesystem name as context.

90
{$VFS.FS.PUSED.MAX.WARN}

Threshold of used filesystem space for warning trigger in %. Can be used with filesystem name as context.

80

Template links

There are no template links in this template.

Discovery rules

Name Description Type Key and additional info
Block devices discovery

Block devices are discovered from UCD-DISKIO-MIB::diskIOTable (http://net-snmp.sourceforge.net/docs/mibs/ucdDiskIOMIB.html#diskIOTable)

SNMP vfs.dev.discovery

Filter:

AND

- {#DEVNAME} MATCHES_REGEX {$VFS.DEV.DEVNAME.MATCHES}

- {#DEVNAME} NOT_MATCHES_REGEX {$VFS.DEV.DEVNAME.NOT_MATCHES}

CPU discovery

This discovery will create set of per core CPU metrics from UCD-SNMP-MIB, using {#CPU.COUNT} in preprocessing. That's the only reason why LLD is used.

DEPENDENT cpu.discovery

Preprocessing:

- JAVASCRIPT: The text is too long. Please see the template.

Mounted filesystem discovery

HOST-RESOURCES-MIB::hrFS discovery with filter

SNMP vfs.fs.discovery

Filter:

AND

- {#FSTYPE} MATCHES_REGEX {$VFS.FS.FSTYPE.MATCHES}

- {#FSTYPE} NOT_MATCHES_REGEX {$VFS.FS.FSTYPE.NOT_MATCHES}

- {#FSNAME} MATCHES_REGEX {$VFS.FS.FSNAME.MATCHES}

- {#FSNAME} NOT_MATCHES_REGEX {$VFS.FS.FSNAME.NOT_MATCHES}

Network interfaces discovery

Discovering interfaces from IF-MIB.

SNMP net.if.discovery

Filter:

AND

- {#IFADMINSTATUS} MATCHES_REGEX {$NET.IF.IFADMINSTATUS.MATCHES}

- {#IFADMINSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFADMINSTATUS.NOT_MATCHES}

- {#IFOPERSTATUS} MATCHES_REGEX {$NET.IF.IFOPERSTATUS.MATCHES}

- {#IFOPERSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFOPERSTATUS.NOT_MATCHES}

- {#IFNAME} MATCHES_REGEX {$NET.IF.IFNAME.MATCHES}

- {#IFNAME} NOT_MATCHES_REGEX {$NET.IF.IFNAME.NOT_MATCHES}

- {#IFDESCR} MATCHES_REGEX {$NET.IF.IFDESCR.MATCHES}

- {#IFDESCR} NOT_MATCHES_REGEX {$NET.IF.IFDESCR.NOT_MATCHES}

- {#IFALIAS} MATCHES_REGEX {$NET.IF.IFALIAS.MATCHES}

- {#IFALIAS} NOT_MATCHES_REGEX {$NET.IF.IFALIAS.NOT_MATCHES}

- {#IFTYPE} MATCHES_REGEX {$NET.IF.IFTYPE.MATCHES}

- {#IFTYPE} NOT_MATCHES_REGEX {$NET.IF.IFTYPE.NOT_MATCHES}

Items collected

Group Name Description Type Key and additional info
CPU PFSense: Interrupts per second

MIB: UCD-SNMP-MIB

Number of interrupts processed

SNMP system.cpu.intr

Preprocessing:

- CHANGE_PER_SECOND

CPU PFSense: Context switches per second

MIB: UCD-SNMP-MIB

Number of context switches

SNMP system.cpu.switches

Preprocessing:

- CHANGE_PER_SECOND

CPU PFSense: Load average (1m avg)

MIB: UCD-SNMP-MIB

The 1 minute load averages.

SNMP system.cpu.load.avg1
CPU PFSense: Load average (5m avg)

MIB: UCD-SNMP-MIB

The 5 minutes load averages.

SNMP system.cpu.load.avg5
CPU PFSense: Load average (15m avg)

MIB: UCD-SNMP-MIB

The 15 minutes load averages.

SNMP system.cpu.load.avg15
CPU PFSense: Number of CPUs

MIB: HOST-RESOURCES-MIB

Count the number of CPU cores by counting number of cores discovered in hrProcessorTable using LLD

SNMP system.cpu.num

Preprocessing:

- JAVASCRIPT: //count the number of cores return JSON.parse(value).length;

CPU PFSense: CPU idle time

MIB: UCD-SNMP-MIB

The time the CPU has spent doing nothing.

SNMP system.cpu.idle[{#SNMPINDEX}]
CPU PFSense: CPU system time

MIB: UCD-SNMP-MIB

The time the CPU has spent running the kernel and its processes.

SNMP system.cpu.system[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- JAVASCRIPT: //to get utilization in %, divide by N, where N is number of cores. return value/{#CPU.COUNT}

CPU PFSense: CPU user time

MIB: UCD-SNMP-MIB

The time the CPU has spent running users' processes that are not niced.

SNMP system.cpu.user[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- JAVASCRIPT: //to get utilization in %, divide by N, where N is number of cores. return value/{#CPU.COUNT}

CPU PFSense: CPU nice time

MIB: UCD-SNMP-MIB

The time the CPU has spent running users' processes that have been niced.

SNMP system.cpu.nice[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- JAVASCRIPT: //to get utilization in %, divide by N, where N is number of cores. return value/{#CPU.COUNT}

CPU PFSense: CPU iowait time

MIB: UCD-SNMP-MIB

Amount of time the CPU has been waiting for I/O to complete.

SNMP system.cpu.iowait[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- JAVASCRIPT: //to get utilization in %, divide by N, where N is number of cores. return value/{#CPU.COUNT}

CPU PFSense: CPU interrupt time

MIB: UCD-SNMP-MIB

The amount of time the CPU has been servicing hardware interrupts.

SNMP system.cpu.interrupt[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- JAVASCRIPT: //to get utilization in %, divide by N, where N is number of cores. return value/{#CPU.COUNT}

CPU PFSense: CPU utilization

CPU utilization in %

DEPENDENT system.cpu.util[{#SNMPINDEX}]

Preprocessing:

- JAVASCRIPT: //Calculate utilization return (100 - value)

General PFSense: System contact details

MIB: SNMPv2-MIB

The textual identification of the contact person for this managed node, together with information on how to contact this person. If no contact information is known, the value is the zero-length string.

SNMP system.contact

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

General PFSense: System description

MIB: SNMPv2-MIB

System description of the host.

SNMP system.descr

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

General PFSense: System location

MIB: SNMPv2-MIB

The physical location of this node. If the location is unknown, the value is the zero-length string.

SNMP system.location

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

General PFSense: System name

MIB: SNMPv2-MIB

System host name.

SNMP system.name

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

General PFSense: System object ID

MIB: SNMPv2-MIB

The vendor authoritative identification of the network management subsystem contained in the entity. This value is allocated within the SMI enterprises subtree (1.3.6.1.4.1) and provides an easy and unambiguous means for determining what kind of box is being managed.

SNMP system.objectid

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Memory PFSense: Free memory

MIB: UCD-SNMP-MIB

The amount of real/physical memory currently unused or available.

SNMP vm.memory.free

Preprocessing:

- MULTIPLIER: 1024

Memory PFSense: Memory (buffers)

MIB: UCD-SNMP-MIB

The total amount of real or virtual memory currently allocated for use as memory buffers.

SNMP vm.memory.buffers

Preprocessing:

- MULTIPLIER: 1024

Memory PFSense: Memory (cached)

MIB: UCD-SNMP-MIB

The total amount of real or virtual memory currently allocated for use as cached memory.

SNMP vm.memory.cached

Preprocessing:

- MULTIPLIER: 1024

Memory PFSense: Total memory

MIB: UCD-SNMP-MIB

Total memory in Bytes

SNMP vm.memory.total

Preprocessing:

- MULTIPLIER: 1024

Memory PFSense: Available memory

Please note that memory utilization is a rough estimate, since memory available is calculated as free+buffers+cached, which is not 100% accurate, but the best we can get using SNMP.

CALCULATED vm.memory.available

Expression:

last(//vm.memory.free)+last(//vm.memory.buffers)+last(//vm.memory.cached)
Memory PFSense: Memory utilization

Please note that memory utilization is a rough estimate, since memory available is calculated as free+buffers+cached, which is not 100% accurate, but the best we can get using SNMP.

CALCULATED vm.memory.util

Expression:

(last(//vm.memory.total)-(last(//vm.memory.free)+last(//vm.memory.buffers)+last(//vm.memory.cached)))/last(//vm.memory.total)*100
Memory PFSense: Total swap space

MIB: UCD-SNMP-MIB

The total amount of swap space configured for this host.

SNMP system.swap.total

Preprocessing:

- MULTIPLIER: 1024

Memory PFSense: Free swap space

MIB: UCD-SNMP-MIB

The amount of swap space currently unused or available.

SNMP system.swap.free

Preprocessing:

- MULTIPLIER: 1024

Memory PFSense: Free swap space in %

The free space of swap volume/file in percent.

CALCULATED system.swap.pfree

Expression:

last(//system.swap.free)/last(//system.swap.total)*100
Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in.discards[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in.errors[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out.discards[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out.errors[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND: ``

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

SNMP net.if.speed[{#SNMPINDEX}]

Preprocessing:

- MULTIPLIER: 1000000

- DISCARD_UNCHANGED_HEARTBEAT: 1h

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

SNMP net.if.status[{#SNMPINDEX}]

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned NumbersAuthority (IANA),

through updating the syntax of the IANAifType textual convention.

SNMP net.if.type[{#SNMPINDEX}]

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Rules references count

BEGEMOT-PF-MIB

The number of rules referencing this interface.

SNMP net.if.rules.refs[{#SNMPINDEX}]
Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

SNMP net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

SNMP net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

SNMP net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

SNMP net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

SNMP net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

SNMP net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

SNMP net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

SNMP net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

SNMP net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

SNMP net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

SNMP net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

SNMP net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

SNMP net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

SNMP net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

SNMP net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

SNMP net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled

SNMP pfsense.pf.status
pfSense PFSense: States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP pfsense.state.table.count
pfSense PFSense: States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP pfsense.state.table.limit
pfSense PFSense: States table utilization in %

Utilization of state table in %.

CALCULATED pfsense.state.table.pused

Expression:

last(//pfsense.state.table.count) * 100 / last(//pfsense.state.table.limit)
pfSense PFSense: Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP pfsense.source.tracking.table.count
pfSense PFSense: Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP pfsense.source.tracking.table.limit
pfSense PFSense: Source tracking table utilization in %

Utilization of source tracking table in %.

CALCULATED pfsense.source.tracking.table.pused

Expression:

last(//pfsense.source.tracking.table.count) * 100 / last(//pfsense.source.tracking.table.limit)
pfSense PFSense: DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

SNMP pfsense.dhcpd.status

Preprocessing:

- CHECK_NOT_SUPPORTED: ``

⛔️ON_FAIL: CUSTOM_VALUE -> 0

pfSense PFSense: DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

SNMP pfsense.dns.status

Preprocessing:

- CHECK_NOT_SUPPORTED: ``

⛔️ON_FAIL: CUSTOM_VALUE -> 0

pfSense PFSense: State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

SNMP pfsense.nginx.status

Preprocessing:

- CHECK_NOT_SUPPORTED: ``

⛔️ON_FAIL: CUSTOM_VALUE -> 0

pfSense PFSense: Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory

SNMP pfsense.packets.match

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory

SNMP pfsense.packets.bad.offset

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory

SNMP pfsense.packets.fragment

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory

SNMP pfsense.packets.short

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory

SNMP pfsense.packets.normalize

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory

SNMP pfsense.packets.mem.drop

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP pfsense.rules.count
Status PFSense: ICMP ping

Host accessibility by ICMP.

0 - ICMP ping fails.

1 - ICMP ping successful.

SIMPLE icmpping
Status PFSense: ICMP loss

Percentage of lost packets.

SIMPLE icmppingloss
Status PFSense: ICMP response time

ICMP ping response time (in seconds).

SIMPLE icmppingsec
Status PFSense: Uptime

MIB: SNMPv2-MIB

System uptime in 'N days, hh:mm:ss' format.

SNMP system.uptime

Preprocessing:

- MULTIPLIER: 0.01

Status PFSense: SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible value:

0 - not available

1 - available

2 - unknown

INTERNAL zabbix[host,snmp,available]
Storage PFSense: [{#FSNAME}]: Used space

MIB: UCD-SNMP-MIB

If having problems collecting this item make sure access to UCD-SNMP-MIB is allowed.

SNMP vfs.fs.used[{#SNMPINDEX}]

Preprocessing:

- MULTIPLIER: 1024

Storage PFSense: [{#FSNAME}]: Total space

MIB: UCD-SNMP-MIB

If having problems collecting this item make sure access to UCD-SNMP-MIB is allowed.

SNMP vfs.fs.total[{#SNMPINDEX}]

Preprocessing:

- MULTIPLIER: 1024

Storage PFSense: [{#FSNAME}]: Space utilization

MIB: UCD-SNMP-MIB

If having problems collecting this item make sure access to UCD-SNMP-MIB is allowed.

SNMP vfs.fs.pused[{#SNMPINDEX}]
Storage PFSense: [{#FSNAME}]: Free inodes in %

MIB: UCD-SNMP-MIB

If having problems collecting this item make sure access to UCD-SNMP-MIB is allowed.

SNMP vfs.fs.inode.pfree[{#SNMPINDEX}]

Preprocessing:

- JAVASCRIPT: return (100-value);

Storage PFSense: [{#DEVNAME}]: Disk read rate

MIB: UCD-DISKIO-MIB

The number of read accesses from this device since boot.

SNMP vfs.dev.read.rate[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Storage PFSense: [{#DEVNAME}]: Disk write rate

MIB: UCD-DISKIO-MIB

The number of write accesses from this device since boot.

SNMP vfs.dev.write.rate[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Storage PFSense: [{#DEVNAME}]: Disk utilization

MIB: UCD-DISKIO-MIB

The 1 minute average load of disk (%)

SNMP vfs.dev.util[{#SNMPINDEX}]

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: Load average is too high (per CPU load over {$LOAD_AVG_PER_CPU.MAX.WARN} for 5m)

Per CPU load average is too high. Your system may be slow to respond.

min(/PFSense SNMP/system.cpu.load.avg1,5m)/last(/PFSense SNMP/system.cpu.num)>{$LOAD_AVG_PER_CPU.MAX.WARN} and last(/PFSense SNMP/system.cpu.load.avg5)>0 and last(/PFSense SNMP/system.cpu.load.avg15)>0 AVERAGE
PFSense: High CPU utilization (over {$CPU.UTIL.CRIT}% for 5m)

CPU utilization is too high. The system might be slow to respond.

min(/PFSense SNMP/system.cpu.util[{#SNMPINDEX}],5m)>{$CPU.UTIL.CRIT} WARNING

Depends on:

- PFSense: Load average is too high (per CPU load over {$LOAD_AVG_PER_CPU.MAX.WARN} for 5m)

PFSense: System name has changed (new name: {ITEM.VALUE})

System name has changed. Ack to close.

last(/PFSense SNMP/system.name,#1)<>last(/PFSense SNMP/system.name,#2) and length(last(/PFSense SNMP/system.name))>0 INFO

Manual close: YES

PFSense: Lack of available memory (<{$MEMORY.AVAILABLE.MIN} of {ITEM.VALUE2})

The system is running out of memory

min(/PFSense SNMP/vm.memory.available,5m)<{$MEMORY.AVAILABLE.MIN} and last(/PFSense SNMP/vm.memory.total)>0 AVERAGE
PFSense: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)

The system is running out of free memory.

min(/PFSense SNMP/vm.memory.util,5m)>{$MEMORY.UTIL.MAX} AVERAGE

Depends on:

- PFSense: Lack of available memory (<{$MEMORY.AVAILABLE.MIN} of {ITEM.VALUE2})

PFSense: High swap space usage (less than {$SWAP.PFREE.MIN.WARN}% free)

This trigger is ignored, if there is no swap configured

min(/PFSense SNMP/system.swap.pfree,5m)<{$SWAP.PFREE.MIN.WARN} and last(/PFSense SNMP/system.swap.total)>0 WARNING

Depends on:

- PFSense: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)

- PFSense: Lack of available memory (<{$MEMORY.AVAILABLE.MIN} of {ITEM.VALUE2})

PFSense: High input error rate ( > {$IF.ERRORS.WARN:"{#IFNAME}"} for 5m)

Recovers when below 80% of {$IF.ERRORS.WARN:"{#IFNAME}"} threshold

min(/PFSense SNMP/net.if.in.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"}

Recovery expression:

max(/PFSense SNMP/net.if.in.errors[{#SNMPINDEX}],5m)<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8
WARNING

Depends on:

- PFSense: Link down

PFSense: High inbound bandwidth usage ( > {$IF.UTIL.MAX:"{#IFNAME}"}% )

The network interface utilization is close to its estimated maximum bandwidth.

(avg(/PFSense SNMP/net.if.in[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])>0

Recovery expression:

avg(/PFSense SNMP/net.if.in[{#SNMPINDEX}],15m)<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])
WARNING

Depends on:

- PFSense: Link down

PFSense: High output error rate ( > {$IF.ERRORS.WARN:"{#IFNAME}"} for 5m)

Recovers when below 80% of {$IF.ERRORS.WARN:"{#IFNAME}"} threshold

min(/PFSense SNMP/net.if.out.errors[{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"}

Recovery expression:

max(/PFSense SNMP/net.if.out.errors[{#SNMPINDEX}],5m)<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8
WARNING

Depends on:

- PFSense: Link down

PFSense: High outbound bandwidth usage ( > {$IF.UTIL.MAX:"{#IFNAME}"}% )

The network interface utilization is close to its estimated maximum bandwidth.

(avg(/PFSense SNMP/net.if.out[{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])) and last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])>0

Recovery expression:

avg(/PFSense SNMP/net.if.out[{#SNMPINDEX}],15m)<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])
WARNING

Depends on:

- PFSense: Link down

PFSense: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Ack to close.

change(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/PFSense SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/PFSense SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/PFSense SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/PFSense SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/PFSense SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/PFSense SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/PFSense SNMP/net.if.status[{#SNMPINDEX}])<>2)

Recovery expression:

(change(/PFSense SNMP/net.if.speed[{#SNMPINDEX}])>0 and last(/PFSense SNMP/net.if.speed[{#SNMPINDEX}],#2)>0) or (last(/PFSense SNMP/net.if.status[{#SNMPINDEX}])=2)
INFO

Depends on:

- PFSense: Link down

PFSense: Link down

This trigger expression works as follows:

1. Can be triggered if operations status is down.

2. {$IFCONTROL:"{#IFNAME}"}=1 - user can redefine Context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and (last(/PFSense SNMP/net.if.status[{#SNMPINDEX}])=2) AVERAGE
PFSense: Packet filter is not running

Please check PF status

last(/PFSense SNMP/pfsense.pf.status)<>1 HIGH
PFSense: State table usage more than {$STATE.TABLE.UTIL.MAX}.

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

min(/PFSense SNMP/pfsense.state.table.pused,#3)>{$STATE.TABLE.UTIL.MAX} WARNING
PFSense: Source tracking table usage more than {$SOURCE.TRACKING.TABLE.UTIL.MAX}.

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

min(/PFSense SNMP/pfsense.source.tracking.table.pused,#3)>{$SOURCE.TRACKING.TABLE.UTIL.MAX} WARNING
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

last(/PFSense SNMP/pfsense.dhcpd.status)=0 AVERAGE
PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

last(/PFSense SNMP/pfsense.dns.status)=0 AVERAGE
PFSense: Web server is not running

Please check nginx service status

last(/PFSense SNMP/pfsense.nginx.status)=0 AVERAGE
PFSense: Unavailable by ICMP ping

Last three attempts returned timeout. Please check device connectivity.

max(/PFSense SNMP/icmpping,#3)=0 HIGH
PFSense: High ICMP ping loss

ICMP packets loss detected

min(/PFSense SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/PFSense SNMP/icmppingloss,5m)<100 WARNING

Depends on:

- PFSense: Unavailable by ICMP ping

PFSense: High ICMP ping response time

Average ICMP response time is too big.

avg(/PFSense SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} WARNING

Depends on:

- PFSense: Unavailable by ICMP ping

PFSense: has been restarted (uptime < 10m)

Uptime is less than 10 minutes

last(/PFSense SNMP/system.uptime)<10m INFO

Manual close: YES

PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

max(/PFSense SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 WARNING

Depends on:

- PFSense: Unavailable by ICMP ping

PFSense: Disk space is critically low (used > {$VFS.FS.PUSED.MAX.CRIT:"PFSense"}%)

Two conditions should match: First, space utilization should be above {$VFS.FS.PUSED.MAX.CRIT:"PFSense"}.

Second condition should be one of the following:

- The disk free space is less than 5G.

- The disk will be full in less than 24 hours.

last(/PFSense SNMP/vfs.fs.pused[{#SNMPINDEX}])>{$VFS.FS.PUSED.MAX.CRIT:"{#FSNAME}"} and ((last(/PFSense SNMP/vfs.fs.total[{#SNMPINDEX}])-last(/PFSense SNMP/vfs.fs.used[{#SNMPINDEX}]))<5G or timeleft(/PFSense SNMP/vfs.fs.pused[{#SNMPINDEX}],1h,100)<1d) AVERAGE

Manual close: YES

PFSense: Disk space is low (used > {$VFS.FS.PUSED.MAX.WARN:"PFSense"}%)

Two conditions should match: First, space utilization should be above {$VFS.FS.PUSED.MAX.WARN:"PFSense"}.

Second condition should be one of the following:

- The disk free space is less than 10G.

- The disk will be full in less than 24 hours.

last(/PFSense SNMP/vfs.fs.pused[{#SNMPINDEX}])>{$VFS.FS.PUSED.MAX.WARN:"{#FSNAME}"} and ((last(/PFSense SNMP/vfs.fs.total[{#SNMPINDEX}])-last(/PFSense SNMP/vfs.fs.used[{#SNMPINDEX}]))<10G or timeleft(/PFSense SNMP/vfs.fs.pused[{#SNMPINDEX}],1h,100)<1d) WARNING

Manual close: YES

Depends on:

- PFSense: Disk space is critically low (used > {$VFS.FS.PUSED.MAX.CRIT:"PFSense"}%)

PFSense: {#FSNAME}: Running out of free inodes (free < {$VFS.FS.INODE.PFREE.MIN.CRIT:"{#FSNAME}"}%)

It may become impossible to write to disk if there are no index nodes left.

As symptoms, 'No space left on device' or 'Disk is full' errors may be seen even though free space is available.

min(/PFSense SNMP/vfs.fs.inode.pfree[{#SNMPINDEX}],5m)<{$VFS.FS.INODE.PFREE.MIN.CRIT:"{#FSNAME}"} AVERAGE
PFSense: {#FSNAME}: Running out of free inodes (free < {$VFS.FS.INODE.PFREE.MIN.WARN:"{#FSNAME}"}%)

It may become impossible to write to disk if there are no index nodes left.

As symptoms, 'No space left on device' or 'Disk is full' errors may be seen even though free space is available.

min(/PFSense SNMP/vfs.fs.inode.pfree[{#SNMPINDEX}],5m)<{$VFS.FS.INODE.PFREE.MIN.WARN:"{#FSNAME}"} WARNING

Depends on:

- PFSense: {#FSNAME}: Running out of free inodes (free < {$VFS.FS.INODE.PFREE.MIN.CRIT:"{#FSNAME}"}%)

Feedback

Please report any issues with the template at https://support.zabbix.com

This template is for Zabbix version: 5.0

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/pfsense_snmp?at=release/5.0

Template App PFSense SNMP

Overview

For Zabbix version: 5.0 and higher.
Template for monitoring pfSense by SNMP

This template has been tested on:

  • pfSense, version 2.5.0, 2.5.1, 2.5.2

Setup

See Zabbix template operation for basic instructions.

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in pfSense web interface https://docs.netgate.com/pfsense/en/latest/services/snmp.html
  3. Setup firewall rule to get access from Zabbix proxy or Zabbix server by SNMP https://docs.netgate.com/pfsense/en/latest/firewall/index.html#managing-firewall-rules
  4. Link template to the host

Zabbix configuration

No specific Zabbix configuration is required.

Macros used

Name Description Default
{$IF.ERRORS.WARN}

Threshold of error packets rate for warning trigger. Can be used with interface name as context.

2
{$IF.UTIL.MAX}

Threshold of interface bandwidth utilization for warning trigger in %. Can be used with interface name as context.

90
{$IFCONTROL}

Macro for operational state of the interface for link down trigger. Can be used with interface name as context.

1
{$NET.IF.IFADMINSTATUS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

^.*
{$NET.IF.IFADMINSTATUS.NOT_MATCHES}

Ignore down(2) administrative status

^2$
{$NET.IF.IFALIAS.MATCHES}

This macro is used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFALIAS.NOT_MATCHES}

This macro is used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFDESCR.MATCHES}

This macro used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFDESCR.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$NET.IF.IFNAME.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

`(^pflog[0-9.]*$
{$NET.IF.IFOPERSTATUS.MATCHES}

This macro used in filters of network interfaces discovery rule.

^.*$
{$NET.IF.IFOPERSTATUS.NOT_MATCHES}

Ignore notPresent(6)

^6$
{$NET.IF.IFTYPE.MATCHES}

This macro used in filters of network interfaces discovery rule.

.*
{$NET.IF.IFTYPE.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

CHANGE_IF_NEEDED
{$SNMP.TIMEOUT}

The time interval for SNMP availability trigger.

5m
{$SOURCE.TRACKING.TABLE.UTIL.MAX}

Threshold of source tracking table utilization trigger in %.

90
{$STATE.TABLE.UTIL.MAX}

Threshold of state table utilization trigger in %.

90

Template links

There are no template links in this template.

Discovery rules

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

SNMP pfsense.net.if.discovery

Filter:

AND

- A: {#IFADMINSTATUS} MATCHES_REGEX {$NET.IF.IFADMINSTATUS.MATCHES}

- B: {#IFADMINSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFADMINSTATUS.NOT_MATCHES}

- I: {#IFOPERSTATUS} MATCHES_REGEX {$NET.IF.IFOPERSTATUS.MATCHES}

- J: {#IFOPERSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFOPERSTATUS.NOT_MATCHES}

- G: {#IFNAME} MATCHES_REGEX @Network interfaces for discovery

- H: {#IFNAME} NOT_MATCHES_REGEX {$NET.IF.IFNAME.NOT_MATCHES}

- E: {#IFDESCR} MATCHES_REGEX {$NET.IF.IFDESCR.MATCHES}

- F: {#IFDESCR} NOT_MATCHES_REGEX {$NET.IF.IFDESCR.NOT_MATCHES}

- C: {#IFALIAS} MATCHES_REGEX {$NET.IF.IFALIAS.MATCHES}

- D: {#IFALIAS} NOT_MATCHES_REGEX {$NET.IF.IFALIAS.NOT_MATCHES}

- K: {#IFTYPE} MATCHES_REGEX {$NET.IF.IFTYPE.MATCHES}

- L: {#IFTYPE} NOT_MATCHES_REGEX {$NET.IF.IFTYPE.NOT_MATCHES}

Items collected

Group Name Description Type Key and additional info
Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets discarded

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in.discards[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in.errors[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits received

MIB: IF-MIB

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.in[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets discarded

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out.discards[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound packets with errors

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out.errors[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

SNMP net.if.out[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

SNMP net.if.speed[{#SNMPINDEX}]

Preprocessing:

- MULTIPLIER: 1000000

- DISCARD_UNCHANGED_HEARTBEAT: 1h

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Operational status

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

SNMP net.if.status[{#SNMPINDEX}]

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Interface type

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

SNMP net.if.type[{#SNMPINDEX}]

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Rules references count

MIB: BEGEMOT-PF-MIB

The number of rules referencing this interface.

SNMP net.if.rules.refs[{#SNMPINDEX}]
Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed coming in on this interface.

SNMP net.if.in.pass.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked coming in on this interface.

SNMP net.if.in.block.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic passed

MIB: BEGEMOT-PF-MIB

IPv4 bits per second passed going out on this interface.

SNMP net.if.out.pass.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv4 bits per second blocked going out on this interface.

SNMP net.if.out.block.v4.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed coming in on this interface.

SNMP net.if.in.pass.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked coming in on this interface.

SNMP net.if.in.block.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets passed going out on this interface.

SNMP net.if.out.pass.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv4 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv4 packets blocked going out on this interface.

SNMP net.if.out.block.v4.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed coming in on this interface.

SNMP net.if.in.pass.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked coming in on this interface.

SNMP net.if.in.block.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic passed

MIB: BEGEMOT-PF-MIB

IPv6 bits per second passed going out on this interface.

SNMP net.if.out.pass.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 traffic blocked

MIB: BEGEMOT-PF-MIB

IPv6 bits per second blocked going out on this interface.

SNMP net.if.out.block.v6.bps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

- MULTIPLIER: 8

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed coming in on this interface.

SNMP net.if.in.pass.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Inbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked coming in on this interface.

SNMP net.if.in.block.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets passed

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets passed going out on this interface.

SNMP net.if.out.pass.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

Network_interfaces PFSense: Interface [{#IFNAME}({#IFALIAS})]: Outbound IPv6 packets blocked

MIB: BEGEMOT-PF-MIB

The number of IPv6 packets blocked going out on this interface.

SNMP net.if.out.block.v6.pps[{#SNMPINDEX}]

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packet filter running status

MIB: BEGEMOT-PF-MIB

True if packet filter is currently enabled.

SNMP pfsense.pf.status
pfSense PFSense: States table current

MIB: BEGEMOT-PF-MIB

Number of entries in the state table.

SNMP pfsense.state.table.count
pfSense PFSense: States table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'keep state' rules in the ruleset.

SNMP pfsense.state.table.limit
pfSense PFSense: States table utilization in %

Utilization of state table in %.

CALCULATED pfsense.state.table.pused

Expression:

last("pfsense.state.table.count") * 100 / last("pfsense.state.table.limit")
pfSense PFSense: Source tracking table current

MIB: BEGEMOT-PF-MIB

Number of entries in the source tracking table.

SNMP pfsense.source.tracking.table.count
pfSense PFSense: Source tracking table limit

MIB: BEGEMOT-PF-MIB

Maximum number of 'sticky-address' or 'source-track' rules in the ruleset.

SNMP pfsense.source.tracking.table.limit
pfSense PFSense: Source tracking table utilization in %

Utilization of source tracking table in %.

CALCULATED pfsense.source.tracking.table.pused

Expression:

last("pfsense.source.tracking.table.count") * 100 / last("pfsense.source.tracking.table.limit")
pfSense PFSense: DHCP server status

MIB: HOST-RESOURCES-MIB

The status of DHCP server process.

SNMP pfsense.dhcpd.status
pfSense PFSense: DNS server status

MIB: HOST-RESOURCES-MIB

The status of DNS server process.

SNMP pfsense.dns.status
pfSense PFSense: State of nginx process

MIB: HOST-RESOURCES-MIB

The status of nginx process.

SNMP pfsense.nginx.status
pfSense PFSense: Packets matched a filter rule

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.match

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packets with bad offset

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.bad.offset

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Fragmented packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.fragment

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Short packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.short

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Normalized packets

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.normalize

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Packets dropped due to memory limitation

MIB: BEGEMOT-PF-MIB

True if the packet was logged with the specified packet filter reason code. The known codes are: match, bad-offset, fragment, short, normalize, and memory.

SNMP pfsense.packets.mem.drop

Preprocessing:

- CHANGE_PER_SECOND

pfSense PFSense: Firewall rules count

MIB: BEGEMOT-PF-MIB

The number of labeled filter rules on this system.

SNMP pfsense.rules.count
Status PFSense: SNMP agent availability

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible value:

0 - not available

1 - available

2 - unknown

INTERNAL zabbix[host,snmp,available]

Triggers

Name Description Expression Severity Dependencies and additional info
PFSense: Interface [{#IFNAME}({#IFALIAS})]: High input error rate ( > {$IF.ERRORS.WARN:"{#IFNAME}"} for 5m)

Recovers when below 80% of {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

{TEMPLATE_NAME:net.if.in.errors[{#SNMPINDEX}].min(5m)}>{$IF.ERRORS.WARN:"{#IFNAME}"}

Recovery expression:

{TEMPLATE_NAME:net.if.in.errors[{#SNMPINDEX}].max(5m)}<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage ( > {$IF.UTIL.MAX:"{#IFNAME}"}% )

The network interface utilization is close to its estimated maximum bandwidth.

({TEMPLATE_NAME:net.if.in[{#SNMPINDEX}].avg(15m)}>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*{TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last()}) and {TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last()}>0

Recovery expression:

{TEMPLATE_NAME:net.if.in[{#SNMPINDEX}].avg(15m)}<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*{TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last()}
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: High output error rate ( > {$IF.ERRORS.WARN:"{#IFNAME}"} for 5m)

Recovers when below 80% of {$IF.ERRORS.WARN:"{#IFNAME}"} threshold.

{TEMPLATE_NAME:net.if.out.errors[{#SNMPINDEX}].min(5m)}>{$IF.ERRORS.WARN:"{#IFNAME}"}

Recovery expression:

{TEMPLATE_NAME:net.if.out.errors[{#SNMPINDEX}].max(5m)}<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage ( > {$IF.UTIL.MAX:"{#IFNAME}"}% )

The network interface utilization is close to its estimated maximum bandwidth.

({TEMPLATE_NAME:net.if.out[{#SNMPINDEX}].avg(15m)}>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*{TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last()}) and {TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last()}>0

Recovery expression:

{TEMPLATE_NAME:net.if.out[{#SNMPINDEX}].avg(15m)}<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*{TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last()}
WARNING

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Ethernet has changed to lower speed than it was before

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Ack to close.

{TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].change()}<0 and {TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last()}>0 and ( {TEMPLATE_NAME:net.if.type[{#SNMPINDEX}].last()}=6 or {TEMPLATE_NAME:net.if.type[{#SNMPINDEX}].last()}=7 or {TEMPLATE_NAME:net.if.type[{#SNMPINDEX}].last()}=11 or {TEMPLATE_NAME:net.if.type[{#SNMPINDEX}].last()}=62 or {TEMPLATE_NAME:net.if.type[{#SNMPINDEX}].last()}=69 or {TEMPLATE_NAME:net.if.type[{#SNMPINDEX}].last()}=117 ) and {TEMPLATE_NAME:net.if.status[{#SNMPINDEX}].last()}<>2

Recovery expression:

({TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].change()}>0 and {TEMPLATE_NAME:net.if.speed[{#SNMPINDEX}].last(#2)}>0) or {TEMPLATE_NAME:net.if.status[{#SNMPINDEX}].last()}=2
INFO

Depends on:

- PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

PFSense: Interface [{#IFNAME}({#IFALIAS})]: Link down

This trigger expression works as follows:

1. Can be triggered if operations status is down.

2. {$IFCONTROL:"{#IFNAME}"}=1 - user can redefine Context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.

{$IFCONTROL:"{#IFNAME}"}=1 and {TEMPLATE_NAME:net.if.status[{#SNMPINDEX}].last()}=2 AVERAGE
PFSense: Packet filter is not running

Please check PF status.

{TEMPLATE_NAME:pfsense.pf.status.last()}<>1 HIGH
PFSense: State table usage more than {$STATE.TABLE.UTIL.MAX}.

Please check the number of connections https://docs.netgate.com/pfsense/en/latest/config/advanced-firewall-nat.html#config-advanced-firewall-maxstates

{TEMPLATE_NAME:pfsense.state.table.pused.min(#3)}>{$STATE.TABLE.UTIL.MAX} WARNING
PFSense: Source tracking table usage more than {$SOURCE.TRACKING.TABLE.UTIL.MAX}.

Please check the number of sticky connections https://docs.netgate.com/pfsense/en/latest/monitoring/status/firewall-states-sources.html

{TEMPLATE_NAME:pfsense.source.tracking.table.pused.min(#3)}>{$SOURCE.TRACKING.TABLE.UTIL.MAX} WARNING
PFSense: DHCP server is not running

Please check DHCP server settings https://docs.netgate.com/pfsense/en/latest/services/dhcp/index.html

{TEMPLATE_NAME:pfsense.dhcpd.status.nodata(5m)}=1 AVERAGE

Depends on:

- PFSense: No SNMP data collection

PFSense: DNS server is not running

Please check DNS server settings https://docs.netgate.com/pfsense/en/latest/services/dns/index.html

{TEMPLATE_NAME:pfsense.dns.status.nodata(5m)}=1 AVERAGE

Depends on:

- PFSense: No SNMP data collection

PFSense: Web server is not running

Please check nginx service status.

{TEMPLATE_NAME:pfsense.nginx.status.nodata(5m)}=1 AVERAGE

Depends on:

- PFSense: No SNMP data collection

PFSense: No SNMP data collection

SNMP is not available for polling. Please check device connectivity and SNMP settings.

{TEMPLATE_NAME:zabbix[host,snmp,available].max({$SNMP.TIMEOUT})}=0 WARNING

Feedback

Please report any issues with the template at https://support.zabbix.com.

Articles and documentation

+ Propose new article
👁 Image

Request custom integration

Zabbix integration team will develop custom integration based on your requirements and Zabbix best practices.

Request
👁 Image

Propose integration

Have you already developed high quality integration and want to submit to Zabbix integration repository?

Propose