This Zabbix media type can be used to send push notifications to your smartphone or tablet via the IntelliTrend Mobile for Zabbix app, available for IOS and Android.
- Zabbix 6.0 or higher
- IntelliTrend Mobile for Zabbix App 6.8 or higher
To setup push notifications, you must enable push notifications in your IntelliTrend Mobile app, install the media type provided in this repository and create a Zabbix user media with the parameters provided by the IntelliTrend Mobile app.
NOTE: Depending on your Zabbix user type the IntelliTrend Mobile app may be able to automatically create your user media for you. For more information see step 3.
If you don't have the IntelliTrend Mobile app yet, you can get it here:
Open the IntelliTrend Mobile app, sign in using either a Zabbix Direct or Prisma User account if you have not already and then navigate to the Settings page using the sidebar, you should see the following screen:
On this screen, press the Push Notifications toggle to enable Push Notifications. After pressing the toggle, the following modal should appear:
Once the modal has appeared, press the enable button in the bottom right corner. Upon pressing this button, a modal from your device's operating system will appear, asking you to grant push notification permissions to the app. Make sure to grant the app this permission.
At this point push notifications are enabled in your app, but both your Zabbix media type and your Zabbix user media are still not setup.
You should now see one of the following two screens on the settings page:
If your Zabbix user has no permission to see the Zabbix media types (mediatype.get API call), the App is not able to check whether the Zabbix media type exists or not. Usually the Admin or Superadmin role is required to see Zabbix media types.
But no worries, regular Zabbix users are still able to use push notifications.
The next step is to install the IntelliTrend Mobile media type from this repository in Zabbix.
To install the media type on your Zabbix server, click on the file intellitrend_mobile.yaml and then press the download raw file button.
Next, sign in to your Zabbix frontend, navigate to Alerts → Media types (Zabbix 6.4) or Administration → Media types (Zabbix 6.0) and click on Import on the top right bar.
Then, in the dialog window, select the previously downloaded intellitrend_mobile.yaml and click on Import.
NOTE: In case you want to update an existing version of the IntelliTrend Mobile media type, make sure to also check the 'Update Existing' checkbox
After clicking import, the IntelliTrend Mobile media type should now appear in the list of media types:
To check if the media type has been correctly installed and is detected by the IntelliTrend Mobile app, open the IntelliTrend Mobile app, navigate away from the settings page and then back onto it, to refresh the shown data. In case your user has the required permissions, you should see the following screen, indicating that the Zabbix media type was found but the Zabbix user media is still not configured:
When the App wasn't able to check whether the Zabbix media type exists or not, you can still use push notification. The App just wasn't able to confirm that the Zabbix media type has been imported correctly.
Now that the media type has been installed in your Zabbix server, you need to set up your user media. There are two ways this can be done, depending on your user type within Zabbix.
If you have the User type Admin or the User type Superadmin, you can set up the required user media using the IntelliTrend Mobile app's built-in convenience feature. To do this, simply tap on Zabbix user media on the settings page, this should open the Zabbix user media creation modal. There are two possible scenarios here:
If you have never setup push notifications for this user before, you should see the following screen:
In this case, simply tap the Add new Zabbix user media button to create a new user media in Zabbix. After creating a new user media, you should see the following screen, indicating that the media has been created and is bound to this app installation:
If this is not the first push notification setup for this Zabbix user, there may already be devices listed in addition to the Add new Zabbix user media button:
In this case, look for your current device in the list of devices and simply tap it to bind it to your current app installation. If your current device does not appear in the list simply tap the Add new zabbix user media button to create a new user media for this device.
NOTE: Pressing the delete button on a device entry, will delete the corresponding user media in Zabbix. This is useful if one of your devices is no longer in use. Do not delete an entry if that entry is in use by another device of the same Zabbix user.
After activating a user media from the list or creating a new user media, you should see the following screen, indicating that the user media was bound to this installation:
If you do not have the user type Admin or the user type Superadmin, you are not able to create the Zabbix user media yourself. In this case, you will need the assistance of your Zabbix administrator to create your user media in Zabbix.
Tap on the user media item on the settings page, expand the Create Zabbix user media manually section and click the copy button to copy your configuration to the clipboard:
Then provide this configuration string to your Zabbix administrator, so they can create a user media for you.
To create the required user media, the Zabbix administrator must first navigate to Users → Users (Zabbix 6.4) or Administration → Users (Zabbix 6.0) and then click on your User. Next, they must navigate to the Media tab in the top bar and then click the Add button.
In this modal, select the IntelliTrend Mobile media type and then paste the configuration string provided by the user into the Send to field. Optionally, you can set up a schedule when push notifications should be active using the When active field or a severity filter using the Use if severity checkboxes:
NOTE: User media that were created automatically using the IntelliTrend Mobile app also show up in the list of user media of their respective user in Zabbix
At this point, your settings page should look as follows, indicating that the Zabbix media type was found and the Zabbix user media configuration is ok:
You can now sign in to the Zabbix Frontend and configure alerts with operations as you would for any other media type. Existing trigger actions that use the Send only to: All option will now also begin sending push notifications with the IntelliTrend Mobile app.
For example, to only receive push notifications when a problem arises, simply configure a trigger action and then select the IntelliTrend Mobile media type from the list of media types. Of course, you can also select all media types if you do not want to limit alerts to push notifications:
If you are a IntelliTrend Prisma user, you can use our convenient alert management feature found under Self Provisioning → Alerts, to configure alerts with a few clicks, directly from the IntelliTrend Mobile app.
Simply select the hostgroup you wish to be alerted for from the list, choose the minimum severity you would like to be alerted at, select if you would also like to be alerted for subgroups and click subscribe:
Prisma will automatically configure the required trigger action in Zabbix, so you can easily manage alerts from your mobile device.
If you are interested in IntelliTrend Prisma, click here to learn more.
Unfortunately regular Zabbix users are not able to see media types, which are required when adding a user media. Without knowing which ID our IntelliTrend Mobile media type has, it is not possible to automatically add the user media for you. Because of that, the feature to create the user media automatically is only available to Zabbix admins or superadmins.
But this doesn't mean regular Zabbix users are not able to use push notification. A Zabbix administrator can still add your Zabbix user media manually in Zabbix. To do so, follow the steps when clicking on User media and then Create Zabbix user media manually in the App.
Since Zabbix version 7.0.2, regular Zabbix users (user type user) can no longer update their own user medias. In that case you should contact your Zabbix administrator
and ask him to update your user media for you with your new Send to value. You can find that value when expanding the Create Zabbix user media manually section in the
User media modal.
No. Our app checks for the media type by name, so renaming it will cause the app to no longer detect the media type.
If you are having trouble getting push notifications to work, you can perform the following troubleshooting steps:
Step 1: Ensure notifications are set up correctly in the app
Navigate to the Settings page in the IntelliTrend Mobile app and ensure that your push notification section looks as follows, indicating that push notifications are enabled, the push media type is detected and that the user media exists and is up-to-date:
If your user has no permission to see Zabbix media types, the App will not be able to check whether or not the IntelliTrend Mobile media type exists or not. In that case you should make sure the IntelliTrend Mobile media type exists on your Zabbix server and your user media is using it.
Step 2: Check for trigger action errors in Zabbix
Sign in to Zabbix and navigate to Monitoring → Problems, and click the icon displayed under actions, giving you an overview over the actions that were sent and if they had an error or not. Alternatively you can also check the action log, which can be accessed by navigating to Reports → Action log, to get an overview over all sent alerts.
If your alert shows up with the error invalid credentials, go back into the IntelliTrend Mobile app and double check that your Zabbix user media has the status OK. If this is the case, tap Reset device identifier and then confirm the reset in the modal that opens. After this update your user media and try again. If this does not fix the problem please contact customer support support@intellitrend.de.
NOTE: Depending on your user type, resetting your device identifier may require the assistance of your Zabbix administrator to update your user media with the new device identifier, as explained previously.
If your alert shows up with any other error, try again after some time. If the issue persists, please contact customer support at support@intellitrend.de.
In case your alert does not show up in this list, your trigger action configuration is incorrect. You can validate that the setup works by performing a manual test as described below.
Your Zabbix user media requires an update whenever your persistent push identifier (PPI) changes. This can occur when uninstalling, reinstalling, or updating the IntelliTrend Mobile app and after using the Reset device identifier option.
If your PPI has changed, simply sign in to an account on your Zabbix server using the IntelliTrend Mobile app, navigate to the Settings page and update your user media by tapping the User media item and then selecting your device in the device selection modal as described in Step 3.
To test the IntelliTrend Mobile media type, begin by navigating to Alerts → Media types (Zabbix 6.4) or Administration → Media types (Zabbix 6.0) and clicking the test button for the IntelliTrend Mobile media type.
This should cause the following modal to open:
Begin by setting the title and body fields to any test string you like.
Set the entity_id field to a valid Zabbix event ID, which you can obtain by navigating to Monitoring → Problems, clicking on a problem and then copying the event ID from the URL.
Set the severity field to a valid numeric severity such as 2 for warning. Check this documentation page and scroll down to the severity property if you are unsure about numeric severities.
To set the sendto parameter, open the IntelliTrend Mobile app, navigate to the Settings page, ensure that push notifications are enabled and then tap on Zabbix user media. In the user media modal, expand the Create Zabbix user media manually section and press the copy button to copy the configuration to your clipboard. Now paste this configuration into the media types sendto parameter.
Finally, press the Test button:
And view the notification on your device:
