Deploying Metric Insights' Custom Mobile Apps at your organization
This document will describe the steps needed to deploy the Metric Insights mobile app on iOS; Android is much more simple—a small section at the bottom is dedicated to it.
PREREQUISITES
- Submit your information via the Custom Mobile Build form (please request it from support@metricinsights.com)
- Receive the Xcode project and APK for your custom mobile build from Metric Insights team
- Acquire an Apple Developer Enterprise account
Create a new 'Metric Insights' App ID
Log into the iOS Dev Center and open your Account page:
- From the Program Resources Navigation menu to the left of the screen select Certificates, IDs & Profiles
- In the opened page select App IDs from the Identifiers section to the left of the screen
- At the iOS App IDs screen click Add (a plus button)
Register an App ID

- Define the Name of a new App ID
- Select Explicit App ID option and define Bundle ID
- In the App Services section make sure to select Push Notifications to enable them for your application
You should now see the info about App ID that you have created. Click Submit to continue.
Create a "Metric Insights" Certificate for Push Notifications
Generate a certificate for the and upload it the 'certificates' directory on your Metric Insights instance at:
/opt/mi/iv/data/certificates
Certificate has 2 variants: [app_id].pem (prooduction) and [app_id].dev.pem (development).
For example, 'com.metricinsights.viewer.pem' or 'com.metricinsights.viewer.dev.pem'.
For this reason, we have a Config Variable in Metric Insights that determines which certificate should be used (see next step).
Define the type of certificate to be used in Metric Insights
- Go to Admin > Utilities > Config Variables
- Search for a MOBILE_PUSH_ENVIRONMENT variable and define which certificate should be used and click Save in the pop-up
- Do not forget to click Save changes at the bottom of the Config Variables page to apply the changes
Once the certificates have been created and are in the appropriate locations, Push Notifications should begin to work.
NOTE: The certificates should be added to all supported instances (dev, prod, etc.).
If you have created a passphrase while building the Certificate, copy it into Metric Insights
- Go to Admin > Utilities > Config Variables
- Find MOBILE_PUSH_PRIVATE_KEY_PASSPHRASE variable and click a Gear button to edit it
- Define a passphrase for this variable and click Save in the pop-up
- Do not forget to click Save changes at the bottom of the Config Variables page to apply the changes
- Log out of Flex Alerts on the mobile device, and log back in
- Now go back to My Settings page in Metric Insights and try resending the test alert (described in the step below)
NOTE: You'll need to go through these steps for every server that needs to function with the Dashmonitor app.
Testing Alerts for an individual user
- In the drop-down menu below your name select My Settings
- In the opened screen click Send a test Alert. Assuming the device is logged in to the instance from which you are sending the test, you should receive it on your phone
Resending an existing aler
To test Alerts more thoroughly, you can create an Alert and then re-trigger it:
To get the Alert ID:
- Find the required Alert
- Go the Metric Editor of the Metric where this Alert has fired
- Open the Alerting tab; find and copy Alert ID in the Alert History grid
- Go to [INSTANCE_URL]/service/ns/alert
- Enter Alert ID in the corresponding field and click Send at the bottom of the screen
- System informs you whether the alert has been successfully resent
Android Requirements
On Android, there is no additional setup required for receiving Push Notifications. There is a key pair that comes with the MI instance and the Android app, and as there is no third party gatekeeper that manages notifications (e.g. Apple Push Notification Service), it should work as-is.