Switch Widget (Zabbix 7.x)

Uses native Zabbix selection fields.

Screenshot

Configure

1. Select Host (on normal dashboards). On template dashboards the linked host is used automatically.
2. Set Rows and Ports per row (total ports = rows x ports per row).
3. Set optional Brand and Model text for switch bezel.
4. Set widget Name to control the dashboard widget title (header text).
5. Optional: set Legend text (leave empty to hide).
6. Optional: set traffic patterns (Traffic in item pattern, Traffic out item pattern) using * as port placeholder (example: ifInOctets[*]).
7. Optional: set Port index start for wildcard mapping (*), default 1 (set 0 for devices where first interface index is 0).
8. Optional: set SFP index start when SFP SNMP indexes are not contiguous after Ethernet (leave 0 to auto-take SFPs after Ethernet).
9. Optional: set Speed item pattern (example: ifHighSpeed[*] or net.if.speed[ifHighSpeed.*]) for utilization calculations.
10. Optional: set Speed data unit to match how Zabbix stores the speed value (Mbps for raw ifHighSpeed[*], b/s for template items like net.if.speed[ifHighSpeed.*] that already apply ×1,000,000).
11. Optional: set Show utilization overlay to enable/disable heatmap strip + grid.
12. Optional: tune utilization thresholds (Low, Warn, High) and colors (Low, Warn, High, n/a).
13. Optional: select Profile to auto-fill layout (Rows, Ports per row, SFP ports, Size (%), Brand, Model).
14. Optional: rename profile directly next to Profile.
15. Optional: use Save current to selected profile to overwrite selected profile (1-7).
16. Set optional Size (%) (40-100) to make switch compact.
17. Set optional SFP ports (0 = none, 2 = two extra SFP ports).
18. Select per-port Trigger from dropdown (for selected host).
19. Set per-port Default color, Trigger OK color and Trigger NOK color.
20. Optional: use Bulk actions to apply one color to all ports for each state.

Note: Trigger options are rendered server-side from selected host. If you change host, reopen widget edit to refresh trigger lists. On template dashboards, the linked host is used automatically (template_support); re-save the widget once after upgrading so the dashboard host reference is stored. SFP index start may be lower than Port index start (for example MikroTik: SFP ifIndex 11-14, Ether from 15).

UI

• Widget renders with switch-style port front panel.
• Widget header title uses the widget Name field.
• Port status uses LED-like color indicator:
  • default color (light gray) = no trigger configured
  • trigger OK color = trigger configured and OK
  • trigger NOK color = active problem
• Port hover tooltip includes:
  • state/type/trigger text
  • IN/OUT sparkline + latest value (when user has item read permission)

Release Notes 1.2.11

• Fixed wildcard mapping when SFP SNMP indexes come before Ethernet indexes (MikroTik-style layouts).
• Added Speed data unit (Mbps or b/s) so utilization works with both raw ifHighSpeed[*] and template items like net.if.speed[ifHighSpeed.*].
• Restored direct Host selection on normal dashboards.
• Bound template-dashboard widgets to the dashboard host context so port data loads on linked hosts.

Release Notes 1.2.10

• Switched host selection to Zabbix Override host so the widget follows dashboard/template host context.
• Resolved host via template/dashboard linkage when no override is set.
• Added host name link in the switch header when a host is available.

Release Notes 1.2.9

• Marked the widget as available for template dashboards in manifest.json.

Release Notes 1.2.8

• Added support for large SNMP interface indexes in wildcard-based item mapping.
• Increased key field widths for better readability in widget configuration.

Release Notes 1.2.7

• Moved heatmap legend into the switch header to free vertical space above the switch.
• Updated live panel label from Utilization to Port utilization for clarity.
• Tightened live metric value alignment so IN/OUT/utilization values stay visually closer to their labels.

Release Notes 1.2.6

• Added integrated switch summary panel under the switch face.
• Added summary item-key configuration fields (software, VLANs, CPU, fan, uptime, serial).
• Added live per-port telemetry block in summary panel (IN/OUT sparklines, utilization, errors, discards, 24h state bars).
• Restored hover-driven port live updates with click/focus fallback.
• Removed redundant Ports: ... summary row.
• Improved sparkline visuals and sizing to better match switch style.
• Updated long item-pattern/key fields to 40 characters for consistency.
• Kept trigger LED behavior authoritative while utilization overlay remains optional.
• Fixed edit-form item suggestion popups opening all at once on load.
• Fixed click selection in item suggestion lists to work reliably with blur/focus handling.
• Added Port index start to support devices where interface indexing does not start at 1 (for example 0 on some platforms).
• Fixed maintenance badge logic to respect maintenance window timing (ended windows now show OFF correctly).
• Utilization heatmap layout now follows switch geometry (UTP block + separate SFP block), matching port placement better.

Compatibility Note

• Primary target: Zabbix 7.0.
• Should also work on Zabbix 7.2 and 7.4.
• 7.2 and 7.4 are currently not actively tested or maintained.

Profile Storage Permissions

Profiles are stored in profiles.json inside the module directory.
The web/PHP user must be able to write this file when using Save current to selected profile.

Common paths:

• Zabbix 7.x: /usr/share/zabbix/modules/switch/profiles.json
• Zabbix 8.x: /usr/share/zabbix/ui/modules/switch/profiles.json

Example (RHEL/Alma/Rocky with apache, Zabbix 7.x path):

sudo chown root:apache /usr/share/zabbix/modules/switch/profiles.json
sudo chmod 664 /usr/share/zabbix/modules/switch/profiles.json
sudo chmod 755 /usr/share/zabbix/modules/switch

If SELinux is enabled, also set writable context:

sudo semanage fcontext -a -t httpd_sys_rw_content_t "/usr/share/zabbix/modules/switch/profiles.json"
sudo restorecon -v /usr/share/zabbix/modules/switch/profiles.json

For Zabbix 8.x, use the same commands but replace /usr/share/zabbix/modules/switch/... with /usr/share/zabbix/ui/modules/switch/....

---

Parts of this software were generated using Codex. We do not guarantee the total accuracy, security, or stability of the generated code.