TrueNAS

Available solutions




This template is for Zabbix version: 6.4
Also available for: 6.2 6.0

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

TrueNAS by SNMP

Overview

For Zabbix version: 6.4 and higher. Template for monitoring TrueNAS by SNMP

This template was tested on:

  • TrueNAS Core, version 12.0-U8

Setup

See Zabbix template operation for basic instructions.

  1. Import template into Zabbix
  2. Enable SNMP daemon at Services in TrueNAS web interface https://www.truenas.com/docs/core/services/snmp
  3. 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
{$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
{$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.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(.+)?$)
{$DATASET.PUSED.MAX.CRIT}

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

 90
{$DATASET.PUSED.MAX.WARN}

Threshold of used dataset space for warning trigger in %.

 80
{$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.NOT_MATCHES}

This macro used in filters of network interfaces discovery rule.

 CHANGE_IF_NEEDED
{$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
{$SWAP.PFREE.MIN.WARN}

Threshold of free swap space for warning trigger in %.

 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
{$TEMPERATURE.MAX.WARN}

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

 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]*|sd[a-z][0-9]+|nbd[0-9]+|sr[0-9]+|fd[0-9]+|dm-[0-9]+|ram[0-9]+|ploop[a-z0-9]+|md[0-9]*|hcp[0-9]*|cd[0-9]*|pass[0-9]*|zram[0-9]*)
{$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
{$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.PUSED.MAX.WARN}

Threshold of used pool space for warning trigger in %.

 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.
Disks temperature discovery

Disks temperature discovery from FREENAS-MIB.

 SNMP truenas.disk.temp.discovery

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h
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 @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}
ZFS datasets discovery

ZFS datasets discovery from FREENAS-MIB.

 SNMP truenas.zfs.dataset.discovery

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Filter:

AND

