# Zabbix

> Act on Zabbix monitoring from workflows: find and acknowledge problems, add a ticket number or close them, look up hosts and their latest values, add hosts from an asset system, and put hosts into maintenance for a change. Start a workflow when a problem starts or is resolved.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/zabbix

## Actions

### Acknowledge problem

Acknowledge a problem and add a message, such as a ticket number, change its severity or close it.

**Inputs**

- Problem (`problem`, text, required): The problem's ID, from a trigger or an earlier step, or its link in Zabbix.
- Message (`message`, text): A message to add, such as Ticket INC-1042 opened.
- Acknowledge (`acknowledge`, true/false): Mark it acknowledged. Turn off to only add the message or change the severity. Default: `true`.
- Change severity to (`severity`, text): A new severity. Leave blank to keep it. One of: `not_classified` (Not classified), `information`, `warning`, `average`, `high`, `disaster`.
- Close problem (`close`, true/false): Close it now. Its trigger must allow closing by hand. Default: `false`.

**Outputs**

- `acknowledged` (true/false): Whether someone has acknowledged it
- `closed_by` (text): Who closed it by hand; empty if nobody did
- `host` (text): The host it's on, by its visible name
- `host_groups` (text): The host groups of its hosts
- `host_id` (text): That host's ID
- `host_name` (text): That host's technical host name
- `hosts` (text): Every host it's on, when its trigger covers several
- `id` (text): The problem's ID (its event ID), for other Zabbix steps
- `link` (text): A link to it in Zabbix
- `name` (text): What the problem is, such as High CPU utilization on web01
- `operational_data` (text): The trigger's operational data, such as the latest value
- `resolved_at` (text): When it was resolved, in UTC; empty if it isn't
- `severity` (text): Its severity: Not classified, Information, Warning, Average, High or Disaster
- `severity_level` (number): Its severity as a number, 0 (Not classified) to 5 (Disaster)
- `started_at` (text): When it started, in UTC (ISO 8601)
- `status` (text): Problem while it's going on, Resolved once it's over
- `suppressed` (true/false): Whether it's suppressed, such as by a maintenance period
- `tags` (text): Its tags, such as scope: availability, service: web
- `trigger_id` (text): The ID of the trigger that raised it
- `updates` (list): Its updates (acknowledgements, messages, closing), oldest first

**Example output**

```json
{
  "acknowledged": true,
  "closed_by": "",
  "host": "web01",
  "host_groups": "Linux servers, Web servers",
  "host_id": "10642",
  "host_name": "web01.yourcity.gov",
  "hosts": "web01 (web01.yourcity.gov)",
  "id": "48211",
  "link": "https://zabbix.yourcity.gov/tr_events.php?triggerid=24811&eventid=48211",
  "name": "High CPU utilization (over 90% for 5m) on web01",
  "operational_data": "Current utilization: 96.2 %",
  "resolved_at": "",
  "severity": "High",
  "severity_level": 4,
  "started_at": "2026-11-05T14:02:11Z",
  "status": "Problem",
  "suppressed": false,
  "tags": "class: os, component: cpu, scope: performance",
  "trigger_id": "24811",
  "updates": [
    {
      "action": "acknowledged, commented",
      "at": "2026-11-05T14:05:40Z",
      "by": "Tess Tech",
      "message": "Ticket INC-1042 opened.",
      "new_severity": ""
    }
  ]
}
```

### Create host

Add a host to Zabbix in host groups, with its IP address or DNS name and the templates that monitor it.

**Inputs**

- Host name (`host_name`, text, required): The host's name in Zabbix, such as web01.yourcity.gov: letters, numbers, spaces, dots, dashes and underscores.
- Host groups (`host_groups`, text, required): The host groups to put it in. Separate several with commas.
- Visible name (`visible_name`, text): The name Zabbix shows for it. Leave blank to show the host name.
- IP address or DNS name (`address`, text): Where Zabbix reaches it, such as 10.20.0.11 or web01.yourcity.gov. Leave blank for a host with no interface.
- Interface (`interface_type`, text): How Zabbix reaches it at that address. One of: `agent` (Zabbix agent), `snmp`, `ipmi`, `jmx`. Default: `agent`.
- Port (`port`, number): The interface's port. Leave blank for its usual one, such as 10050 for a Zabbix agent or 161 for SNMP. From 1 to 65535.
- Templates (`templates`, text): Templates that monitor it, such as Linux by Zabbix agent. Separate several with commas.
- Description (`description`, text): A description of the host.

