Welcome to docs.opsview.com

This is an old revision of the document!


Opsview Mobile for Android

Introduction

Opsview Mobile for Android is a native mobile application for the Android platform that gives you on-the-go access to live monitoring data from your Opsview system. It uses the Opsview REST API to retrieve the status data from Opsview.

Pre-requisites

  • A device running the Android operating system, version 2.1 or later (2.2 for “install to SD card” support)
  • Opsview 3.13.0 or later

Installation

Opsview Mobile is available in the Android Market.

Views

The following views are available within the application.

Settings

When you open the application for the first time, the Settings view is shown and you will be able to enter the settings for your Opsview system. To return to the Settings at any time, navigate to the Hostgroup Hierarchy view, press 'Menu' and select 'Settings'.

  • API URL - The URL you use to access your Opsview system. Examples might be http://opsview.mycompany.com/ or https://www.mycompany.com/opsview
  • Opsview Username - The username you use when logging into Opsview (or the account you wish to use with Opsview Mobile, if different)
  • Opsview Password - The password associated with the above username
  • Request Timeout - The length of time the application should wait for a response from Opsview before giving up. The default of 5 seconds should typically be sufficient, but you may need to increase this value if you often use the application over a slow link (e.g. GPRS) or experience frequent timeout messages.

To exit this view, press 'Back'.

Hostgroup Hierarchy

This is the default view when opening the application, once you have configured your settings.

To the left of each hostgroup name are four colour coded squares which give a summary of the state of hosts and services in that hostgroup. The first column represents 'handled' states (denoted by the 'H' column header) and the second column represents 'unhandled' states. The top row refers to hosts, and the bottom row refers to services, as indicated by the 'Hst' and 'Svc' titles to the left. Finally, the colour of the square indicates the 'highest' (most severe) state of any objects (hosts or services) in that category, whilst the number shows the total number of objects. Below is an example to illustrate this.

In the above screenshot, in the 'Production Systems' hostgroup the following information is being shown:

  • There are 16 handled hosts. All of these hosts are in an up state.
  • There is 1 host in an unhandled state, and this host is down (indicated by the red background)
  • There are 153 handled services. The 'highest' state of any of these 153 services is critical.
  • There is 1 service in an unhandled state. The state of this unhandled service is 'Unknown' (indicated by the orange background)

To refresh this view, press 'Menu' and then select 'Refresh'.

To navigate down a level in the hierarchy, touch the name of the hostgroup you wish to navigate to.

To navigate up a level in the hierarchy, press the 'Back' button.

To exit this view, press 'Back'.

Host List

To open this view, select a 'leaf' hostgroup in the Hostgroup Hierarchy, i.e. one which contains one or more hosts.

The list of hosts is sorted by their state, with Down and Unhandled hosts appearing above hosts which are Up. The colour tab next to each host indicates the 'highest' (most severe) state of all the services on that host. For example if the colour tab is red, there is at least one service on that host in a critical state.

Long press on a host to display a context menu, which includes options to Acknowledge or Re-check a host.

Host Detail

To open this view, long press on a host in the host view, and select “View host detail”

Currently on the hostname and host state is displayed here, as further information is not yet available via the Opsview REST API. In future releases, more information will be displayed here.

To view a context menu, press the 'Menu' button. Options available are 'Refresh', 'Re-check host' and 'Acknowledge host'.

To exit this view, press the 'Back' button.

Service List

To open this view, touch a host whilst in a host view.

The list of services is sorted by their state, and then alphabetically. The colour tab next to each services indicates the state of that service. If the service is in an error state but is 'handled', then a green/purple tick will be displayed next to it to indicate this.

Long press on a service to display a context menu, which includes options to Acknowledge or Re-check a service.

To exit this view, press the back button.

Service Detail

To open this view, touch a host whilst in a host view.

To view a context menu, press the 'Menu' button. Options available are 'Refresh', 'Re-check host' and 'Acknowledge host'.

To exit this view, press the back button.

Viewport Status

To open this view, from the Hostgroup Hierarchy view, press Menu and select “Viewports”. Any defined viewports will be displayed like this:

The viewports are sorted by severity ('highest' state first), and then alphabetically. Any viewports in an error state but with all hosts/services handled will show a green/purple tick next to their name.

To refresh this view, press 'Menu' and then select 'Refresh'.

To exit this view, press 'Back'.

Feedback

Any feedback you might have about the application can be left in the Opsview Mobile for Android Forum

Navigation
Print/export
Toolbox