# Zabbix

Canonical: https://docs.shumoku.dev/en/server/next/plugins/zabbix
Language: en
Server documentation version: next
Product version: 0.1.6-beta.4
Channel: development

This documentation describes the Server currently in development.

zabbix · 0.2.28

# Zabbix

[Source](https://github.com/konoe-akitoshi/shumoku/blob/73ebc72ba0bc0d1caf74e1ed34c89a6debcb0e6a/libs/plugins/zabbix/src/index.ts)

## Capabilities

metrics · hosts · alerts · topology

## Connection configuration

| Field | Type | Description | Default |
| --- | --- | --- | --- |
| `url`  
required | `string` | **Zabbix URL**  
 | `—` |
| `token`  
required · secret | `string` | **API token**  
 | `—` |
| `insecure`  
 | `boolean` | **Skip TLS verification**  
Disables certificate validation. Self-signed certs in trusted networks only. | `false` |
| `pollInterval`  
 | `number` | **Polling interval**  
5000 — 5 seconds, 10000 — 10 seconds, 30000 — 30 seconds, 60000 — 1 minute, 300000 — 5 minutes | `60000` |

## Topology options

| Field | Type | Description | Default |
| --- | --- | --- | --- |
| `hostGroups`  
 | `string[]` | **Host groups**  
Only keep hosts that belong to these host groups (by name). Empty = all hosts. | `—` |
| `groupBy`  
 | `string` | **Group by**  
Nest each node under its most-specific host group, or emit a flat graph. hostgroup — Host group, none — No grouping | `hostgroup` |
| `groupExclude`  
 | `string[]` | **Exclude groups**  
Drop hosts that belong to these host groups (admin / catch-all groups). | `—` |
| `includeExternalNeighbors`  
 | `boolean` | **Include external neighbors**  
Add nodes for LLDP neighbors that are not Zabbix hosts, so their links still render. | `true` |
| `parentTag`  
 | `string` | **Parent tag**  
Host-tag name whose value names an upstream device — draws a link where LLDP saw no neighbor. Empty to disable. | `PARENT` |