Note: This feature is available in Faddom 2025.2 and above
Faddom's ability to receive events from Zabbix is key to achieving faster troubleshooting by establishing Faddom as the single source of truth for application maps. While Faddom automatically generates the visual, up-to-date dependency map of your applications and their underlying servers, the integration provides the operational context by showing the alerts per server. This immediately highlights the failing component and, more critically, shows all the upstream and downstream application services it impacts, allowing operations teams to quickly understand the scope of an issue and focus efforts where they will have the greatest impact.
Prerequisites
Firewall open from Faddom to Zabbix on port 443 to allow for daily authentication
Firewall open from Zabbix to Faddom on the port used for the UI (typically 443 or 9443)
An API token from Faddom. Please take a look at our guide on Creating the API Token for API Access if you do not already have one.
An API token from Zabbix. To set this up, please take a look at the official Zabbox documentation, which you can find here.
How to Set Up the Integration
Note: It is recommended to have a Zabbix administrator perform the actions on Zabbix.
Faddom Configuration
Settings > Events Integration
Create Zabbix Integration
Select the Type as Zabbix Server.
If you have inserted the Zabbix VM IP or you have changed the URL to include api_jsonrpc.php, enter the specific address.
A YAML file is generated by Faddom that you need to download, which contains the necessary Webhook configuration for Zabbix
Zabbix Setup
In Zabbix, go to Alerts > Media Types.
Click Import and add the YAML file.
Ensure the imported Faddom API Webhook media type is enabled.
Open the Media Type (Faddom API Webhook) to view its settings.
Set the settings according to your needs, ensuring the appropriate script parameters are configured.
Go to Administration > Macro
Click Add and add the Faddom API key obtained above. Set the Type to Secret Text. The secret text value should be the Faddom authentication password (the Access Token from Step 1).
The macro name will then populate the corresponding variable in the Media Type settings (e.g., {FADDOM_AUTH_TOKEN}).
Alerting From Zabbix to Faddom
Once the steps above are complete, you'll need to tell Zabbix which alerts you'd like to push to Faddom. To do this, please follow the steps below in Zabbix
Go to Alerts > Actions > Trigger Actions.
Click Create Action
Add the condition/conditions you want Zabbix to meet before sending an event to Faddom (e.g., severity level, specific host groups).
Under Operations, configure the action to send a notification using the Faddom API Webhook you set up above under Media Type.
Viewing the Zabbix Notifications in Faddom
There are two places you can see the events pushed to Faddom. You can view them in our Notifications and Events screen or in the Events section of the Server Properties.
When looking at the Operational Events & Notifications screen, it will show Zabbix as the source
From the server properties, you will see it in the pattern defined in Zabbix -
