[Plugin] Zabbix Agent

Native Zabbix agent 7.0 LTS for Unraid.
It runs on the host, so it sees CPU, memory, disks, filesystems, network and the array directly, with no container and no bind mounts.

Install: Apps → search “Zabbix Agent” (in progress),
or Plugins → Install Plugin: https://github.com/vrx-666/unraid-zabbix-agent/releases/latest/download/zabbix-agent.plg

How it works

• The plugin downloads the official static agent from cdn.zabbix.com and checks its SHA256. Nothing is rebuilt.

• Agent 7.0 works with Zabbix server 7.0, 7.2, 7.4 and later.

• Settings → Network Services → Zabbix Agent: set your Zabbix server, active checks server, hostname and host metadata (for autoregistration).
  Any other agent option goes under Advanced, one per line. The options are the standard ones from the Zabbix documentation.

• Apply checks the settings with the agent before saving. If they are wrong, nothing is saved and you see the error.

• On the Zabbix server, use the “Linux by Zabbix agent” template, plus the “Unraid by Zabbix agent” template for the array and disks (below).

Security

The agent runs as root (needed for SMART). To keep a compromised Zabbix server from using it against Unraid, only the keys of the Linux template and the Unraid keys are allowed. system.run, reading arbitrary files, web requests and the like are denied. To allow more, add AllowKey= lines under Advanced.

The static agent has no TLS, so traffic is not encrypted. Keep it on a trusted network.

Unraid template

For the array and disks there is a Zabbix template: zbx_unraid_by_zabbix_agent.yaml. Import it in Data collection → Templates → Import (Zabbix 7.0 or newer) and link it to the host next to the Linux template.

• Array state, with a trigger when the array is not started.

• Every array and pool disk is discovered automatically: status, errors, temperature and SMART health, each with a trigger.

• Disk data is read from Unraid, so no disk is woken up. A sleeping disk simply has no temperature until it spins up.

• Temperature threshold: macro {$UNRAID.DISK.TEMP.MAX} (default 50 °C). Set it per disk with a context, e.g. {$UNRAID.DISK.TEMP.MAX:"cache"}.

The keys behind it: unraid.array.state, unraid.disks (JSON, read without waking disks), unraid.smart.health[sdX].

Source, details and issues: https://github.com/vrx-666/unraid-zabbix-agent