- {#DATASET_NAME} MATCHES_REGEX {$DATASET.NAME.MATCHES}

- {#DATASET_NAME} NOT_MATCHES_REGEX {$DATASET.NAME.NOT_MATCHES}
ZFS pools discovery

ZFS pools discovery from FREENAS-MIB.

 SNMP truenas.zfs.pools.discovery

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h
ZFS volumes discovery

ZFS volumes discovery from FREENAS-MIB.

 SNMP truenas.zfs.zvols.discovery

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h

Items collected

Group Name Description Type Key and additional info
CPU TrueNAS: Interrupts per second

MIB: UCD-SNMP-MIB

Number of interrupts processed.

 SNMP system.cpu.intr

Preprocessing:

- CHANGE_PER_SECOND
CPU TrueNAS: Context switches per second

MIB: UCD-SNMP-MIB

Number of context switches.

 SNMP system.cpu.switches

Preprocessing:

- CHANGE_PER_SECOND
CPU TrueNAS: Load average (1m avg)

MIB: UCD-SNMP-MIB

The 1 minute load averages.

 SNMP system.cpu.load.avg1
CPU TrueNAS: Load average (5m avg)

MIB: UCD-SNMP-MIB

The 5 minutes load averages.

 SNMP system.cpu.load.avg5
CPU TrueNAS: Load average (15m avg)

MIB: UCD-SNMP-MIB

The 15 minutes load averages.

 SNMP system.cpu.load.avg15
CPU TrueNAS: 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 TrueNAS: CPU idle time

MIB: UCD-SNMP-MIB

The time the CPU has spent doing nothing.

 SNMP system.cpu.idle[{#SNMPINDEX}]
CPU TrueNAS: 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 TrueNAS: 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 TrueNAS: 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 TrueNAS: CPU iowait time

MIB: UCD-SNMP-MIB

The 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 TrueNAS: 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 TrueNAS: CPU utilization

The CPU utilization expressed in %.

 DEPENDENT system.cpu.util[{#SNMPINDEX}]

Preprocessing:

- JAVASCRIPT: //Calculate utilization return (100 - value)
General TrueNAS: 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 TrueNAS: System description

MIB: SNMPv2-MIB

System description of the host.

 SNMP system.descr

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h
General TrueNAS: 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 TrueNAS: System name

MIB: SNMPv2-MIB

The host name of the system.

 SNMP system.name

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 6h
General TrueNAS: 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 TrueNAS: Free memory

MIB: UCD-SNMP-MIB

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

 SNMP vm.memory.free

Preprocessing:

- MULTIPLIER: 1024
Memory TrueNAS: 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 TrueNAS: 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 TrueNAS: Total memory

MIB: UCD-SNMP-MIB

The total memory expressed in Bytes.

 SNMP vm.memory.total

Preprocessing:

- MULTIPLIER: 1024
Memory TrueNAS: 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 TrueNAS: 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 TrueNAS: 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 TrueNAS: Free swap space

MIB: UCD-SNMP-MIB

The amount of swap space currently unused or available.

 SNMP system.swap.free

Preprocessing:

- MULTIPLIER: 1024
Memory TrueNAS: Free swap space in %

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

 CALCULATED system.swap.pfree

Expression:

last(//system.swap.free)/last(//system.swap.total)*100
Network interfaces TrueNAS: 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 TrueNAS: 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 TrueNAS: 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: `</p><p>- MULTIPLIER:8`
Network interfaces TrueNAS: 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 TrueNAS: 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 TrueNAS: 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: `</p><p>- MULTIPLIER:8`
Network interfaces TrueNAS: 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 ofn-500,000' ton+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.</p> |SNMP |net.if.speed[{#SNMPINDEX}]<p>**Preprocessing**:</p><p>- MULTIPLIER:1000000</p><p>- DISCARD_UNCHANGED_HEARTBEAT:1h`
Network interfaces TrueNAS: 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 TrueNAS: 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
Status TrueNAS: ICMP ping

Host accessibility by ICMP.

0 - ICMP ping fails.

1 - ICMP ping successful.

 SIMPLE icmpping
Status TrueNAS: ICMP loss

Percentage of lost packets.

 SIMPLE icmppingloss
Status TrueNAS: ICMP response time

ICMP ping response time (in seconds).

 SIMPLE icmppingsec
Status TrueNAS: Uptime

MIB: SNMPv2-MIB

The system uptime expressed in the following format:"N days, hh:mm:ss".

 SNMP system.uptime

Preprocessing:

- MULTIPLIER: 0.01
Status TrueNAS: 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 TrueNAS: [{#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 TrueNAS: [{#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 TrueNAS: [{#DEVNAME}]: Disk utilization

MIB: UCD-DISKIO-MIB

The 1 minute average load of disk (%).

 SNMP vfs.dev.util[{#SNMPINDEX}]
TrueNAS TrueNAS: ARC size

MIB: FREENAS-MIB

ARC size in bytes.

 SNMP truenas.zfs.arc.size

Preprocessing:

- MULTIPLIER: 1024

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: ARC metadata size

MIB: FREENAS-MIB

ARC metadata size used in bytes.

 SNMP truenas.zfs.arc.meta

Preprocessing:

- MULTIPLIER: 1024
TrueNAS TrueNAS: ARC data size

MIB: FREENAS-MIB

ARC data size used in bytes.

 SNMP truenas.zfs.arc.data

Preprocessing:

- MULTIPLIER: 1024
TrueNAS TrueNAS: ARC hits

MIB: FREENAS-MIB

Total amount of cache hits in the ARC per second.

 SNMP truenas.zfs.arc.hits

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: ARC misses

MIB: FREENAS-MIB

Total amount of cache misses in the ARC per second.

 SNMP truenas.zfs.arc.misses

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: ARC target size of cache

MIB: FREENAS-MIB

ARC target size of cache in bytes.

 SNMP truenas.zfs.arc.c

Preprocessing:

- MULTIPLIER: 1024

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: ARC target size of MRU

MIB: FREENAS-MIB

ARC target size of MRU in bytes.

 SNMP truenas.zfs.arc.p

Preprocessing:

- MULTIPLIER: 1024

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: ARC cache hit ratio

MIB: FREENAS-MIB

ARC cache hit ration percentage.

 SNMP truenas.zfs.arc.hit.ratio
TrueNAS TrueNAS: ARC cache miss ratio

MIB: FREENAS-MIB

ARC cache miss ration percentage.

 SNMP truenas.zfs.arc.miss.ratio
TrueNAS TrueNAS: L2ARC hits

MIB: FREENAS-MIB

Hits to the L2 cache per second.

 SNMP truenas.zfs.l2arc.hits

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: L2ARC misses

MIB: FREENAS-MIB

Misses to the L2 cache per second.

 SNMP truenas.zfs.l2arc.misses

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: L2ARC read rate

MIB: FREENAS-MIB

Read rate from L2 cache in bytes per second.

 SNMP truenas.zfs.l2arc.read

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: L2ARC write rate

MIB: FREENAS-MIB

Write rate from L2 cache in bytes per second.

 SNMP truenas.zfs.l2arc.write

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: L2ARC size

MIB: FREENAS-MIB

L2ARC size in bytes.

 SNMP truenas.zfs.l2arc.size

Preprocessing:

- MULTIPLIER: 1024

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: ZIL operations 1 second

MIB: FREENAS-MIB

The ops column parsed from the command zilstat 1 1.

 SNMP truenas.zfs.zil.ops1
TrueNAS TrueNAS: ZIL operations 5 seconds

MIB: FREENAS-MIB

The ops column parsed from the command zilstat 5 1.

 SNMP truenas.zfs.zil.ops5
TrueNAS TrueNAS: ZIL operations 10 seconds

MIB: FREENAS-MIB

The ops column parsed from the command zilstat 10 1.

 SNMP truenas.zfs.zil.ops10
TrueNAS TrueNAS: Pool [{#POOLNAME}]: Total space

MIB: FREENAS-MIB

The size of the storage pool in bytes.

 SNMP truenas.zpool.size.total[{#POOLNAME}]

Preprocessing:

- MULTIPLIER: {#POOL_ALLOC_UNITS}

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: Pool [{#POOLNAME}]: Used space

MIB: FREENAS-MIB

The used size of the storage pool in bytes.

 SNMP truenas.zpool.used[{#POOLNAME}]

Preprocessing:

- MULTIPLIER: {#POOL_ALLOC_UNITS}
TrueNAS TrueNAS: Pool [{#POOLNAME}]: Available space

MIB: FREENAS-MIB

The available size of the storage pool in bytes.

 SNMP truenas.zpool.avail[{#POOLNAME}]

Preprocessing:

- MULTIPLIER: {#POOL_ALLOC_UNITS}
TrueNAS TrueNAS: Pool [{#POOLNAME}]: Usage in %

The used size of the storage pool in %.

 CALCULATED truenas.zpool.pused[{#POOLNAME}]

Expression:

last(//truenas.zpool.used[{#POOLNAME}]) * 100 / last(//truenas.zpool.size.total[{#POOLNAME}])
TrueNAS TrueNAS: Pool [{#POOLNAME}]: Health

MIB: FREENAS-MIB

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

 SNMP truenas.zpool.health[{#POOLNAME}]

Preprocessing:

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: 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).

 SNMP truenas.zpool.read.ops[{#POOLNAME}]

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: 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).

 SNMP truenas.zpool.write.ops[{#POOLNAME}]

Preprocessing:

- CHANGE_PER_SECOND
TrueNAS TrueNAS: Pool [{#POOLNAME}]: Read rate

MIB: FREENAS-MIB

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

 SNMP truenas.zpool.read.bytes[{#POOLNAME}]

Preprocessing:

- MULTIPLIER: {#POOL_ALLOC_UNITS}

- CHANGE_PER_SECOND
TrueNAS TrueNAS: Pool [{#POOLNAME}]: Write rate

MIB: FREENAS-MIB

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

 SNMP truenas.zpool.write.bytes[{#POOLNAME}]

Preprocessing:

- MULTIPLIER: {#POOL_ALLOC_UNITS}

- CHANGE_PER_SECOND
TrueNAS TrueNAS: Dataset [{#DATASET_NAME}]: Total space

MIB: FREENAS-MIB

The size of the dataset in bytes.

 SNMP truenas.dataset.size.total[{#DATASET_NAME}]

Preprocessing:

- MULTIPLIER: {#DATASET_ALLOC_UNITS}

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: Dataset [{#DATASET_NAME}]: Used space

MIB: FREENAS-MIB

The used size of the dataset in bytes.

 SNMP truenas.dataset.used[{#DATASET_NAME}]

Preprocessing:

- MULTIPLIER: {#DATASET_ALLOC_UNITS}
TrueNAS TrueNAS: Dataset [{#DATASET_NAME}]: Available space

MIB: FREENAS-MIB

The available size of the dataset in bytes.

 SNMP truenas.dataset.avail[{#DATASET_NAME}]

Preprocessing:

- MULTIPLIER: {#DATASET_ALLOC_UNITS}
TrueNAS TrueNAS: Dataset [{#DATASET_NAME}]: Usage in %

The used size of the dataset in %.

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

Expression:

last(//truenas.dataset.used[{#DATASET_NAME}]) * 100 / last(//truenas.dataset.size.total[{#DATASET_NAME}])
TrueNAS TrueNAS: ZFS volume [{#ZVOL_NAME}]: Total space

MIB: FREENAS-MIB

The size of the ZFS volume in bytes.

 SNMP truenas.zvol.size.total[{#ZVOL_NAME}]

Preprocessing:

- MULTIPLIER: {#ZVOL_ALLOC_UNITS}

- DISCARD_UNCHANGED_HEARTBEAT: 1h
TrueNAS TrueNAS: ZFS volume [{#ZVOL_NAME}]: Used space

MIB: FREENAS-MIB

The used size of the ZFS volume in bytes.

 SNMP truenas.zvol.used[{#ZVOL_NAME}]

Preprocessing:

- MULTIPLIER: {#ZVOL_ALLOC_UNITS}
TrueNAS TrueNAS: ZFS volume [{#ZVOL_NAME}]: Available space

MIB: FREENAS-MIB

The available of the ZFS volume in bytes.

 SNMP truenas.zvol.avail[{#ZVOL_NAME}]

Preprocessing:

- MULTIPLIER: {#ZVOL_ALLOC_UNITS}
TrueNAS TrueNAS: Disk [{#DISK_NAME}]: Temperature

MIB: FREENAS-MIB

The temperature of this HDD in mC.

 SNMP truenas.disk.temp[{#DISK_NAME}]

Preprocessing:

- MULTIPLIER: 0.001

- DISCARD_UNCHANGED_HEARTBEAT: 1h

Triggers

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

Per CPU load average is too high. Your system may be slow to respond.

 min(/TrueNAS by SNMP/system.cpu.load.avg1,5m)/last(/TrueNAS by SNMP/system.cpu.num)>{$LOAD_AVG_PER_CPU.MAX.WARN} and last(/TrueNAS by SNMP/system.cpu.load.avg5)>0 and last(/TrueNAS by SNMP/system.cpu.load.avg15)>0 AVERAGE
TrueNAS: High CPU utilization

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

 min(/TrueNAS by SNMP/system.cpu.util[{#SNMPINDEX}],5m)>{$CPU.UTIL.CRIT} WARNING

Depends on:

- TrueNAS: Load average is too high
TrueNAS: System name has changed

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

 change(/TrueNAS by SNMP/system.name) and length(last(/TrueNAS by SNMP/system.name))>0 INFO

Manual close: YES
TrueNAS: Lack of available memory

The system is running out of memory.

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

The system is running out of free memory.

 min(/TrueNAS by SNMP/vm.memory.util,5m)>{$MEMORY.UTIL.MAX} AVERAGE

Depends on:

- TrueNAS: Lack of available memory
TrueNAS: High swap space usage

This trigger is ignored, if there is no swap configured.

 min(/TrueNAS by SNMP/system.swap.pfree,5m)<{$SWAP.PFREE.MIN.WARN} and last(/TrueNAS by SNMP/system.swap.total)>0 WARNING

Depends on:

- TrueNAS: High memory utilization

- TrueNAS: Lack of available memory
TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: High input error rate

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

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

Recovery expression:

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

Depends on:

- TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: Link down
TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: High inbound bandwidth usage

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

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

Recovery expression:

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

Depends on:

- TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: Link down
TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: High output error rate

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

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

Recovery expression:

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

Depends on:

- TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: Link down
TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: High outbound bandwidth usage

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

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

Recovery expression:

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

Depends on:

- TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: Link down
TrueNAS: 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(/TrueNAS by SNMP/net.if.speed[{#SNMPINDEX}])<0 and last(/TrueNAS by SNMP/net.if.speed[{#SNMPINDEX}])>0 and ( last(/TrueNAS by SNMP/net.if.type[{#SNMPINDEX}])=6 or last(/TrueNAS by SNMP/net.if.type[{#SNMPINDEX}])=7 or last(/TrueNAS by SNMP/net.if.type[{#SNMPINDEX}])=11 or last(/TrueNAS by SNMP/net.if.type[{#SNMPINDEX}])=62 or last(/TrueNAS by SNMP/net.if.type[{#SNMPINDEX}])=69 or last(/TrueNAS by SNMP/net.if.type[{#SNMPINDEX}])=117 ) and (last(/TrueNAS by SNMP/net.if.status[{#SNMPINDEX}])<>2)

Recovery expression:

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

Depends on:

- TrueNAS: Interface [{#IFNAME}({#IFALIAS})]: Link down
TrueNAS: 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(/TrueNAS by SNMP/net.if.status[{#SNMPINDEX}])=2) AVERAGE
TrueNAS: Unavailable by ICMP ping

Last three attempts returned timeout. Please check device connectivity.

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

ICMP packets loss detected.

 min(/TrueNAS by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/TrueNAS by SNMP/icmppingloss,5m)<100 WARNING

Depends on:

- TrueNAS: Unavailable by ICMP ping
TrueNAS: High ICMP ping response time

Average ICMP response time is too big.

 avg(/TrueNAS by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} WARNING

Depends on:

- TrueNAS: Unavailable by ICMP ping
TrueNAS: Host has been restarted

The host uptime is less than 10 minutes.

 last(/TrueNAS by SNMP/system.uptime)<10m INFO

Manual close: YES
TrueNAS: No SNMP data collection

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

 max(/TrueNAS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 WARNING

Depends on:

- TrueNAS: Unavailable by ICMP ping
TrueNAS: Pool [{#POOLNAME}]: Very high space usage

Two conditions should match: First, space utilization should be above {$ZPOOL.PUSED.MAX.CRIT:"{#POOLNAME}"}%.

Second condition: The pool free space is less than {$ZPOOL.FREE.MIN.CRIT:"{#POOLNAME}"}.

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

Two conditions should match: First, space utilization should be above {$ZPOOL.PUSED.MAX.WARN:"{#POOLNAME}"}%.

Second condition: The pool free space is less than {$ZPOOL.FREE.MIN.WARN:"{#POOLNAME}"}.

 min(/TrueNAS by SNMP/truenas.zpool.pused[{#POOLNAME}],5m) > {$ZPOOL.PUSED.MAX.WARN:"{#POOLNAME}"} and last(/TrueNAS by SNMP/truenas.zpool.avail[{#POOLNAME}]) < {$ZPOOL.FREE.MIN.WARN:"{#POOLNAME}"} WARNING

Depends on:

- TrueNAS: Pool [{#POOLNAME}]: Very high space usage
TrueNAS: Pool [{#POOLNAME}]: Status is not online

Please check pool status.

 last(/TrueNAS by SNMP/truenas.zpool.health[{#POOLNAME}]) <> 0 AVERAGE
TrueNAS: Dataset [{#DATASET_NAME}]: Very high space usage

Two conditions should match: First, space utilization should be above {$DATASET.PUSED.MAX.CRIT:"{#DATASET_NAME}"}%.

Second condition: The dataset free space is less than {$DATASET.FREE.MIN.CRIT:"{#POOLNAME}"}.

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

Two conditions should match: First, space utilization should be above {$DATASET.PUSED.MAX.WARN:"{#DATASET_NAME}"}%.

Second condition: The dataset free space is less than {$DATASET.FREE.MIN.WARN:"{#POOLNAME}"}.

 min(/TrueNAS by SNMP/truenas.dataset.pused[{#DATASET_NAME}],5m) > {$DATASET.PUSED.MAX.WARN:"{#DATASET_NAME}"} and last(/TrueNAS by SNMP/truenas.dataset.avail[{#DATASET_NAME}]) < {$DATASET.FREE.MIN.WARN:"{#POOLNAME}"} WARNING

Depends on:

- TrueNAS: Dataset [{#DATASET_NAME}]: Very high space usage
TrueNAS: Disk [{#DISK_NAME}]: Average disk temperature is too high

Disk temperature is high.

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

Disk temperature is high.

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

Feedback

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

Articles and documentation

+ Propose new article

Didn't find what you are looking for?

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