Skip to main content

Zabbix

CompanyEstimated TimeVendor DocsOpen Source
Zabbix LLC~5 minutesDocsv3.rb

What is the Zabbix Integration?​

The Zabbix integration allows you to forward alerts from Zabbix into PagerTree. PagerTree then routes these alerts to the appropriate on-call engineer or team.

How It Works​

  • Zabbix detects problems and generates alerts.
  • These alerts trigger webhooks that send data to PagerTree.
  • PagerTree processes the alert and creates or resolves an incident.

Event Mapping​

  • TRIGGER, SERVICE, INTERNAL → create/resolve alerts in PagerTree
  • DISCOVERY, AUTOREGISTRATION → create alerts in PagerTree

Integration Walkthrough​

Estimated setup time: ~5 minutes.

Prerequisites:

  • A PagerTree account
  • A running Zabbix instance

In PagerTree​

  1. Create the integration by selecting the Zabbix logo.
  2. Copy the Endpoint URL (e.g. https://api.pagertree.com/integration/int_xxxyyyzzz).

In Zabbix​

Create the Global Macro​

  1. Go to Administration → Macros.
  2. Add a global macro {$ZABBIX.URL} containing the Zabbix frontend URL.
    • Must include protocol (http:// or https://).
    • Port is optional.
    • You may need /zabbix at the end, depending on your setup.

✅ Good examples:

  • http://zabbix.com
  • https://zabbix.lan/zabbix
  • http://127.0.0.1:8080

❌ Bad examples:

  • zabbix.com
  • https://zabbix.com/
  • http://zabbix/

Install the PagerTree Media Type​

  1. Go to Alerts → Media types.
  2. Import media_pagertree.yaml.
    Import the PagerTree Media Type

    In the Admin Center, click Webhooks.

  3. Enable it by checking the box and clicking Enable.
    Enable the PagerTree Media Type

    In the Admin Center, click Webhooks.

Create a Zabbix User & Add Media​

  1. Go to Users → Users → Create user.
    • Fill in the required fields on the User tab.
  2. On the Media tab:
    • Add new media, select PagerTree as the type.
    • In Send to, paste the PagerTree endpoint URL you copied earlier.
      Zabbix User Configured Media Type

      In the Admin Center, click Webhooks.

  3. Ensure this user has access to all hosts where you want alerts forwarded.

Test the Integration​

  1. In Zabbix, create a test trigger (e.g. CPU load > 0.01) on a monitored host.
  2. Verify that Zabbix sends an alert through the PagerTree media type.
  3. In PagerTree, confirm that a new alert appears in your dashboard.

✅ If the alert shows up, the integration is working correctly.

🎉 Done! Zabbix is now sending alerts into PagerTree for incident management.