Welcome to docs.opsview.com

Dashboard

Opsview Dashboard provides a single view of your entire Opsview system where you can choose what you want displayed.

The Dashboard consists of multiple dashboard tabs where you can add new dashlets on.

State information is automatically saved as you make changes so that coming back to the dashboard will show the last state.

Dashboard Tabs

Click the Add button to add a new tab.

Double click a tab to change the name.

Note: You are limited to 64 characters for the dashboard title.

You can right click on a tab to get more options.

Dashlet Drawer

The dashlet drawer contains all the different dashlets available. This is separated into 3 categories:

  • Business
  • Technical
  • NetFlow

Business Dashlets

Process Map

This dashlet allows you to add objects onto a graphical background so that you can see status information.

Note: If you add objects for a different Opsview master and share this process map with other users, each user needs to add this Opsview master with the same URL. This is because each user maintains their own list of Opsview masters for security reasons.

Keyword List

Displays status information in list format based on Opsview keywords.

The default behaviour is to display all keywords.

If you sort by the status column, a secondary sorting of the description column descending will be used.

Configuration options:

  • Filter by keyword
  • Refresh interval

Keyword Cells

Displays status information in cell format based on Opsview keywords.

The default behaviour is to display all keywords.

Sorting is based on the chosen filter by keyword order. If not specified, will be ordered alphabetically.

Configuration options:

  • Filter by keyword
  • Refresh interval

Keyword Tree Map

Displays status information in a tree map format based on the state of services in each keyword. The black headers contain the keyword name and the colours within the blocks reflect the number of services of that particular state.

The default behaviour is to display all keywords.

Configuration options:

  • Filter by keyword
  • Refresh interval

Performance Gauge

Displays performance metrics in a gauge format. If there are multiple metrics, these will be summed together

This dashlet must be configured before it will display any results.

Configuration options:

  • Host, Service and Metric: Values used to plot the gauge value. Can define multiple metrics
  • Metric label
  • Maximum value - required to set the gauge range
  • Warning threshold
  • Critical threshold
  • Refresh interval
  • Humanise values - this will normalise all values to a standard unit of measurement (for example, 3194MB will be normalised to bytes and thus return 3.19G). You will need to set the maximum value to be of the same scale

Note: If you have multiple metrics and there is at least one valid metric value, the gauge will display the sum of the valid metric values and show a warning icon about the invalid metrics.

Performance Graph

Displays one or more performance metrics in graph format.

This dashlet must be configured before it will display any results.

Configuration options:

  • Host, Service and Metric: Values used to plot the data series. Multiple series are permitted
  • Duration of graph
  • Chart type
  • Line thickness
  • Refresh interval

Technical Dashlets

Event Table

Displays monitoring events in table format.

Initially this dashlet will display the most recent 25 events across all monitored systems. You can apply filters to restrict which events will be displayed.

Configuration options:

  • Filter by Host Group
  • Filter by Keyword
  • Filter by individual Host or Service
  • Filter by State
  • Select how many events to display
  • Refresh interval

Filters are additive.

Event Timeline

Displays monitoring events in timeline format.

Initially this dashlet will display the all events occurring in the last 6 hours. You can apply filters to restrict which events will be displayed.

Configuration options:

  • Filter by Host Group
  • Filter by Keyword
  • Filter by State
  • Timeframe covered by timeline window
  • Refresh interval

Filters are additive (AND)

Host Group Hierarchy

Displays summary of host and service status based on Host Group Hierarchy.

The default behaviour is to display downtime, unhandled host events and unhandled service events for all Host Groups. You can add additional columns to this view. You can also filter by Host Group.

Configuration options:

  • Filter by Host Group
  • Filter by State
  • Refresh interval

Filters are additive (AND)

Top Services by Metric

Displays metric data for multiple hosts.

Configuration options:

  • Service and metric value filtering options
  • Critical and warning thresholds to change state color of the metric value
  • Top 25 or top 10 values

Note: The highest metric values will always be returned from the Opsview server. If a metric value is blank, this will be ordered to the bottom.

Note: If a metric value is not available due to a plugin failure, it will not be listed.

System Status

Displays Opsview system status information.

Configuration options:

  • Enable/disable configuration status indicator
  • Enable/disable passive service check metric

Note Pad

Displays text information with basic formatting. You can use this dashlet as an action list or to save a reminder.

This dashlet has a basic WYSIWIG text editor interface.

NetFlow Dashlets

Sources Summary

This dashlet gives a summarised view of the amount of traffic being captured on each source.

You can also group the sources by collector to get a summarised view of data for each collector.

Sources History

This dashlet shows a graph view of the amount of traffic, according to NetFlow.

The bar shows the total amount of data transfered over that time range.

You can click and drag to zoom into a part of the graph. Note that the zoom will reveal more granualar data (up to a minute frequency), so the shape of the graph should still be roughly the same though you may get different peaks.

You can click on the Investigate button to view a more detailed look where you can select the various Top 10 dashlets to get a view of the data at that particular point in time.

If you draw a stack graph, it is possible that not all sources will be shown in the graph. This is because a null value (which means no data at a specific point in time) will stop drawing the stack.

Top 10 Host Transmitters and Top 10 Host Receivers

