← Back to Integration
MONITORING AND OBSERVABILITY

Integration with Zabbix Integration with SPOG.AI

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

CapabilityDescription
Host & CMDB InventoryIngests hosts, host groups, templates, and host metadata into the SPOG.AI CMDB.
Performance MetricsRetrieves CPU, memory, disk, network throughput, and application or service metrics.
Trigger & Alert IngestionCollects trigger states, severity, problem events, and event history.
Availability & SLATracks 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 ScoringCorrelates data with CMDB assets to power observability dashboards, risk scoring, and trend analysis.
Incident EnrichmentEnriches 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

CategoryData CollectedDescription
CMDB & Asset InventoryHostnames / IP addresses, OS information, hardware metadata, host groups, templates assignedHost and asset details used to enrich the CMDB.
Monitoring MetricsCPU, memory, and disk metrics; network throughput; agent status; application and service metricsPerformance and health metrics for monitored hosts.
Alerts & Trigger DataActive triggers, trigger severity, event history, problem states, recovery notificationsAlert and problem records from Zabbix.
Availability & SLAUptime / downtime, SLA reports, outage historyAvailability and service level history.
Behavioral & Trend AnalysisRepeated alerts, anomaly detection patterns, resource utilization baselinesTrend 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:
FieldDescription
API URLThe Zabbix API endpoint.
UsernameThe API user created in step 1.
PasswordThe password of the API user.
Sync IntervalDefault: 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.
Frequently Asked Questions