;}%20.st6{fill:url(%23SVGID_00000021089067129159788970000008246765442136188072_);}%20.st7{fill:url(%23SVGID_00000117639240116366130650000015074833605515028638_);}%20.st8{opacity:0.4;fill:url(%23SVGID_00000101781798616409025840000016567063639337360777_);}%20.st9{opacity:0.4;fill:url(%23SVGID_00000052086836598721292040000002033117744178971046_);}%20.st10{opacity:0.4;fill:url(%23SVGID_00000159460939004760751800000002448009281983951536_);}%20.st11{opacity:0.4;fill:url(%23SVGID_00000013177830667419993080000017721442101626521532_);}%20.st12{opacity:0.4;fill:url(%23SVGID_00000152235521444854938490000006526001119318383285_);}%20.st13{opacity:0.4;fill:url(%23SVGID_00000119823135212293698520000012774889010992664993_);}%20%3c/style%3e%3cg%3e%3cpolygon%20class='st2'%20points='134.78,14.22%20114.31,48.21%20101.33,69.75%20158.22,69.75%20177.97,36.95%20191.67,14.22%20'/%3e%3cpolygon%20class='st3'%20points='227.55,69.75%20186.61,69.75%20101.33,69.75%20129.78,119.02%20158.16,119.02%20228.61,119.02%20256,119.02%20'/%3e%3cpolygon%20class='st3'%20points='136.93,132.47%20116.46,167.93%2073.82,241.78%20130.71,241.78%20144.9,217.2%20180.13,156.18%20193.82,132.46%20'/%3e%3cpolygon%20class='st3'%20points='121.7,131.95%20101.23,96.49%2058.59,22.63%2030.15,71.91%2044.34,96.49%2079.57,157.5%2093.26,181.22%20'/%3e%3cpolygon%20class='st2'%20points='64.81,131.95%2025.15,131.21%200,130.74%2028.44,180.01%2066.73,180.72%2093.26,181.21%20'/%3e%3cpolygon%20class='st2'%20points='165.38,181.74%20184.58,216.46%20196.75,238.47%20225.19,189.2%20206.66,155.69%20193.83,132.46%20'/%3e%3c/g%3e%3c/svg%3e)
Windmill HubPut hosts into maintenance during a change, check and acknowledge problems, and raise alarms in Zabbix from any Windmill script, flow or app.
Set up in 3 steps
Create an API token
In the Zabbix frontend, open Users > API tokens and create a token for a dedicated service user rather than a person's account. Its user role needs the API methods the scripts call (host.get, maintenance.*, problem.get, event.acknowledge, history.push) and rights on the host groups the flows touch. Needs Zabbix 7.0 or later.
Add the resource
Open Resources, click Add a resource/API and pick Zabbix. Set base_url to your Zabbix frontend URL, the folder that holds api_jsonrpc.php (for example https://zabbix.example.com or https://example.com/zabbix), and paste the token.
Run your first script
Run List hosts to check the connection, then use Create maintenance and Delete maintenance around a change, and Get problems afterwards to check that nothing unexpected fired.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
Push value
List maintenances
List hosts
Get problems
Delete maintenance
Create maintenance
Acknowledge event
Push value
List maintenances
List hosts
Get problems
Delete maintenance
Create maintenance
Acknowledge event
Resource type
The shape of the credential every script on this page expects.
zabbix
View raw schema →| Field | Type | Required | What it is |
|---|---|---|---|
| base_url | string | Yes | URL of the Zabbix web frontend, the folder that contains api_jsonrpc.php (e.g. https://zabbix.example.com or https://example.com/zabbix). |
| token | string | Yes | Zabbix API token, created in the Zabbix frontend under Users > API tokens. Its user role must allow the API methods the scripts call. |
Questions
How do I raise an alarm in Zabbix when a flow fails?
Create a trapper item on a host (for example key trap, numeric), leaving Allowed hosts empty or including the Zabbix web frontend's IP, and a trigger such as last(/<host>/trap)>0. Then call Push value with that host and key from the flow's error handler: push 1 to raise the problem and 0 to clear it.
Why can't Acknowledge event close a problem?
Zabbix only closes a problem by hand when its trigger has Allow manual close enabled, and the token's user needs read-write rights on that trigger.
Which Zabbix versions are supported?
7.0 to 7.4. The scripts authenticate with an API token in the Authorization header and use history.push, which Zabbix added in 7.0.
Is my token stored on the hub?
Never. It lives only in your own Windmill workspace, encrypted at rest.