Which steps are necessary to receive push notifications from my PRTG core server on my iOS and Android devices?
This article applies as of PRTG 20
Push notifications from PRTG
With PRTG, you can send free push notifications from your PRTG server to your Android and iOS devices.
Note: PRTG versions previous to 15.4.20 do not support cloud features anymore because we changed the cloud infrastructure with this version. If you run a previous PRTG version, update your PRTG server to use push notifications and other PRTG Cloud services.
For the setup that is described in this article, you need:
- PRTG core server: 15.4.20 or later
- PRTG for Android: 14.4.13 or later
- PRTG for iOS: 14.4.13 or later
General push concept
If you want to add a new notification in the PRTG web interface, go to Setup | Account Settings | Notification Templates, click Add Notification Template, and select the notification method Send Push Notification. You can select a single user or an entire user group to which the push notification will be sent when it is triggered.
Every user account has a number of notification contacts (see Setup | Account Settings | Notification Contacts). This list may contain different types of contacts, for example, Email or Push. A push contact consists of a description name and a unique token (listed in the Recipient column) that identifies the target device.
When a push notification is triggered for a certain user account, PRTG sends it to all active contacts of the type Push that are listed for the user. This means, when a push notification is triggered for your user account, you will see the notification on every single mobile device that you registered (and that is not set to Pause).
To register a mobile device so that it can receive push notifications and so that it shows up in your Notification Contacts list, you have to connect to your PRTG core server using one of our PRTG apps for iOS or Android. See the article Push registration with my iOS devices fails. What can I do? if you have issues registering your iOS devices as notification contacts in PRTG.
First time setup
- Install the PRTG app PRTG for Android or PRTG for iOS on your mobile device.
- In the PRTG app, set up a connection to a PRTG core server version 15.4.20 or later using the DNS name or IP and login credentials.
Note: Your phone also needs to have a working internet connection at the same time.
- In the PRTG app settings, activate push notifications.
PRTG for iOS: If you use the PRTG for iOS, you do not have to manually activate push. Your iOS device will ask you to allow push notifications for this PRTG app when you connect to the PRTG server for the first time. Confirm that you want to receive push notifications from PRTG.
If you have denied push notifications before, see the article Push registration with my iOS devices fails. What can I do? for how to allow push notifications again.
- The PRTG app will automatically send a unique token to the PRTG core server. In the PRTG web interface, a new entry for your device will appear in the Notification Contacts list of the user account you connected to. Your PRTG user account is now ready to receive push notifications. See the article How does the PRTG Cloud deliver push notifications? for details.
- Any push messages that are triggered by PRTG will immediately appear in the notification area of your mobile device. Tap the messages to open the PRTG app and to show more information.
Note: The PRTG server needs to communicate with the PRTG Cloud on port 443 to send push notifications (https://api.prtgcloud.com:443).
Add notifications and triggers to your PRTG configuration
Note: You will only receive push notifications when you set up a Notification Template that uses the Send Push Notification method and when you set notification triggers that use this notification template (for example, on the Notifications tab of a sensor).
For details about setting up notifications in PRTG, see PRTG Manual: Sensor Notifications Settings.
Pause and delete push contacts
If you pause a push contact in the Notification Contacts list using the Pause button, PRTG will not send push notifications to this device until you Resume it.
If you Delete a push contact, PRTG will forget the token of your device and will not send push notifications anymore.
Re-register a push contact after you deleted it
The device will be re-registered with your user account and will reappear in the Notification Contacts list if you follow these steps:
- Make sure that push notifications are enabled in the PRTG app settings.
- Set up a new connection to the PRTG core server version 15.4.20 or later using the DNS name or IP and login credentials.
- If such a connection still exists in the PRTG app, do the following:
- PRTG for iOS: Quit the PRTG app in the task manager and restart it. Reopen the PRTG app and tap on the according connection to connect to the PRTG server.
- PRTG for Android: Simply go to the settings page and press the back button. All of your accounts that support Firebase Cloud Messaging (FCM) will be re-registered.
Some background information
Behind the scenes, push notifications require a rather complicated setup, and every push notification must go through several servers to reach your mobile device.
Every mobile device that runs one of our push-enabled PRTG apps requests a unique token from the Google or Apple cloud and reports it to the PRTG core server that it is connected to. The PRTG server stores the token for the respective user account.
Paessler runs a special cloud service to provide you with push notifications. Every PRTG installation communicates with this PRTG Cloud. When a push notification is triggered, the PRTG server sends a request to the PRTG Cloud to push a notification to the device with the respective token. The cloud simply forwards this request to the Google (Android) or Apple (iOS) cloud. From there, the push notification is sent to your target device and the push notification is shown. See the article How does the PRTG Cloud deliver push notifications? for details.
According to our tests, this notification mechanism can be even faster than receiving SMS text messages. It is also more convenient to use. Even a GPRS data connection is sufficient to receive push notifications.
For more information, see also Is there an FAQ for push notifications?
any ETA on this functionality making it into the Stable channel? Looks like it's been in the Preview channel for quite some time and before I spend a bunch of time trying to get a different method for push notifications (on Android) working, I'd like to know if this is close.
This feature is currently in a pre-release version of the Preview channel, so it should be available in the Stable channel within few weeks. Please bear with us.
I tried with ios and android but still "connection timed out error".Any help appreciated..
Does your PRTG Version meet the above requirements (version)? Is a Proxy Server used in your network?
My Current version PRTG Version is PRTG Network Monitor 220.127.116.1100 x64 .And there's not proxy for connection Internet.
Can you please get in contact with us via email to [email protected] with a screenshot showing the Log-Entry to the Push-Notification and your license key. Thank you!
Shame that Windows is coming later again. But I'm very happy with Pushalot, so don't really need it.