Zabbix Integration: Difference between revisions

From OSNEXUS Online Documentation Site
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
Zabbix is integrated with QuantaStor via a customer alert handler integrated with QuantaStor's Alert Manager.  To configure you'll need a webhook.
Zabbix is integrated with QuantaStor via a customer alert handler integrated with QuantaStor's Alert Manager.  Here are the configuration steps.
 
Step 1 - Generate API key
 
Navigate to Users -> API Token -> Create API token
Name it quantastor-itsm, and choose a user to associate the key with. We recommend disabling the "Set expiration date and time" so that alerts are not missed due to key expiration.
Make sure to copy the key after creating it.
 
Step 2 - Create the Zabbix URL with token
 
Open a text editor and paste the API key from step 1. Then copy the Zabbix URL and paste it on another line in the text editor. Remove everything after the first '/' character and add a '#' at the end. Then Paste your API key. Your new URL should resemble
https://light-kudu.zabbix.cloud/#7506c2db7a6420a6ea0f15a2b55254de4fa442d4d7311b1dabb8ec765dcbba
 
Step 3 - Add the Zabbix URL to QuantaStor
 
Login to your QuantaStor storage grid and then select the "Alert Manager" button to bring up the dialog for adding alert endpoints. On the second page select Zabbix from the dropdown list of ITSM integrations and then paste the URL endpoint captured in Step 2.
 
Step 4 - Apply changes and test
 
Apply your changes in the QuantaStor Alert Manager to add the new endpoint then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly. Login to your Zabbix account. The script should create automatically create a host in Zabbix that will be the parent of all the data received. Follow the step below to easily see new alerts created. Note that QuantaStor alerts at the "INFO" level are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alerts when generating test alerts.
 
Step 5 - (Optional) Use our script to setup the QuantaStor Alerts dashboard
 
/opt/osnexus/quantastor/bin/qs_alerthandler_zabbix.py --setup --url 'https://light-kudu.zabbix.cloud/#7506c2db7a6420a6ea0f15a2b55254de4fa442d4d7311b1dabb8ec765dcbba'
 
This will make a new dashboard under "Dashboards" in Zabbix named "Quantastor Alerts", listing all received alerts. They can be dismissed by acknowledging them in the update menu to the right of each alert.


[[File:Image-2026-08-21-11-39-31-766.png|800px]]
[[File:Image-2026-08-21-11-39-31-766.png|800px]]
[[File:Image-2026-08-21-11-03-00-211.png|800px]]
[[File:Image-2026-08-21-11-03-00-211.png|800px]]

Revision as of 22:06, 24 August 2026

Zabbix is integrated with QuantaStor via a customer alert handler integrated with QuantaStor's Alert Manager. Here are the configuration steps.

Step 1 - Generate API key

Navigate to Users -> API Token -> Create API token Name it quantastor-itsm, and choose a user to associate the key with. We recommend disabling the "Set expiration date and time" so that alerts are not missed due to key expiration. Make sure to copy the key after creating it.

Step 2 - Create the Zabbix URL with token

Open a text editor and paste the API key from step 1. Then copy the Zabbix URL and paste it on another line in the text editor. Remove everything after the first '/' character and add a '#' at the end. Then Paste your API key. Your new URL should resemble https://light-kudu.zabbix.cloud/#7506c2db7a6420a6ea0f15a2b55254de4fa442d4d7311b1dabb8ec765dcbba

Step 3 - Add the Zabbix URL to QuantaStor

Login to your QuantaStor storage grid and then select the "Alert Manager" button to bring up the dialog for adding alert endpoints. On the second page select Zabbix from the dropdown list of ITSM integrations and then paste the URL endpoint captured in Step 2.

Step 4 - Apply changes and test

Apply your changes in the QuantaStor Alert Manager to add the new endpoint then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly. Login to your Zabbix account. The script should create automatically create a host in Zabbix that will be the parent of all the data received. Follow the step below to easily see new alerts created. Note that QuantaStor alerts at the "INFO" level are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alerts when generating test alerts.

Step 5 - (Optional) Use our script to setup the QuantaStor Alerts dashboard

/opt/osnexus/quantastor/bin/qs_alerthandler_zabbix.py --setup --url 'https://light-kudu.zabbix.cloud/#7506c2db7a6420a6ea0f15a2b55254de4fa442d4d7311b1dabb8ec765dcbba'

This will make a new dashboard under "Dashboards" in Zabbix named "Quantastor Alerts", listing all received alerts. They can be dismissed by acknowledging them in the update menu to the right of each alert.