**Outputs**

- `address` (text): The address of its main interface
- `availability` (text): Available, Not available or Unknown
- `description` (text): Its description
- `highest_severity` (text): The severity of its worst problem now; empty if none
- `host_groups` (text): Its host groups
- `host_name` (text): Its technical host name
- `id` (text): The host's ID, for other Zabbix steps
- `in_maintenance` (true/false): Whether it's in a maintenance period now
- `interfaces` (list): Its interfaces
- `link` (text): A link to it in Zabbix
- `name` (text): Its visible name
- `problem_count` (number): How many problems it has now
- `status` (text): Enabled (monitored) or Disabled
- `tags` (text): Its tags
- `templates` (text): The templates linked to it

**Example output**

```json
{
  "address": "10.20.0.11",
  "availability": "Available",
  "description": "Public website, behind the load balancer.",
  "highest_severity": "High",
  "host_groups": "Linux servers, Web servers",
  "host_name": "web01.yourcity.gov",
  "id": "10642",
  "in_maintenance": false,
  "interfaces": [
    {
      "address": "10.20.0.11",
      "availability": "Available",
      "dns": "",
      "error": "",
      "ip": "10.20.0.11",
      "main": true,
      "port": "10050",
      "type": "Zabbix agent"
    }
  ],
  "link": "https://zabbix.yourcity.gov/zabbix.php?action=host.edit&hostid=10642",
  "name": "web01",
  "problem_count": 1,
  "status": "Enabled",
  "tags": "service: web",
  "templates": "Linux by Zabbix agent"
}
```

### Create maintenance

Put hosts or host groups into maintenance for a change window, so their problems don't alert anyone.

**Inputs**

- Name (`name`, text, required): What the maintenance is for, such as Patch web01 (CHG-2291). No two can have the same name.
- Hosts (`hosts`, text): The hosts to put into maintenance. Separate several with commas. Give hosts, host groups or both.
- Host groups (`host_groups`, text): Host groups to put into maintenance, every host in them. Separate several with commas.
- Start (`start`, date and time): When it starts. Leave blank to start now.
- Minutes (`duration_minutes`, number): How long it lasts, in minutes. Defaults to 60. From 5 to 527040.
- Keep collecting data (`collect_data`, true/false): Zabbix keeps collecting data and noting problems, without alerting. Turn off to stop collecting during it. Default: `true`.
- Description (`description`, text): A description, such as the change ticket.

**Outputs**

- `collect_data` (true/false): Whether Zabbix keeps collecting data during it
- `description` (text): Its description
- `duration_minutes` (number): How long it lasts, in minutes
- `ends_at` (text): When it ends, in UTC
- `host_groups` (text): The host groups in it
- `hosts` (text): The hosts in it
- `id` (text): The maintenance period's ID, for Delete maintenance
- `link` (text): A link to it in Zabbix
- `name` (text): Its name
- `starts_at` (text): When it starts, in UTC (ISO 8601)

**Example output**

```json
{
  "collect_data": true,
  "description": "Monthly patching.",
  "duration_minutes": 60,
  "ends_at": "2026-11-06T23:00:00Z",
  "host_groups": "",
  "hosts": "web01 (web01.yourcity.gov)",
  "id": "12",
  "link": "https://zabbix.yourcity.gov/zabbix.php?action=maintenance.list&filter_name=Patch%20web01%20%28CHG-2291%29&filter_set=1",
  "name": "Patch web01 (CHG-2291)",
  "starts_at": "2026-11-06T22:00:00Z"
}
```

### Delete host

Delete a host from Zabbix, with all the data Zabbix collected for it, such as when a server is retired.

**Inputs**

- Host (`host`, text, required): The host, or its host name, visible name or ID.

