Push iOS Heartbeat Monitor

The Heartbeat Monitor was designed to help PCF operators ensure their Push Notification service is running correctly end-to-end and provide historical data. The PCF Push tile deploys Heartbeat App in the push-service-instance in the push-notifications space of the system org. The app sends a "heartbeat" push every minute to every device subscribed to the pcf.push.heartbeat topic. The Heartbeat Monitor subscribes to the heartbeat topic and responds to the server every time it receives a heartbeat.

Pre-requisites

This app requires release v1.7+ of the PCF Push Notification Tile to work. Heartbeat App will automatically be installed in your push-service-instance.

Note: Make sure you have added a valid p12 certificate to your iOS platform and that the platform mode matches that certificate.

Setup

Begin by cloning the repo and using the closest release that matches your PCF installation.

git clone git@github.com:cfmobile/push-ios-heartbeatmonitor.git

There are two files that you will need to modify:

1. Open PCF Push Heartbeat Monitor.xcodeproj in XCode

2. In the Project Navigator, select the Info.plist file

3. Change the App Transport Security Settings > Exception Domains dictionary by replacing push-api.your.env.com with your push-api url

4. In the Project Navigator, select the Pivotal.plist file

5. Change the pivotal.push.serviceUrl field by replacing push-api.your.env.com with your push-api url

   • Note: Ensure the platform UUID and platform secret match the iOS platform found in your Configuration tab on your Push Dashboard (They should by default)

6. Build the Heartbeat Monitor on an iOS 8.0+ device

7. Accept Push Notifications on the device

8. Ensure the device shows up in the Devices tab of your iOS Platform on your Push Dashboard