TrueNAS

Available solutions




This template is for Zabbix version: 7.4

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

TrueNAS CORE by SNMP

Overview

Template for monitoring TrueNAS CORE by SNMP.

Requirements

Zabbix version: 7.4 and higher.

Tested versions

This template has been tested on:

  • TrueNAS CORE 12.0-U8
  • TrueNAS CORE 13.0-U5.3

Configuration

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

Setup

  1. Import the template into Zabbix.
  2. Enable SNMP daemon at Services in TrueNAS CORE web interface: https://www.truenas.com/docs/core/uireference/services/snmpscreen/
  3. Link the template to the host.

Macros used

Name Description Default
{$CPU.UTIL.CRIT}

Threshold of CPU utilization for warning trigger in %.

 90
{$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
{$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

 Macro too long. Please see the template.
{$DATASET.NAME.MATCHES}

This macro is used in datasets discovery. Can be overridden on the host or linked template level

 .+
{$DATASET.NAME.NOT_MATCHES}

This macro is used in datasets discovery. Can be overridden on the host or linked template level

 ^(boot|.+\.system(.+)?$)
{$ZPOOL.PUSED.MAX.WARN}

Threshold of used pool space for warning trigger in %.

 80
{$ZPOOL.FREE.MIN.WARN}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 5G
{$ZPOOL.PUSED.MAX.CRIT}

Threshold of used pool space for average severity trigger in %.

 90
{$ZPOOL.FREE.MIN.CRIT}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 5G
{$DATASET.PUSED.MAX.WARN}

Threshold of used dataset space for warning trigger in %.

 80
{$DATASET.FREE.MIN.WARN}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 5G
{$DATASET.PUSED.MAX.CRIT}

Threshold of used dataset space for average severity trigger in %.

 90
{$DATASET.FREE.MIN.CRIT}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 5G
{$TEMPERATURE.MAX.WARN}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 50
{$TEMPERATURE.MAX.CRIT}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 65
{$SNMP.TIMEOUT}

Time interval for the SNMP availability trigger.

 5m
{$ICMP_LOSS_WARN}

Warning threshold of ICMP packet loss in %.

 20
{$ICMP_RESPONSE_TIME_WARN}

Warning threshold of the average ICMP response time in seconds.

 0.15
{$IFCONTROL}

Link status trigger will be fired only for interfaces where the context macro equals "1".

 1
{$IF.UTIL.MAX}

Used as a threshold in the interface utilization trigger.

 90
{$IF.ERRORS.WARN}

Warning threshold of error packet rate. Can be used with interface name as context.

 2
{$NET.IF.IFNAME.MATCHES}

Used for network interface discovery. Can be overridden on the host or linked template level.

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

Filters out loopbacks, nulls, docker veth links and docker0 bridge by default.

 Macro too long. Please see the template.
{$NET.IF.IFOPERSTATUS.MATCHES}

Used for network interface discovery. Can be overridden on the host or linked template level.

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

Ignore notPresent(6)

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

Used in network interface discovery rule filters.

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

Ignore down(2) administrative status

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

Used in network interface discovery rule filters.

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

Used in network interface discovery rule filters.

 CHANGE_IF_NEEDED
{$NET.IF.IFALIAS.MATCHES}

Used in network interface discovery rule filters.

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

Used in network interface discovery rule filters.

 CHANGE_IF_NEEDED
{$NET.IF.IFTYPE.MATCHES}

Used in network interface discovery rule filters.

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

Used in network interface discovery rule filters.

 CHANGE_IF_NEEDED

Items

Name Description Type Key and additional info
SNMP walk block devices

MIB: UCD-DISKIO-MIB

SNMP walk through diskIOTable. The collected data used in filesystem LLD and dependent item prototypes.

 SNMP agent vfs.dev.walk
SNMP walk system CPUs

MIB: HOST-RESOURCES-MIB

Discovering system CPUs.

 SNMP agent system.cpu.walk
SNMP walk ZFS datasets

MIB: FREENAS-MIB

SNMP walk through datasetTable. The collected data used in ZFS dataset LLD and dependent item prototypes.

 SNMP agent truenas.zfs.dataset.walk
SNMP walk ZFS pools

MIB: FREENAS-MIB

SNMP walk through zpoolTable. The collected data used in ZFS pool LLD and dependent item prototypes.

 SNMP agent truenas.zfs.pools.walk
SNMP walk ZFS volumes

MIB: FREENAS-MIB

SNMP walk through zvolTable. The collected data used in ZFS volume LLD and dependent item prototypes.

 SNMP agent truenas.zfs.zvols.walk
SNMP walk disk temperatures

MIB: FREENAS-MIB

SNMP walk through hddTempTable. The collected data used in disk temperature LLD and dependent item prototypes.

 SNMP agent truenas.disk.temp.walk
SNMP walk ARC L2ARC

MIB: FREENAS-MIB

SNMP walk through arc and l2arc. The collected data used in dependent ARC and L2ARC items.

 SNMP agent truenas.zfs.arc_l2arc.walk
SNMP walk ZIL

MIB: FREENAS-MIB

SNMP walk through zil. The collected data used in dependent ZIL items.

 SNMP agent truenas.zfs.zil.walk
SNMP walk CPU load averages

MIB: UCD-SNMP-MIB

SNMP walk through laTable. The collected data used in dependent CPU load average items.

 SNMP agent system.cpu.load.walk

Preprocessing

  • SNMP walk to JSON
Interrupts per second

MIB: UCD-SNMP-MIB

Number of interrupts processed.

 SNMP agent system.cpu.intr

Preprocessing

  • Change per second
Context switches per second

MIB: UCD-SNMP-MIB

Number of context switches.

 SNMP agent system.cpu.switches

Preprocessing

  • Change per second
Load average (1m avg)

MIB: UCD-SNMP-MIB

The 1 minute load averages.

 Dependent item system.cpu.load.avg1

Preprocessing

  • JSON Path: $[?(@.laName == 'Load-1')].laLoad.first()
Load average (5m avg)

MIB: UCD-SNMP-MIB

The 5 minutes load averages.

 Dependent item system.cpu.load.avg5

Preprocessing

  • JSON Path: $[?(@.laName == 'Load-5')].laLoad.first()
Load average (15m avg)

MIB: UCD-SNMP-MIB

The 15 minutes load averages.

 Dependent item system.cpu.load.avg15

Preprocessing

  • JSON Path: $[?(@.laName == 'Load-15')].laLoad.first()
Number of CPUs

MIB: HOST-RESOURCES-MIB

Count the number of CPU cores by counting number of cores discovered in hrProcessorTable using LLD.

 Dependent item system.cpu.num

Preprocessing

  • SNMP walk to JSON

  • JavaScript: The text is too long. Please see the template.
Free memory

MIB: UCD-SNMP-MIB

The amount of real/physical memory currently unused or available.

 SNMP agent vm.memory.free

Preprocessing

  • Custom multiplier: 1024
Memory (buffers)

MIB: UCD-SNMP-MIB

The total amount of real or virtual memory currently allocated for use as memory buffers.

 SNMP agent vm.memory.buffers

Preprocessing

  • Custom multiplier: 1024
Memory (cached)

MIB: UCD-SNMP-MIB

The total amount of real or virtual memory currently allocated for use as cached memory.

 SNMP agent vm.memory.cached

Preprocessing

  • Custom multiplier: 1024
Total memory

MIB: UCD-SNMP-MIB

The total memory expressed in bytes.

 SNMP agent vm.memory.total

Preprocessing

  • Custom multiplier: 1024
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
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
Total swap space

MIB: UCD-SNMP-MIB

The total amount of swap space configured for this host.

 SNMP agent system.swap.total

Preprocessing

  • Custom multiplier: 1024
Free swap space

MIB: UCD-SNMP-MIB

The amount of swap space currently unused or available.

 SNMP agent system.swap.free

Preprocessing

  • Custom multiplier: 1024
Free swap space in %

The free space of the swap volume/file expressed in %.

 Calculated system.swap.pfree

Preprocessing

  • Check for not supported value: any error

    ⛔️Custom on fail: Set value to: 100
ARC size

MIB: FREENAS-MIB

ARC size in bytes.

 Dependent item truenas.zfs.arc.size

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.1.0

  • Custom multiplier: 1024

  • Discard unchanged with heartbeat: 1h
ARC metadata size

MIB: FREENAS-MIB

ARC metadata size used in bytes.

 Dependent item truenas.zfs.arc.meta

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.2.0

  • Custom multiplier: 1024
ARC data size

MIB: FREENAS-MIB

ARC data size used in bytes.

 Dependent item truenas.zfs.arc.data

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.3.0

  • Custom multiplier: 1024
ARC hits

MIB: FREENAS-MIB

Total amount of cache hits in the ARC per second.

 Dependent item truenas.zfs.arc.hits

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.4.0

  • Change per second
ARC misses

MIB: FREENAS-MIB

Total amount of cache misses in the ARC per second.

 Dependent item truenas.zfs.arc.misses

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.5.0

  • Change per second
ARC target size of cache

MIB: FREENAS-MIB

ARC target size of cache in bytes.

 Dependent item truenas.zfs.arc.c

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.6.0

  • Custom multiplier: 1024

  • Discard unchanged with heartbeat: 1h
ARC target size of MRU

MIB: FREENAS-MIB

ARC target size of MRU in bytes.

 Dependent item truenas.zfs.arc.p

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.7.0

  • Custom multiplier: 1024

  • Discard unchanged with heartbeat: 1h
ARC cache hit ratio

MIB: FREENAS-MIB

ARC cache hit ration percentage.

 Dependent item truenas.zfs.arc.hit.ratio

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.9.0
ARC cache miss ratio

MIB: FREENAS-MIB

ARC cache miss ration percentage.

 Dependent item truenas.zfs.arc.miss.ratio

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.4.10.0
L2ARC hits

MIB: FREENAS-MIB

Hits to the L2 cache per second.

 Dependent item truenas.zfs.l2arc.hits

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.5.1.0

  • Change per second
L2ARC misses

MIB: FREENAS-MIB

Misses to the L2 cache per second.

 Dependent item truenas.zfs.l2arc.misses

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.5.2.0

  • Change per second
L2ARC read rate

MIB: FREENAS-MIB

Read rate from L2 cache in bytes per second.

 Dependent item truenas.zfs.l2arc.read

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.5.3.0

  • Change per second
L2ARC write rate

MIB: FREENAS-MIB

Write rate from L2 cache in bytes per second.

 Dependent item truenas.zfs.l2arc.write

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.5.4.0

  • Change per second
L2ARC size

MIB: FREENAS-MIB

L2ARC size in bytes.

 Dependent item truenas.zfs.l2arc.size

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.5.5.0

  • Custom multiplier: 1024

  • Discard unchanged with heartbeat: 1h
ZIL operations 1 second

MIB: FREENAS-MIB

The ops column parsed from the command zilstat 1 1.

 Dependent item truenas.zfs.zil.ops1

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.6.1.0
ZIL operations 5 seconds

MIB: FREENAS-MIB

The ops column parsed from the command zilstat 5 1.

 Dependent item truenas.zfs.zil.ops5

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.6.2.0
ZIL operations 10 seconds

MIB: FREENAS-MIB

The ops column parsed from the command zilstat 10 1.

 Dependent item truenas.zfs.zil.ops10

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.6.3.0
Uptime (network)

MIB: SNMPv2-MIB

Time (in hundredths of a second) since the network management portion of the system was last re-initialized.

 SNMP agent system.net.uptime[sysUpTime.0]

Preprocessing

  • Custom multiplier: 0.01
Uptime (hardware)

MIB: HOST-RESOURCES-MIB

The amount of time since this host was last initialized. Note that this is different from sysUpTime in the SNMPv2-MIB [RFC1907] because sysUpTime is the uptime of the network management portion of the system.

 SNMP agent system.hw.uptime[hrSystemUptime.0]

Preprocessing

  • Check for not supported value: any error

    ⛔️Custom on fail: Set value to: 0

  • Custom multiplier: 0.01
SNMP traps (fallback)

The item is used to collect all SNMP traps unmatched by other snmptrap items

 SNMP trap snmptrap.fallback
System location

MIB: SNMPv2-MIB

Physical location of the node (e.g., equipment room, 3rd floor). If not provided, the value is a zero-length string.

 SNMP agent system.location[sysLocation.0]

Preprocessing

  • Discard unchanged with heartbeat: 12h
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 agent system.contact[sysContact.0]

Preprocessing

  • Discard unchanged with heartbeat: 12h
System object ID

MIB: SNMPv2-MIB

The vendor's 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 determiningwhat kind of box' is being managed. For example, if vendorFlintstones, Inc.' was assigned the subtree1.3.6.1.4.1.4242, it could assign the identifier 1.3.6.1.4.1.4242.1.1 to its `Fred Router'.

 SNMP agent system.objectid[sysObjectID.0]

Preprocessing

  • Discard unchanged with heartbeat: 12h
System name

MIB: SNMPv2-MIB

An administratively-assigned name for this managed node.By convention, this is the node's fully-qualified domain name. If the name is unknown, the value is the zero-length string.

 SNMP agent system.name

Preprocessing

  • Discard unchanged with heartbeat: 12h
System description

MIB: SNMPv2-MIB

A textual description of the entity. This value should

include the full name and version identification of the system's hardware type, software operating-system, and

networking software.

 SNMP agent system.descr[sysDescr.0]

Preprocessing

  • Discard unchanged with heartbeat: 12h
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]
ICMP ping

The host accessibility by ICMP ping.

0 - ICMP ping fails;

1 - ICMP ping successful.

 Simple check icmpping
ICMP loss

The percentage of lost packets.

 Simple check icmppingloss
ICMP response time

The ICMP ping response time (in seconds).

 Simple check icmppingsec
TrueNAS CORE: SNMP walk network interfaces

Discovering interfaces from IF-MIB.

 SNMP agent net.if.walk

Triggers

Name Description Expression Severity Dependencies and additional info
TrueNAS CORE: Load average is too high

The load average per CPU is too high. The system may be slow to respond.

 min(/TrueNAS CORE by SNMP/system.cpu.load.avg1,5m)/last(/TrueNAS CORE by SNMP/system.cpu.num)>{$LOAD_AVG_PER_CPU.MAX.WARN} and last(/TrueNAS CORE by SNMP/system.cpu.load.avg5)>0 and last(/TrueNAS CORE by SNMP/system.cpu.load.avg15)>0 Average
TrueNAS CORE: Lack of available memory

The system is running out of memory.

 min(/TrueNAS CORE by SNMP/vm.memory.available,5m)<{$MEMORY.AVAILABLE.MIN} and last(/TrueNAS CORE by SNMP/vm.memory.total)>0 Average
TrueNAS CORE: High memory utilization

The system is running out of free memory.

 min(/TrueNAS CORE by SNMP/vm.memory.util,5m)>{$MEMORY.UTIL.MAX} Average Depends on:
  • TrueNAS CORE: Lack of available memory
TrueNAS CORE: High swap space usage

If there is no swap configured, this trigger is ignored.

 min(/TrueNAS CORE by SNMP/system.swap.pfree,5m)<{$SWAP.PFREE.MIN.WARN} and last(/TrueNAS CORE by SNMP/system.swap.total)>0 Warning Depends on:
  • TrueNAS CORE: Lack of available memory
  • TrueNAS CORE: High memory utilization
TrueNAS CORE: Host has been restarted

Uptime is less than 10 minutes.

 (last(/TrueNAS CORE by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/TrueNAS CORE by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/TrueNAS CORE by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/TrueNAS CORE by SNMP/system.net.uptime[sysUpTime.0])<10m) Warning Manual close: Yes
Depends on:
  • TrueNAS CORE: No SNMP data collection
TrueNAS CORE: System name has changed

The name of the system has changed. Acknowledge to close the problem manually.

 last(/TrueNAS CORE by SNMP/system.name,#1)<>last(/TrueNAS CORE by SNMP/system.name,#2) and length(last(/TrueNAS CORE by SNMP/system.name))>0 Info Manual close: Yes
TrueNAS CORE: No SNMP data collection

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

 max(/TrueNAS CORE by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 Warning Depends on:
  • TrueNAS CORE: Unavailable by ICMP ping
TrueNAS CORE: Unavailable by ICMP ping

Last three attempts returned timeout. Please check device connectivity.

 max(/TrueNAS CORE by SNMP/icmpping,#3)=0 High
TrueNAS CORE: High ICMP ping loss

ICMP packets loss detected.

 min(/TrueNAS CORE by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/TrueNAS CORE by SNMP/icmppingloss,5m)<100 Warning Depends on:
  • TrueNAS CORE: Unavailable by ICMP ping
TrueNAS CORE: High ICMP ping response time

Average ICMP response time is too high.

 avg(/TrueNAS CORE by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} Warning Depends on:
  • TrueNAS CORE: High ICMP ping loss
  • TrueNAS CORE: Unavailable by ICMP ping

LLD rule CPU discovery

Name Description Type Key and additional info
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 item cpu.discovery

Preprocessing

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

Item prototypes for CPU discovery

Name Description Type Key and additional info
CPU idle time

MIB: UCD-SNMP-MIB

The time the CPU has spent doing nothing.

 Dependent item system.cpu.idle[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.11.11.0
CPU system time

MIB: UCD-SNMP-MIB

The time the CPU has spent running the kernel and its processes.

 Dependent item system.cpu.system[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.11.52.0

  • Change per second

  • JavaScript: The text is too long. Please see the template.
CPU user time

MIB: UCD-SNMP-MIB

The time the CPU has spent running users' processes that are not niced.

 Dependent item system.cpu.user[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.11.50.0

  • Change per second

  • JavaScript: The text is too long. Please see the template.
CPU nice time

MIB: UCD-SNMP-MIB

The time the CPU has spent running users' processes that have been niced.

 Dependent item system.cpu.nice[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.11.51.0

  • Change per second

  • JavaScript: The text is too long. Please see the template.
CPU iowait time

MIB: UCD-SNMP-MIB

The amount of time the CPU has been waiting for I/O to complete.

 Dependent item system.cpu.iowait[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.11.54.0

  • Change per second

  • JavaScript: The text is too long. Please see the template.
CPU interrupt time

MIB: UCD-SNMP-MIB

The amount of time the CPU has been servicing hardware interrupts.

 Dependent item system.cpu.interrupt[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.11.56.0

  • Change per second

  • JavaScript: The text is too long. Please see the template.
CPU utilization

The CPU utilization expressed in %.

 Dependent item system.cpu.util[{#SNMPINDEX}]

Preprocessing

  • JavaScript: //Calculate utilization<br>return (100 - value)

Trigger prototypes for CPU discovery

Name Description Expression Severity Dependencies and additional info
TrueNAS CORE: High CPU utilization

The CPU utilization is too high. The system might be slow to respond.

 min(/TrueNAS CORE by SNMP/system.cpu.util[{#SNMPINDEX}],5m)>{$CPU.UTIL.CRIT} Warning Depends on:
  • TrueNAS CORE: Load average is too high

LLD rule Block devices discovery

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).

 Dependent item vfs.dev.discovery

Preprocessing

  • SNMP walk to JSON

  • Discard unchanged with heartbeat: 1h

Item prototypes for Block devices discovery

Name Description Type Key and additional info
TrueNAS CORE: [{#DEVNAME}]: Disk read rate

MIB: UCD-DISKIO-MIB

The number of read accesses from this device since boot.

 Dependent item vfs.dev.read.rate[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.13.15.1.1.5.{#SNMPINDEX}

  • Change per second
TrueNAS CORE: [{#DEVNAME}]: Disk write rate

MIB: UCD-DISKIO-MIB

The number of write accesses from this device since boot.

 Dependent item vfs.dev.write.rate[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.13.15.1.1.6.{#SNMPINDEX}

  • Change per second
TrueNAS CORE: [{#DEVNAME}]: Disk utilization

MIB: UCD-DISKIO-MIB

The 1 minute average load of disk (%).

 Dependent item vfs.dev.util[{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.2021.13.15.1.1.9.{#SNMPINDEX}

LLD rule ZFS pools discovery

Name Description Type Key and additional info
ZFS pools discovery

ZFS pools discovery from FREENAS-MIB.

 Dependent item truenas.zfs.pools.discovery

Preprocessing

  • SNMP walk to JSON

  • Discard unchanged with heartbeat: 6h

Item prototypes for ZFS pools discovery

Name Description Type Key and additional info
Pool [{#POOLNAME}]: Total space

MIB: FREENAS-MIB

The size of the storage pool in bytes.

 Dependent item truenas.zpool.size.total[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.4.{#SNMPINDEX}

  • Custom multiplier: {#POOL_ALLOC_UNITS}

  • Discard unchanged with heartbeat: 1h
Pool [{#POOLNAME}]: Used space

MIB: FREENAS-MIB

The used size of the storage pool in bytes.

 Dependent item truenas.zpool.used[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.5.{#SNMPINDEX}

  • Custom multiplier: {#POOL_ALLOC_UNITS}
Pool [{#POOLNAME}]: Available space

MIB: FREENAS-MIB

The available size of the storage pool in bytes.

 Dependent item truenas.zpool.avail[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.6.{#SNMPINDEX}

  • Custom multiplier: {#POOL_ALLOC_UNITS}
Pool [{#POOLNAME}]: Usage in %

The used size of the storage pool in %.

 Calculated truenas.zpool.pused[{#POOLNAME}]
Pool [{#POOLNAME}]: Health

MIB: FREENAS-MIB

The current health of the containing pool, as reported by zpool status.

 Dependent item truenas.zpool.health[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.7.{#SNMPINDEX}

  • Discard unchanged with heartbeat: 1h
Pool [{#POOLNAME}]: Read operations rate

MIB: FREENAS-MIB

The number of read I/O operations sent to the pool or device, including metadata requests (averaged since system booted).

 Dependent item truenas.zpool.read.ops[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.8.{#SNMPINDEX}

  • Change per second
Pool [{#POOLNAME}]: Write operations rate

MIB: FREENAS-MIB

The number of write I/O operations sent to the pool or device (averaged since system booted).

 Dependent item truenas.zpool.write.ops[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.9.{#SNMPINDEX}

  • Change per second
Pool [{#POOLNAME}]: Read rate

MIB: FREENAS-MIB

The bandwidth of all read operations (including metadata), expressed as units per second (averaged since system booted).

 Dependent item truenas.zpool.read.bytes[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.10.{#SNMPINDEX}

  • Custom multiplier: {#POOL_ALLOC_UNITS}

  • Change per second
Pool [{#POOLNAME}]: Write rate

MIB: FREENAS-MIB

The bandwidth of all write operations, expressed as units per second (averaged since system booted).

 Dependent item truenas.zpool.write.bytes[{#POOLNAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.1.1.1.11.{#SNMPINDEX}

  • Custom multiplier: {#POOL_ALLOC_UNITS}

  • Change per second

Trigger prototypes for ZFS pools discovery

Name Description Expression Severity Dependencies and additional info
TrueNAS CORE: Pool [{#POOLNAME}]: Very high space usage

Two conditions should match:
1. The first condition - utilization of the space should be above {$ZPOOL.PUSED.MAX.CRIT:"{#POOLNAME}"}%.
2. The second condition - the pool free space is less than {$ZPOOL.FREE.MIN.CRIT:"{#POOLNAME}"}.

 min(/TrueNAS CORE by SNMP/truenas.zpool.pused[{#POOLNAME}],5m) > {$ZPOOL.PUSED.MAX.CRIT:"{#POOLNAME}"} and last(/TrueNAS CORE by SNMP/truenas.zpool.avail[{#POOLNAME}]) < {$ZPOOL.FREE.MIN.CRIT:"{#POOLNAME}"} Average
TrueNAS CORE: Pool [{#POOLNAME}]: High space usage

Two conditions should match:
1. The first condition - utilization of the space should be above {$ZPOOL.PUSED.MAX.WARN:"{#POOLNAME}"}%.
2. The second condition - the pool free space is less than {$ZPOOL.FREE.MIN.WARN:"{#POOLNAME}"}.

 min(/TrueNAS CORE by SNMP/truenas.zpool.pused[{#POOLNAME}],5m) > {$ZPOOL.PUSED.MAX.WARN:"{#POOLNAME}"} and last(/TrueNAS CORE by SNMP/truenas.zpool.avail[{#POOLNAME}]) < {$ZPOOL.FREE.MIN.WARN:"{#POOLNAME}"} Warning Depends on:
  • TrueNAS CORE: Pool [{#POOLNAME}]: Very high space usage
TrueNAS CORE: Pool [{#POOLNAME}]: Status is not online

Please check pool status.

 last(/TrueNAS CORE by SNMP/truenas.zpool.health[{#POOLNAME}]) <> 0 Average

LLD rule ZFS datasets discovery

Name Description Type Key and additional info
ZFS datasets discovery

ZFS datasets discovery from FREENAS-MIB.

 Dependent item truenas.zfs.dataset.discovery

Preprocessing

  • SNMP walk to JSON

  • Discard unchanged with heartbeat: 6h

Item prototypes for ZFS datasets discovery

Name Description Type Key and additional info
Dataset [{#DATASET_NAME}]: Total space

MIB: FREENAS-MIB

The size of the dataset in bytes.

 Dependent item truenas.dataset.size.total[{#DATASET_NAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.2.1.1.4.{#SNMPINDEX}

  • Custom multiplier: {#DATASET_ALLOC_UNITS}

  • Discard unchanged with heartbeat: 1h
Dataset [{#DATASET_NAME}]: Used space

MIB: FREENAS-MIB

The used size of the dataset in bytes.

 Dependent item truenas.dataset.used[{#DATASET_NAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.2.1.1.5.{#SNMPINDEX}

  • Custom multiplier: {#DATASET_ALLOC_UNITS}
Dataset [{#DATASET_NAME}]: Available space

MIB: FREENAS-MIB

The available size of the dataset in bytes.

 Dependent item truenas.dataset.avail[{#DATASET_NAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.2.1.1.6.{#SNMPINDEX}

  • Custom multiplier: {#DATASET_ALLOC_UNITS}
Dataset [{#DATASET_NAME}]: Usage in %

The used size of the dataset in %.

 Calculated truenas.dataset.pused[{#DATASET_NAME}]

Trigger prototypes for ZFS datasets discovery

Name Description Expression Severity Dependencies and additional info
TrueNAS CORE: Dataset [{#DATASET_NAME}]: Very high space usage

Two conditions should match:
1. The first condition - utilization of the space should be above {$DATASET.PUSED.MAX.CRIT:"{#DATASET_NAME}"}%.
2. The second condition - the dataset free space is less than {$DATASET.FREE.MIN.CRIT:"{#POOLNAME}"}.

 min(/TrueNAS CORE by SNMP/truenas.dataset.pused[{#DATASET_NAME}],5m) > {$DATASET.PUSED.MAX.CRIT:"{#DATASET_NAME}"} and last(/TrueNAS CORE by SNMP/truenas.dataset.avail[{#DATASET_NAME}]) < {$DATASET.FREE.MIN.CRIT:"{#POOLNAME}"} Average
TrueNAS CORE: Dataset [{#DATASET_NAME}]: High space usage

Two conditions should match:
1. The first condition - utilization of the space should be above {$DATASET.PUSED.MAX.WARN:"{#DATASET_NAME}"}%.
2. The second condition - the dataset free space is less than {$DATASET.FREE.MIN.WARN:"{#POOLNAME}"}.

 min(/TrueNAS CORE by SNMP/truenas.dataset.pused[{#DATASET_NAME}],5m) > {$DATASET.PUSED.MAX.WARN:"{#DATASET_NAME}"} and last(/TrueNAS CORE by SNMP/truenas.dataset.avail[{#DATASET_NAME}]) < {$DATASET.FREE.MIN.WARN:"{#POOLNAME}"} Warning Depends on:
  • TrueNAS CORE: Dataset [{#DATASET_NAME}]: Very high space usage

LLD rule ZFS volumes discovery

Name Description Type Key and additional info
ZFS volumes discovery

ZFS volumes discovery from FREENAS-MIB.

 Dependent item truenas.zfs.zvols.discovery

Preprocessing

  • SNMP walk to JSON

  • Discard unchanged with heartbeat: 6h

Item prototypes for ZFS volumes discovery

Name Description Type Key and additional info
TrueNAS CORE: ZFS volume [{#ZVOL_NAME}]: Total space

MIB: FREENAS-MIB

The size of the ZFS volume in bytes.

 Dependent item truenas.zvol.size.total[{#ZVOL_NAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.3.1.1.4.{#SNMPINDEX}

  • Custom multiplier: {#ZVOL_ALLOC_UNITS}

  • Discard unchanged with heartbeat: 1h
TrueNAS CORE: ZFS volume [{#ZVOL_NAME}]: Used space

MIB: FREENAS-MIB

The used size of the ZFS volume in bytes.

 Dependent item truenas.zvol.used[{#ZVOL_NAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.3.1.1.5.{#SNMPINDEX}

  • Custom multiplier: {#ZVOL_ALLOC_UNITS}
TrueNAS CORE: ZFS volume [{#ZVOL_NAME}]: Available space

MIB: FREENAS-MIB

The available of the ZFS volume in bytes.

 Dependent item truenas.zvol.avail[{#ZVOL_NAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.1.3.1.1.6.{#SNMPINDEX}

  • Custom multiplier: {#ZVOL_ALLOC_UNITS}

LLD rule Disks temperature discovery

Name Description Type Key and additional info
Disks temperature discovery

Disks temperature discovery from FREENAS-MIB.

 Dependent item truenas.disk.temp.discovery

Preprocessing

  • SNMP walk to JSON

    ⛔️Custom on fail: Discard value

  • Discard unchanged with heartbeat: 6h

Item prototypes for Disks temperature discovery

Name Description Type Key and additional info
Disk [{#DISK_NAME}]': Temperature

MIB: FREENAS-MIB

The temperature of this HDD in mC.

 Dependent item truenas.disk.temp[{#DISK_NAME}]

Preprocessing

  • SNMP walk value: 1.3.6.1.4.1.50536.3.1.3.{#SNMPINDEX}

  • Custom multiplier: 0.001

  • Discard unchanged with heartbeat: 1h

Trigger prototypes for Disks temperature discovery

Name Description Expression Severity Dependencies and additional info
TrueNAS CORE: Disk [{#DISK_NAME}]': Average disk temperature is too high

Disk temperature is high.

 avg(/TrueNAS CORE by SNMP/truenas.disk.temp[{#DISK_NAME}],5m) > {$TEMPERATURE.MAX.CRIT:"{#DISK_NAME}"} Average
TrueNAS CORE: Disk [{#DISK_NAME}]': Average disk temperature is too high

Disk temperature is high.

 avg(/TrueNAS CORE by SNMP/truenas.disk.temp[{#DISK_NAME}],5m) > {$TEMPERATURE.MAX.WARN:"{#DISK_NAME}"} Warning

LLD rule Network interfaces discovery

Name Description Type Key and additional info
Network interfaces discovery

Discovering interfaces from IF-MIB.

 Dependent item 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}): 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[ifOperStatus.{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.8.{#SNMPINDEX}
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[ifHCInOctets.{#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}): 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[ifHCOutOctets.{#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}): 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[ifInErrors.{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.14.{#SNMPINDEX}

  • Change per second

  • Discard unchanged with heartbeat: 3m
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[ifOutErrors.{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.20.{#SNMPINDEX}

  • Change per second

  • Discard unchanged with heartbeat: 3m
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[ifOutDiscards.{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.19.{#SNMPINDEX}

  • Change per second

  • Discard unchanged with heartbeat: 3m
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[ifInDiscards.{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.13.{#SNMPINDEX}

  • Change per second

  • Discard unchanged with heartbeat: 3m
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[ifType.{#SNMPINDEX}]

Preprocessing

  • SNMP walk value: 1.3.6.1.2.1.2.2.1.3.{#SNMPINDEX}

  • Discard unchanged with heartbeat: 1d
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[ifHighSpeed.{#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

Trigger prototypes for Network interfaces discovery

Name Description Expression Severity Dependencies and additional info
TrueNAS CORE: 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 the context macro to "0", marking this interface as not important. No new trigger will be fired if this interface is down.
3. last(/TEMPLATE_NAME/METRIC,#1)<>last(/TEMPLATE_NAME/METRIC,#2) - the trigger fires only if the operational status was up to (1) sometime before (so, does not fire for "eternal off" interfaces.)

WARNING: if closed manually - it will not fire again on the next poll, because of .diff.

 {$IFCONTROL:"{#IFNAME}"}=1 and last(/TrueNAS CORE by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/TrueNAS CORE by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/TrueNAS CORE by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2)) Average Manual close: Yes
TrueNAS CORE: Interface {#IFNAME}({#IFALIAS}): High bandwidth usage

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

 (avg(/TrueNAS CORE by SNMP/net.if.in[ifHCInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/TrueNAS CORE by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}]) or avg(/TrueNAS CORE by SNMP/net.if.out[ifHCOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/TrueNAS CORE by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])) and last(/TrueNAS CORE by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])>0 Warning Manual close: Yes
Depends on:
  • TrueNAS CORE: Interface {#IFNAME}({#IFALIAS}): Link down
TrueNAS CORE: Interface {#IFNAME}({#IFALIAS}): High error rate

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

 min(/TrueNAS CORE by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/TrueNAS CORE by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Manual close: Yes
Depends on:
  • TrueNAS CORE: Interface {#IFNAME}({#IFALIAS}): Link down
TrueNAS CORE: 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(/TrueNAS CORE by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])<0 and last(/TrueNAS CORE by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])>0 and ( last(/TrueNAS CORE by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/TrueNAS CORE by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/TrueNAS CORE by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/TrueNAS CORE by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/TrueNAS CORE by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/TrueNAS CORE by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/TrueNAS CORE by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])<>2) Info Manual close: Yes
Depends on:
  • TrueNAS CORE: Interface {#IFNAME}({#IFALIAS}): Link down

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

Articles and documentation

+ Propose new article

Vous n’avez pas trouvé ce que vous cherchiez ?

Request custom integration

Zabbix integration team will develop custom integration based on your requirements and Zabbix best practices.

Request

Propose your integration

Have you already developed high quality integration and want to submit to Zabbix integration repository?

Propose