**Outputs**

- `deleted` (true/false): Always true
- `host_name` (text): Its technical host name
- `id` (text): The deleted host's ID
- `name` (text): Its visible name

**Example output**

```json
{
  "deleted": true,
  "host_name": "web01.yourcity.gov",
  "id": "10642",
  "name": "web01"
}
```

### Delete maintenance

Delete a maintenance period, which ends it at once if it's on.

**Inputs**

- Maintenance (`maintenance`, text, required): The maintenance period, from Create maintenance, or its name or ID.

**Outputs**

- `deleted` (true/false): Always true
- `id` (text): The deleted maintenance period's ID
- `name` (text): Its name

**Example output**

```json
{
  "deleted": true,
  "id": "12",
  "name": "Patch web01 (CHG-2291)"
}
```

### Enable or disable host

Enable a host, so Zabbix monitors it, or disable it, so Zabbix stops monitoring it.

**Inputs**

- Host (`host`, text, required): The host, or its host name, visible name or ID.
- Status (`status`, text, required): Enabled to monitor it, Disabled to stop. One of: `enabled`, `disabled`.

**Outputs**

- `address` (text): The address of its main interface
- `availability` (text): Available, Not available or Unknown
- `description` (text): Its description
- `highest_severity` (text): The severity of its worst problem now; empty if none
- `host_groups` (text): Its host groups
- `host_name` (text): Its technical host name
- `id` (text): The host's ID, for other Zabbix steps
- `in_maintenance` (true/false): Whether it's in a maintenance period now
- `interfaces` (list): Its interfaces
- `link` (text): A link to it in Zabbix
- `name` (text): Its visible name
- `problem_count` (number): How many problems it has now
- `status` (text): Enabled (monitored) or Disabled
- `tags` (text): Its tags
- `templates` (text): The templates linked to it

**Example output**

```json
{
  "address": "10.20.0.11",
  "availability": "Available",
  "description": "Public website, behind the load balancer.",
  "highest_severity": "High",
  "host_groups": "Linux servers, Web servers",
  "host_name": "web01.yourcity.gov",
  "id": "10642",
  "in_maintenance": false,
  "interfaces": [
    {
      "address": "10.20.0.11",
      "availability": "Available",
      "dns": "",
      "error": "",
      "ip": "10.20.0.11",
      "main": true,
      "port": "10050",
      "type": "Zabbix agent"
    }
  ],
  "link": "https://zabbix.yourcity.gov/zabbix.php?action=host.edit&hostid=10642",
  "name": "web01",
  "problem_count": 1,
  "status": "Enabled",
  "tags": "service: web",
  "templates": "Linux by Zabbix agent"
}
```

### Find hosts

Find hosts by name, host group and status, or only the ones with problems, with their address, availability and problems.

**Inputs**

- Name (`name`, text): Part of the host's host name or visible name, such as web. Leave blank for every host.
- Host group (`host_group`, text): Only hosts in this host group, such as Linux servers.
- Status (`status`, text): Only hosts Zabbix monitors (Enabled), or only Disabled ones. One of: `any`, `enabled`, `disabled`. Default: `any`.
- Only with problems (`with_problems`, true/false): Only hosts that have a problem now. Default: `false`.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `hosts` (list): The hosts found, by name

**Example output**

```json
{
  "hosts": [
    {
      "address": "10.20.0.11",
      "availability": "Available",
      "description": "Public website, behind the load balancer.",
      "highest_severity": "High",
      "host_groups": "Linux servers, Web servers",
      "host_name": "web01.yourcity.gov",
      "id": "10642",
      "in_maintenance": false,
      "interfaces": [
        {
          "address": "10.20.0.11",
          "availability": "Available",
          "dns": "",
          "error": "",
          "ip": "10.20.0.11",
          "main": true,
          "port": "10050",
          "type": "Zabbix agent"
        }
      ],
      "link": "https://zabbix.yourcity.gov/zabbix.php?action=host.edit&hostid=10642",
      "name": "web01",
      "problem_count": 1,
      "status": "Enabled",
      "tags": "service: web",
      "templates": "Linux by Zabbix agent"
    }
  ]
}
```

