Hey! These docs are for version 6.3, which is no longer officially supported. Click here for the latest version, 6.7!

Service Check - Investigate

Overview of Service Checks Investigate mode

Investigate

Clicking on ‘Investigate’ will load a modal window with eight tabs (some tabs will be hidden based on the Service Check).

Investigate - Info Tab

The first of those tabs is the 'Info' tab as below:

20362036

The Info tab is a one-stop shop for all information relating to the Service. Each field means:

  • Host Name: The unique name of the Host with this Service Check.
  • Network Address: The address used to contact this Host.
  • Description: Description of the Host.
  • Service Check Status: The status of the Service Check, i.e. 'OK', 'CRITICAL', 'WARNING' or 'UNKNOWN'. Also displays how long the Service Check has been in the given state, i.e. 'OK for 2 days ..'. Will also display an Acknowledged text if this Service Check has been acknowledged.
  • Status information: The output of the Service Check. This can be multiline output so the area is scrollable.
  • Performance Data: If the Service Check returns data in a 'performance data' ('perfdata') format, it will be displayed here.
  • Current Attempt: The current attempt number, as Opsview Monitor decides if this is in a Soft or Hard state. This number will be between 1 and the number defined in the 'Max Attempts' field.
  • Max Attempts: The number of attempts required for the Service Check to be converted from a 'SOFT' state to a 'HARD' state.
  • State Type: Will be either Hard or Soft, based on Current Attempt and Max Attempts.
  • Last Check: The date and time of the last check of this Service Check, i.e. the last time the Service Check was run against the host, or the last time a result was received.
  • Check Type: Whether the Service Check is an Active Check, Passive, SNMP Trap or SNMP Polling type.
  • Monitored By: The name of the Monitoring Cluster that is monitoring the Host and its Service Checks. If monitored by a cluster, the cluster name will be returned here instead of the individual cluster node.
  • Latency: The time it took Opsview Monitor in seconds to execute the Service Check.
  • Execution Time: The time in seconds it took Opsview Monitor to execute the Service Check and get a result.
  • Next Scheduled Check: The date and time of the next scheduled execution of the Service Checks. This is an approximate value based on the check interval. This could be 'Unknown' for passive checks
  • Last Status Change: The date and time of the last status change, for example, when the Service Check changed from 'CRITICAL' back to 'OK'.
  • Is This Service Check Flapping?: A 'Yes' or 'No' label relating to Flap Detection, which is configured within the 'Notifications' tab of the edit window for the Service Check. See Section Details Tab: Advanced for more information. If the Service Check is marked as 'flapping', this field will change to 'Yes'.
  • In Scheduled Downtime?: A 'Yes' or 'No' label relating to whether the Service Check is in a state of downtime or not. If the Service Check is in an active period of downtime (i.e. the current date and time falls within a downtime periods configured date and time), the label will read 'Yes' and a "dialogue" icon will display the comment and expire time for the Downtime .
  • Last Update: The date and time of when a result was received for this Service Check.
  • Active Checks: An 'Enabled' or 'Disabled' label relating to whether active checks are currently allowed for this Host. This is configured via the 'Actions' tab. For more information, see 'Investigate mode: Service Check 'Actions tab'.
  • Passive Checks: An 'Enabled' or 'Disabled' label relating to whether passive checks are currently allowed for this Service Check. This is always enabled
  • Notifications: An 'Enabled' or 'Disabled' label relating to whether Notifications are currently enabled or disabled for this Service Check. This is configured via the 'Actions' tab. For more information, see 'Investigate mode: Service Check 'Actions tab'.
  • Event Handler: An 'Enabled' or 'Disabled' label relating to whether an Event Handler is currently allowed for this Service Check. This is configured via the 'Actions' tab. For more information, see 'Investigate mode: Service Check 'Actions tab'.
  • Flap Detection: An 'Enabled' or 'Disabled' label relating to whether flap detection is currently enabled or disabled on this Service Check. This is configured via the 'Actions' tab. For more information see 'Investigate mode: Service Check 'Actions tab'.

Removing an Acknowledgement

When an Acknowledgement has been set on a Service Check it will be shown next to the Status Information as well as a "dialogue" icon displaying the comment for the Acknowledgement. You can also easily remove this Acknowledgement.

Start by clicking on the menu for the Service Check you wish to remove the acknowledgement from and then selecting Investigate:

20362036

Click on the underlined 'Acknowledged' text or the trash can and then confirm the deletion.

Investigate - Actions Tab

The second of the tabs within the 'Investigate' view is the 'Actions' tab as below:

10221022

The Actions tab allows you to change certain settings relating to the Service Check such as whether active checks are enabled, or whether flap detection is enabled.

There is a form below the 'toggle buttons' panel, that allows for forcing the status of the Service Check, for example, to change the Service Check from an 'OK' to a 'CRITICAL' state with a user-defined 'output':

989989

Clicking 'Submit' will then submit the new Status command to Opsview.

Investigate - Graphs Tab

The third of the tabs within the 'Investigate' view is the 'Graph' tab:

10191019

