Overview
SPOG.AI integrates with Zabbix to centralize visibility of monitored hosts, performance metrics,
availability data, triggers, alerts, and service health indicators. The integration ingests
monitoring telemetry into the SPOG.AI CMDB and Observability platform, enabling correlation of
infrastructure risks, incidents, and performance insights across your environment. SPOG.AI
retrieves the data through the Zabbix API using a dedicated read-only user, and can optionally
receive real-time alerts through Zabbix webhooks.
Key Features
| Capability | Description |
| Host & CMDB Inventory | Ingests hosts, host groups, templates, and host metadata into the SPOG.AI CMDB. |
| Performance Metrics | Retrieves CPU, memory, disk, network throughput, and application or service metrics. |
| Trigger & Alert Ingestion | Collects trigger states, severity, problem events, and event history. |
| Availability & SLA | Tracks uptime, downtime, SLA reports, and outage history. |
| Real-Time Alerts (Optional) | Receives alerts pushed from Zabbix webhooks or media types for immediate ingestion. |
| Observability & Risk Scoring | Correlates data with CMDB assets to power observability dashboards, risk scoring, and trend analysis. |
| Incident Enrichment | Enriches incidents with Zabbix alert and performance context. |
How the Integration Works
Zabbix exposes monitoring data through its JSON-RPC API, including hosts and inventory,
items and metrics, triggers, problems (alerts), event history, and availability. SPOG.AI connects
to the Zabbix API and periodically retrieves host CMDB metadata, performance metrics, trigger
states, alert and problem events, and SLA and availability history.
Optionally, Zabbix webhooks or media types can push real-time alerts to SPOG.AI for
immediate ingestion. SPOG.AI correlates the incoming data with CMDB assets to power
observability dashboards, risk scoring, trend analysis, and incident enrichment.
Data Collected
| Category | Data Collected | Description |
| CMDB & Asset Inventory | Hostnames / IP addresses, OS information, hardware metadata, host groups, templates assigned | Host and asset details used to enrich the CMDB. |
| Monitoring Metrics | CPU, memory, and disk metrics; network throughput; agent status; application and service metrics | Performance and health metrics for monitored hosts. |
| Alerts & Trigger Data | Active triggers, trigger severity, event history, problem states, recovery notifications | Alert and problem records from Zabbix. |
| Availability & SLA | Uptime / downtime, SLA reports, outage history | Availability and service level history. |
| Behavioral & Trend Analysis | Repeated alerts, anomaly detection patterns, resource utilization baselines | Trend and behavior insights that SPOG.AI builds from the collected data. |
Prerequisites
Before configuring the integration, ensure the following prerequisites are met:
- Zabbix Server v5.0 or later (v6.x recommended), with the API enabled and reachable.
- A dedicated API user in Zabbix with read permissions, assigned to the required host groups.
- Outbound network access from SPOG.AI to http(s)://<zabbix-server>/api_jsonrpc.php (port 80/443 or your custom Zabbix port).
- Integration, CMDB, and Observability permissions in SPOG.AI.
- Optional, for real-time alerts: a webhook or media type configured in Zabbix, using SNMP, email, or script-based forwarding.
Configuration
1. Create an API user in Zabbix
- Log in to the Zabbix Web UI.
- Navigate to Administration → Users.
- Create an API user (recommended) with the following settings:
Username: spogai_api
Role: API Read-Only or a custom role
Permissions: read hosts, items, triggers, and events
- Set a secure password.
- Confirm the API endpoint: http(s)://<zabbix-server>/api_jsonrpc.php
Note: User roles are available from Zabbix 5.2. On earlier versions, use a standard user type instead. In both cases, read access to hosts, items, triggers, and events is granted through read permissions on the required host groups, assigned to the user through a user group.
2. Configure Zabbix in SPOG.AI
Log in to SPOG.AI.
- Go to Settings → Integrations → Add Integration.
- Select Zabbix.
- Provide the following details:
| Field | Description |
| API URL | The Zabbix API endpoint. |
| Username | The API user created in step 1. |
| Password | The password of the API user. |
| Sync Interval | Default: 10–30 minutes. |
- Click Save & Sync. SPOG.AI begins ingesting hosts, host groups, templates, triggers, alerts (problems), and SLA/availability data.
3. Validate the integration
- Validate API login using curl or Postman.
- In SPOG.AI, check the integration status, the last sync timestamp, and a sample of ingested hosts and alerts.
- Trigger a test alert in Zabbix by temporarily creating a trigger with a guaranteed firing condition, and confirm the alert appears in SPOG.AI dashboards.
- Validate the event lifecycle (Firing → Resolved).
- Check the SPOG.AI logs for API responses and errors (401, 403, or timeouts).
- If webhooks are configured, validate webhook-based alerts.
- Ensure host groups and permissions align with the coverage you want.