Widgets

Widgets are available in the “Palette” tab panel:

../../_images/palette-part.png

Here is a description of all the widgets available in Centreon MAP:

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.):

../../_images/graph-example.png

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:

../../_images/graph-line-wizard.png

Gauges

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

Warning

In order to display the percentage of a metric, you must first define a maximum value.

../../_images/gauge-example.png

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.

../../_images/piechart-example.png

Output

Default behaviour

The output widget describes the output of a service.

../../_images/output-example.png

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.

../../_images/status-background-color.png

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:

../../_images/output-wizard-metric.png

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 :

../../_images/output-example-2.png

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.

../../_images/widget_process.png

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.