### Find problems

Find the problems going on now, by severity, host group, host, words in their name and whether someone has acknowledged them, newest first.

**Inputs**

- Minimum severity (`min_severity`, text): Only problems this severe or worse. Leave blank for every severity. One of: `not_classified` (Not classified), `information`, `warning`, `average`, `high`, `disaster`.
- Host group (`host_group`, text): Only hosts in this host group, such as Linux servers.
- Host (`host`, text): Only problems on this host, or its host name or ID. Separate several with commas.
- Words in the name (`name`, text): Only problems whose name has these words, such as CPU.
- Acknowledged (`acknowledged`, text): Only problems someone has acknowledged, or only ones nobody has. One of: `any`, `unacknowledged` (Not acknowledged), `acknowledged`. Default: `any`.
- Include just resolved (`include_resolved`, true/false): Also list problems resolved in the last few minutes, as Zabbix's Problems page does. Default: `false`.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `problems` (list): The problems found, newest first

**Example output**

```json
{
  "problems": [
    {
      "acknowledged": false,
      "host": "web01",
      "host_groups": "Linux servers, Web servers",
      "host_id": "10642",
      "host_name": "web01.yourcity.gov",
      "hosts": "web01 (web01.yourcity.gov)",
      "id": "48211",
      "link": "https://zabbix.yourcity.gov/tr_events.php?triggerid=24811&eventid=48211",
      "name": "High CPU utilization (over 90% for 5m) on web01",
      "operational_data": "Current utilization: 96.2 %",
      "resolved_at": "",
      "severity": "High",
      "severity_level": 4,
      "started_at": "2026-11-05T14:02:11Z",
      "status": "Problem",
      "suppressed": false,
      "tags": "class: os, component: cpu, scope: performance",
      "trigger_id": "24811"
    }
  ]
}
```

### Get host

Get a host, with its groups, interfaces, templates, availability and the problems it has now.

**Inputs**

- Host (`host`, text, required): The host, or its host name, visible name or ID.

**Outputs**

- `address` (text): The address of its main interface
- `availability` (text): Available, Not available or Unknown
- `description` (text): Its description
- `highest_severity` (text): The severity of its worst problem now; empty if none
- `host_groups` (text): Its host groups
- `host_name` (text): Its technical host name
- `id` (text): The host's ID, for other Zabbix steps
- `in_maintenance` (true/false): Whether it's in a maintenance period now
- `interfaces` (list): Its interfaces
- `link` (text): A link to it in Zabbix
- `name` (text): Its visible name
- `problem_count` (number): How many problems it has now
- `problems` (list): Its problems now, newest first
- `status` (text): Enabled (monitored) or Disabled
- `tags` (text): Its tags
- `templates` (text): The templates linked to it

**Example output**

```json
{
  "address": "10.20.0.11",
  "availability": "Available",
  "description": "Public website, behind the load balancer.",
  "highest_severity": "High",
  "host_groups": "Linux servers, Web servers",
  "host_name": "web01.yourcity.gov",
  "id": "10642",
  "in_maintenance": false,
  "interfaces": [
    {
      "address": "10.20.0.11",
      "availability": "Available",
      "dns": "",
      "error": "",
      "ip": "10.20.0.11",
      "main": true,
      "port": "10050",
      "type": "Zabbix agent"
    }
  ],
  "link": "https://zabbix.yourcity.gov/zabbix.php?action=host.edit&hostid=10642",
  "name": "web01",
  "problem_count": 1,
  "problems": [
    {
      "acknowledged": false,
      "host": "web01",
      "host_groups": "Linux servers, Web servers",
      "host_id": "10642",
      "host_name": "web01.yourcity.gov",
      "hosts": "web01 (web01.yourcity.gov)",
      "id": "48211",
      "link": "https://zabbix.yourcity.gov/tr_events.php?triggerid=24811&eventid=48211",
      "name": "High CPU utilization (over 90% for 5m) on web01",
      "operational_data": "Current utilization: 96.2 %",
      "resolved_at": "",
      "severity": "High",
      "severity_level": 4,
      "started_at": "2026-11-05T14:02:11Z",
      "status": "Problem",
      "suppressed": false,
      "tags": "class: os, component: cpu, scope: performance",
      "trigger_id": "24811"
    }
  ],
  "status": "Enabled",
  "tags": "service: web",
  "templates": "Linux by Zabbix agent"
}
```

