Welcome to docs.opsview.com

Opsview Mobile for iOS

Architecture

Opsview Mobile is a native iOS application that runs on iOS 5.0 and higher. It has been tested on the following devices:

  • iPhone 4
  • iPhone 4S
  • iPad 2

It uses Opsview's REST API to communicate and requires a connection from your device to your Opsview server via HTTP or HTTPS.

To enable push notifications, you will need a connection from your device to our push notification servers at push.opsview.com via HTTPS.

Installation

Install Opsview Mobile via the Apple App Store.

Configuration

On the first load, you will be prompted for your connection details:

  • Username & password: The login name you use in YOUR opsview instance
  • Hostname: The web page you use for your Opsview instance, e.g. http://opsview.mycompany.local
  • REST API URL: This should be /rest unless you've altered the Opsview instance
  • Use SSL: Set this based on your instance settings; by default Opsview does not use SSL
  • HTTP Auth Username & passsword: Your Opsview.com username and password

Note: It is not possible to view multiple Opsview systems at once.

Push Notifications

To enable push notifications:

  1. You must include your valid Opsview.com username and password in the app Settings for Push Notifications
  2. Your device must be able to do a one-time connect to your Opsview Master server in order to retrieve it's UUID for registration of the device on push.opsview.com.
  3. Your device must be able to connect to push.opsview.com via HTTPS
  4. Your Opsview system must be setup to send notifications to push.opsview.com via HTTPS, with a valid Opsview.com username and password for security. This username does not need to match with (1)

The notifications work on a per contact basis, so based on the contact that is receiving the notification, the push server will deliver the message to the correct devices. This means that the username in Opsview System Authentication in the Opsview Mobile Settings must match with the contact from the Opsview server.

It is possible to have one notification message sent to multiple devices.

Opsview Notification Configuration

Opsview 4.1.2 and Opsview Core 20120925 have built in support for push notifications, but you need to enter your opsview.com credentials in the notifications method configuration page in Settings → Administration → Notification Methods → Push Notifications For iOS Mobile:

This user id ensures that you have appropriate access on our push server to send notifications.

You can then assign this notification method to your notification profiles. To add to your user profile, go to your user name → Access Profile.

In the Notifications tab, click on the Personal notification profiles link.

Click on Add button.

Configure your notification profile, selecting the Push Notifications For iOS Mobile notification method.

Then reload to take effect.

You can add push notifications to Opsview 3.14.X, 4.0.X, 4.1.0 and 4.1.1 by following instructions on this page.

The Result

The server that sends notifications needs to speak to our push server, push.opsview.com. Opsview versions 4.0.3+ can communicate via HTTPS to this server (port 443). Previous versions can communicate via HTTP (port 80) only, unless the LWP::Protocol::https Perl module is available.

It should be noted that you need to use your opsview.com username, not your email. Log on to opsview.com using your email to find out what your username is if you are not sure.

Opsview Mobile Version History

  • 2.1.4 Sept 2012 - First release
Navigation
Print/export
Toolbox