This dashlet shows the top 10 hosts that are either transmitting or receiving the most data, according to NetFlow. This is based on the current time, although you can change the window of how far back the statistics should go.

This information is represented as a grid as well as a pie chart.

The information in the Host field will be:

  • the host name as known by Opsview. If this host matches with multiple Opsview hosts, there will be a popup with links to each host, or
  • the DNS name of the host, or
  • the IP address

The DNS name is resolved by using the system's host name lookup routines. This is usually configured to use the local /etc/hosts file and then DNS - this is a Unix system setting.

If the collector is a slave system, then the resolution will occur on the slave.

Note: If there is no data over the time period chosen, the dashlet will display Data not available.

Top 10 Port Transmitters and Top 10 Port Receivers

This dashlet shows the top 10 ports that are either transmitting or receiving the most data, according to NetFlow.

This information is represented as a grid as well as a pie chart.

The port is resolved by using the system's port name lookup routines. This is usually configured to use the local /etc/services file - this is a Unix system setting.

If the collector is a slave system, then the resolution will occur on the slave.

Top 10 Transfers

This dashlet shows the top 10 transfers, according to NetFlow. This is useful to see which transfers from a specific host to another host are using the most bandwidth.

This information is represented as a grid as well as a pie chart.

Share My Dashboard

It is possible to share your dashboard with other users. Click on the Share My Dashboard button and you will be presented with a screen of all your dashboard tabs.

If you have CONFIGUREROLES access, then you can choose specific roles for each dashboard tab so only users in that role will be allowed to import the dashboard tab into their list. If no role is selected, then all users can import this dashboard.

If you do not have CONFIGUREROLES, then you can restrict to users in your role or make it available to everyone.

If you stop making a dashboard tab shared, users will still have the tab in their list but on the next reload of Dashboard, it will be removed.

Note: You cannot change the role list if the dashboard is currently in use.

Note: When you share your dashboard, the user is still bound by their permissions in the Opsview system, so the user may see different host groups, hosts or services.

Note: The user's access list, eg CONFIGUREROLES, is cached at Dashboard load time and a page reload is required to refresh this cache.

Read-Only Dashboard User

You can set users to be read-only dashboard users, so they have a subset of functionality.

Read-only dashboard users will be able to:

  • add shared dashboard tabs
  • remove dashboard tabs
  • reorder dashboard tabs
  • save their dashboard view settings, such as the currently active tab, if rotating dashboards is set, dashlet drawer open/close, and full screen mode

Read-only dashboard users will not be able to:

  • add a private dashboard
  • edit, add, clone or move dashlets
  • set a dashboard to be shared
  • make any multi-master changes

To mark a user as a read-only dashboard user, remove the DASHBOARDEDIT access from the relevant role.

Multi-Master

Dashboard includes Multi-Master support which allows a Dashboard user to connect to multiple Opsview systems. This feature is only available if you have the Dashboard Multi-Master feature enabled.

The Multi-Master button in the Settings drawer will be visible. Clicking on this will bring up a list of all the Opsview Masters that you can connect to.

The first item in the list is always the Default master, which is the Opsview Master system that is running the dashboard application.

If there is an Opsview master defined (in addition to the default master), then relevant dashlets will display an option of selecting which Opsview master will data be collected from. In addition, the process map will allow selection of the Opsview master based on each object.

Each Opsview Master is uniquely identified by its URL. You need to enter a user name and password for each Opsview Master so that the dashboard application knows how to connect to that master.

Note: If you change an Opsview Master's URL, all dashlets associated with it will need to be reconfigured.

The dashlet titles have a special macro, $MASTER_NAME$, which will expand to the name of the Master server. This macro will be automatically added to dashlet titles when the dashlets are added to a dashboard.

Note: if you add a multi-master, dashlets will not have their title retrospectively added with this macro.

Note: The password for the multi-master connection will be saved encrypted in the Opsview database.

Known Issues

  • For Internet Explorer browsers, the dashboard tabs cannot be dragged beyond the 1st tab to the left of the dragged tab. It is possible to drag if the mouse is dragged to the left within the main dashboard area. Dragging to the right works correctly.
  • For IE10, the Note Pad dashlet sometimes has the toolbar in a disabled state. Reloading will always make the dashlet work again.

Troubleshooting

Access Denied

If you get a message saying Access Denied, then your session may have expired communicating to the Opsview Web backend. This means that recent changes may not have been saved.

Reload the web page to log back into Opsview and renew your session.

This dashlet is configured to use Opsview Master at URL, but this system is not configured

This means that the master server at that URL does not exist in the Multi-masters list.

There was a problem in Opsview 4.3 where you could see this message even if you did not have Multi-master enabled but your Opsview master can be accessed from two different URLs (for example, http://10.10.10.10/ and http://host10.example.com). This is fixed in Opsview 4.4.0, but to get Opsview to fix the data automatically, you need to:

  • Access the Dashboard from the URL specified (eg, http://10.10.10.10)
  • Make a change to the dashboard tab so that it saves the new configuration
  • Repeat for each dashboard tab affected
  • Load the Dashboard from the other URL (eg, http://host10.example.com)
Navigation
Print/export
Toolbox