### Get item values

Get the latest values Zabbix collected from a host, such as its CPU utilization or free disk space, by the item's key or name.

**Inputs**

- Host (`host`, text, required): The host, or its host name, visible name or ID.
- Item (`item`, text, required): The item's key, such as system.cpu.util, or words in its name, such as CPU utilization.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `host` (text): The host
- `host_id` (text): The host's ID
- `items` (list): The matching items, by name, with their latest values
- `link` (text): A link to the host's latest data in Zabbix

**Example output**

```json
{
  "host": "web01 (web01.yourcity.gov)",
  "host_id": "10642",
  "items": [
    {
      "error": "",
      "host": "web01 (web01.yourcity.gov)",
      "id": "45512",
      "key": "system.cpu.util",
      "last_checked_at": "2026-11-05T14:06:00Z",
      "last_value": 96.2,
      "name": "CPU utilization",
      "previous_value": 94.8,
      "status": "Enabled",
      "units": "%",
      "value_type": "Number (decimal)"
    }
  ],
  "link": "https://zabbix.yourcity.gov/zabbix.php?action=latest.view&hostids%5B%5D=10642"
}
```

### Get problem

Get a problem, going on or resolved, with its host, tags and who acknowledged it or wrote on it.

**Inputs**

- Problem (`problem`, text, required): The problem's ID, from a trigger or an earlier step, or its link in Zabbix.

**Outputs**

- `acknowledged` (true/false): Whether someone has acknowledged it
- `closed_by` (text): Who closed it by hand; empty if nobody did
- `host` (text): The host it's on, by its visible name
- `host_groups` (text): The host groups of its hosts
- `host_id` (text): That host's ID
- `host_name` (text): That host's technical host name
- `hosts` (text): Every host it's on, when its trigger covers several
- `id` (text): The problem's ID (its event ID), for other Zabbix steps
- `link` (text): A link to it in Zabbix
- `name` (text): What the problem is, such as High CPU utilization on web01
- `operational_data` (text): The trigger's operational data, such as the latest value
- `resolved_at` (text): When it was resolved, in UTC; empty if it isn't
- `severity` (text): Its severity: Not classified, Information, Warning, Average, High or Disaster
- `severity_level` (number): Its severity as a number, 0 (Not classified) to 5 (Disaster)
- `started_at` (text): When it started, in UTC (ISO 8601)
- `status` (text): Problem while it's going on, Resolved once it's over
- `suppressed` (true/false): Whether it's suppressed, such as by a maintenance period
- `tags` (text): Its tags, such as scope: availability, service: web
- `trigger_id` (text): The ID of the trigger that raised it
- `updates` (list): Its updates (acknowledgements, messages, closing), oldest first

**Example output**

```json
{
  "acknowledged": true,
  "closed_by": "",
  "host": "web01",
  "host_groups": "Linux servers, Web servers",
  "host_id": "10642",
  "host_name": "web01.yourcity.gov",
  "hosts": "web01 (web01.yourcity.gov)",
  "id": "48211",
  "link": "https://zabbix.yourcity.gov/tr_events.php?triggerid=24811&eventid=48211",
  "name": "High CPU utilization (over 90% for 5m) on web01",
  "operational_data": "Current utilization: 96.2 %",
  "resolved_at": "",
  "severity": "High",
  "severity_level": 4,
  "started_at": "2026-11-05T14:02:11Z",
  "status": "Problem",
  "suppressed": false,
  "tags": "class: os, component: cpu, scope: performance",
  "trigger_id": "24811",
  "updates": [
    {
      "action": "acknowledged, commented",
      "at": "2026-11-05T14:05:40Z",
      "by": "Tess Tech",
      "message": "Ticket INC-1042 opened.",
      "new_severity": ""
    }
  ]
}
```
