Widgets¶

Graphs¶

A graph describes a service and displays the performance data related to it. You can specify a various parameters (the number of points you want to display, stack lines, fill lines, etc.):

Once you create the graph, you can edit it on the wizard page, selecting which lines you would like to display, their color and other properties:

Gauges¶

A gauge displays the percentage of a metric. Create a gauge by selecting a service and choosing the metric you want to display.

You can place a gauge in any position and in any direction (left to right, bottom to top, etc.). By default, the color of the gauge is associated with the status of the service.

Pie charts¶

A pie charts displays the status of a host, host groups or service groups.

For a host, the number of OK, Warning, Critical and NA states will be displayed. For a host group, the number of hosts in OK, Warning, Critical and NA states will be displayed.

Output¶

Default behaviour¶

The output widget describes the output of a service.

By default, the background is in the same color as the status. However, you can edit it by double-clicking on the output and modifing the “Status color background” checkbox in the output wizard.

Customizing the output¶

You can customize the output by adding service and metric properties. To do so, edit the output (by double-clicking) then click twice on the Next button.

You will see this page:

Here you can create the displayed content by using the properties listed in the table (3). Double clic on a line in the table and it will be inserted in the output.

By default, the properties listed belong to the service. If you want to add properties linked to a metric (such as the metric’s value, minimum, maximum) select the metric you want to use with the combo (2). The table (3) will then display the metric’s properties.

Note

When you create new output, the column Actual value might not be filled. However, as soon as you click on the Finish button, these properties will be filled in. They will appear when you edit the output widget.

Example¶

You would like to display the number of users connected to a VPN along with its name. The service you use has one metric called “clients” that represents the number of users connected.

To display the following output :

Configure the output widget as follows:

VPN : #parentLabel#
Number of users connected : #currentValue@clients#

URL¶

The URL widget is associated with a URL. Double clicking on it will open the URL.

For instance, if the URL points to a helpdesk platform, double click on it to open the helpdesk webpage in your default web browser.

Process¶

This widget can be used to trigger an action on any resources based on a command.

Here is an example:

You have an internal website that uses Apache, and sometimes Apache crashes. Your engineering team is investigating the core problem of why this crash occurs, however your priority is to make sure the end users can access the website. You can use the process widget by assigning a command such as “services httpd restart” so that when the Apache process crashes, users can immediately restart the Apache service from the view by double-clicking on the widget.

When creating the process widget, you must choose a service.

To create a service dedicated to an “action”:

• Create a command (Configuration > Command > Add) that contains “service httpd restart” (remember to enable shell).
• Link the command to a passive service.
• Link the passive service to a host (e.g., the host that hosts the website).

Then you can assign that service to the widget.