The performance data in the 'Info' tab is performance data at a single point in time. The 'Graph' tab will display this performance data gathered by the Service Check over a 24 hour period.

If there is no performance data gathered by the Service Check then no graphs will be available, and the Graph tab will be automatically hidden.

The date range shown in the graph tab is defaulted to 1d (one day), however it can be modified to 1w (one week), 1m (one month), 1y (one year) or by manually specifying a date range (from and to) in the bottom left corner.

The values of the graph are shown on the 'Value' row, with the numbers here changing when the mouse is moved throughout the graph.

Finally, you can choose to 'Download', 'Save as', 'Annotate' or 'Print' the graph using the circle with the downwards arrow, located in the top right hand side of the graph.

Investigate - Troubleshoot Tab

The fourth of the tabs within the 'Investigate' view is the 'Troubleshoot' tab as below:

10161016

The 'Troubleshoot' tab allows you to test the Service Check, as it would be run by Opsview Monitor, via the user interface. Combined with the 'Macro Help' and 'Plugin Help' windows, you can modify arguments and click 'Submit' to test if the Service Check will work.

Simply modify the arguments using the text entry box at the top as per the plugin help file and click 'Submit' to test various combinations that the plugin may allow.

This tab will only appear for Active Check types.

Note - running the Service Check in this manner will apply Exceptions set on that Host, but will not apply Timed Exceptions.

Investigate - Notifications Tab

The fifth of the tabs within the 'Investigate' view is the 'Notifications' tab as below:

10171017

This tab will show all Notifications sent relating this Service Check.

  • Time: The date and time the Notification was sent.
  • Status: The status of the Service Check or Host check at the point of the Notification; i.e. CRITICAL, DOWN, etc.
  • # or Profiles: The number of Notification Profiles to whom the specific Notification was sent. The number is clickable, at which point a new modal window will appear displaying the User, Profile Name and Notification Methods used to notify the User. These Notification Methods are displayed as icons, which have a description in the tooltip when the mouse is hovered over the icon:
864864
  • Notification Type: The type of notification. Most of the time, this will be 'Normal', but other types include: 'Acknowledgement','Flapping Start','Flapping Stop'.
  • Information: The output of the service check at the time of the notification.

The list of Notifications can be exported by clicking on the 'Export' button, at which point you are prompted to choose one of three export formats: csv, json and xml. When the format is selected, the Notifications list will be generated in the given format and downloaded to the user's desktop/device via the browser.

Investigate - Events Tab

The sixth of the tabs within the 'Investigate' view is the 'Events' tab as shown below:

10181018

Essentially a different way of analyzing the history of a Service Check, the Events tab allows Users to choose a date using the date picker on the left hand side, which then re-populates the bar graph with the events (if any) for the chosen date. In the screen above, we have lots of events around 12:00, but no events between 13:00 till 05:00 the next day.

By default, the bar graph is displayed 'full tab', with the event checker minimized. The mouse can be hovered over the bars which will reveal the number of events in that given state, i.e. 1 'WARNING' events in the above example. When one or more bars are clicked, the event checker will be populated with the events from the selected bars:

10201020

In the above example we have clicked on the 1 WARNING events bar, which has loaded the event checker with the specified WARNING events. All other bars have a reduced opacity to show they are not selected. You can click additional bars to add to the checker.

To clear the event checker and minimize it we can simply re-click on the '1' bar which will deselect it. When the event checker is empty it will automatically minimize.

Within the event bar, located in the top right, is a 'downwards' arrow. When moused-over, this arrow will reveal three contextual menu options:

194194
  • Download as ...: Allows you to choose from one of four formats: png, jpg, svg or pdf.
  • Annotate: When selected, allows you to draw and annotate the bar graph. Once annotated, the bar graph can be downloaded using the 'Download as' button.
  • Print: Allows you to print the bar graph as an image.

Investigate - Notes Tab

The 'Notes' tab is the second to last tab within the Investigate mode window:

10251025

The Notes tab for a Service Check is very similar to the one for Host Groups and Hosts, in that it allows you to enter text in a WYSIWYG editor which can be seen and edited by other users of Opsview Monitor (who have permission to view the relevant Host/Service Check). This is a great way to leave notes about what the Service Check is i.e. 'Interface throughput monitor. This is Tim's Tyres router, they are located in London, UK and have an internal subnet of 192.168.1.0/24 with the router's IP being 192.168.1.254.'.

Investigate - History Tab

The 'History' tab is the last tab within the Investigate mode window:

10171017

The History tab will show the history of the Service Check within a tabular format. The 'Status' and 'Type' columns can be filtered via the columns contextual menu as below:

10091009

To filter on the date and time, you can use the filter toolbar at the top of the table. To apply the entered date and time parameters, you should click on the 'search' icon. To clear the entered results and reset the values in the fields, click on the 'cross' icon.

The history list can be exported by clicking on the 'Export' button, at which point you are prompted to choose one of three export formats: csv, json and xml. When the format is selected, the Notifications list will be generated in the given format and downloaded to the User's desktop/device via the browser.