Zabbix
@figura/zabbixv2026.10.23.1
01README
Zabbix Monitoring — integration for troubleshooting and observing monitored infrastructure via the Zabbix JSON-RPC 2.0 API. Retrieves hosts, problems, triggers, items, history, host groups, maintenance windows, events, network maps, template linkage, and dashboards (read and update).
Authentication
Requires a Zabbix API Token, stored in a swamp vault.
Methods
- get_hosts — List monitored hosts with status, availability, and groups - get_host_detail — Get detailed host info (interfaces, macros, inventory) - get_problems — List active problems/alerts with severity - get_triggers — List triggers with state and associated hosts - get_items — List monitoring items (metrics) for a host - get_history — Get recent history/metric values for an item - get_host_groups — List all host groups - get_maintenance — List maintenance windows - get_events — Get recent events (state changes, alerts) - get_map — Retrieve a network map with elements and links - get_template_linkage — List the hosts and templates linked to a template - list_dashboards — List dashboards - get_dashboard — Read a dashboard with pages and widgets - update_dashboard — Update a dashboard (saves a backup first; supports dryRun)
02Behaviors
@figura/zabbixv2026.10.23.1zabbix.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiToken | string | Zabbix API Token for authentication |
| caCert? | string | PEM-encoded CA certificate(s) to trust for TLS connections (for internal/private CAs). Store in vault if desired. |
fn list_dashboards(search?: string, limit?: number)
List dashboards (id, name, owner, private flag). Optionally search by name.
| Argument | Type | Description |
|---|---|---|
| search? | string | Search dashboards by name (partial match) |
| limit? | number | Max dashboards (default 100) |
fn get_dashboard(dashboardId: string)
Retrieve a Zabbix dashboard by ID with all pages and widgets (including widget fields), in the same shape accepted by update_dashboard.
| Argument | Type | Description |
|---|---|---|
| dashboardId | string | The dashboardid to retrieve |
fn update_dashboard(dashboardId: string, name?: string, display_period?: string, auto_start?: string, private?: string, pages?: array, dryRun: boolean)
Update a Zabbix dashboard (WRITE). Provide any of name, display_period, auto_start, private, and/or pages. NOTE: `pages` REPLACES all pages/widgets — start from get_dashboard output, edit, and send the full list back (keep dashboard_pageid / widgetid to preserve existing ones; omit them to create new). The prior state is saved as a backup resource before writing. Use dryRun=true to only save the backup and validate the plan without calling Zabbix update.
| Argument | Type | Description |
|---|---|---|
| dashboardId | string | The dashboardid to update |
| name? | string | New dashboard name |
| display_period? | string | Default page display period in seconds (e.g. '30') |
| auto_start? | string | '1' to auto-start slideshow, '0' otherwise |
| private? | string | '0' public, '1' private |
| pages? | array | Full replacement list of dashboard pages, each with widgets[] (type, name, x, y, width, height, view_mode, fields[{type,name,value}]) |
| dryRun | boolean | If true, do not call dashboard.update; only snapshot current state |
fn get_hosts(groupIds?: array, search?: string, limit?: number)
List monitored hosts with their status, availability, and host group membership. Optionally filter by group or search by name.
| Argument | Type | Description |
|---|---|---|
| groupIds? | array | Filter by host group IDs |
| search? | string | Search hosts by name (partial match) |
| limit? | number | Max hosts to return (default 100) |
fn get_host_detail(hostId: string)
Get detailed information for a specific host including interfaces, macros, and inventory data.
| Argument | Type | Description |
|---|---|---|
| hostId | string | Host ID to get details for |
fn get_problems(hostIds?: array, severities?: array, limit?: number, acknowledged?: boolean)
List active problems/alerts with severity, acknowledgment status, and affected hosts. Optionally filter by severity or host.
| Argument | Type | Description |
|---|---|---|
| hostIds? | array | Filter problems by host IDs |
| severities? | array | Filter by severities (0-5). E.g. [4,5] for high+disaster |
| limit? | number | Max problems to return (default 100) |
| acknowledged? | boolean | Filter: true=only ack'd, false=only unack'd, omit=all |
fn get_triggers(hostIds?: array, onlyProblems?: boolean, limit?: number)
List triggers with their current state, priority, and associated hosts. Optionally filter by host or show only triggers in PROBLEM state.
| Argument | Type | Description |
|---|---|---|
| hostIds? | array | Filter triggers by host IDs |
| onlyProblems? | boolean | If true, only return triggers in PROBLEM state |
| limit? | number | Max triggers to return (default 100) |
fn get_items(hostId: string, search?: string, limit?: number)
List monitoring items (metrics) for a specific host. Shows item name, key, last value, and status.
| Argument | Type | Description |
|---|---|---|
| hostId | string | Host ID to get items for |
| search? | string | Search items by name or key (partial match) |
| limit? | number | Max items to return (default 100) |
fn get_history(itemId: string, valueType?: number, limit?: number, timeFrom?: number)
Get recent history/metric values for a specific item. Useful for checking recent metric trends.
| Argument | Type | Description |
|---|---|---|
| itemId | string | Item ID to get history for |
| valueType? | number | Value type: 0=float, 1=character, 2=log, 3=unsigned, 4=text. If omitted, defaults to 0 (float) |
| limit? | number | Max history records to return (default 50) |
| timeFrom? | number | Unix timestamp — only return values after this time |
fn get_host_groups(search?: string)
List all host groups in Zabbix.
| Argument | Type | Description |
|---|---|---|
| search? | string | Search groups by name (partial match) |
fn get_maintenance(hostIds?: array, groupIds?: array)
List active and upcoming maintenance windows with their time periods and associated hosts/groups.
| Argument | Type | Description |
|---|---|---|
| hostIds? | array | Filter maintenance windows by host IDs |
| groupIds? | array | Filter maintenance windows by host group IDs |
fn get_events(hostIds?: array, objectIds?: array, severities?: array, timeFrom?: number, limit?: number)
Get recent events (trigger state changes, alerts). Useful for investigating incident timelines.
| Argument | Type | Description |
|---|---|---|
| hostIds? | array | Filter events by host IDs |
| objectIds? | array | Filter events by trigger IDs (objectids) |
| severities? | array | Filter by severities (0-5) |
| timeFrom? | number | Unix timestamp — only return events after this time |
| limit? | number | Max events to return (default 100) |
fn get_map(sysmapId: string)
Retrieve a Zabbix network map by its sysmap ID, including all elements (hosts, groups, images, triggers) and links between them.
| Argument | Type | Description |
|---|---|---|
| sysmapId | string | The sysmap ID to retrieve |
fn get_template_linkage(search?: string, limit?: number)
For each matching template, list the hosts linked to it and the other templates that link it. Use before retiring a template: hostCount 0 with linkedTemplateCount 0 means it is unused, but a role composing it still counts as use. Pass a search term in a large environment: every template carries its full host list, so an unfiltered call returns a big payload.
| Argument | Type | Description |
|---|---|---|
| search? | string | Partial, case-insensitive match on the template name. Omit to list every template. |
| limit? | number | Max templates to return (default 100). Check the truncated flag. |
Resources
dashboards(10m)— Dashboard list (id, name, owner)
dashboard(10m)— Dashboard with pages and widgets
dashboard_backup(30d)— Dashboard snapshot taken before an update
hosts(10m)— Monitored hosts with status and host groups
host_detail(10m)— Detailed host info including interfaces, macros, and inventory
problems(5m)— Active problems/alerts with severity
triggers(10m)— Triggers with state and associated hosts
items(10m)— Monitoring items (metrics) for a host
history(5m)— Recent history values for an item
host_groups(15m)— All host groups
maintenance(10m)— Active and upcoming maintenance windows
events(5m)— Recent events (state changes, alerts)
map(10m)— Zabbix network map with elements (hosts, groups, images) and links
template_linkage(15m)— Templates matching a name search, each with the hosts linked to it and the templates that compose it
03Previous Versions
2026.09.10.1
2026.07.23.1
Modified 1 behaviors
2026.07.20.1
04Stats
A
93 / 100
Downloads
81
Archive size
17.8 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License1/2partial
no SPDX license declared
- Verified public repository2/2earned
05Platforms
06Labels