Centreon Map Enaa

66
Centreon Documentation Release 3.7.0 Merethis July 28, 2015

description

aa

Transcript of Centreon Map Enaa

Page 1: Centreon Map Enaa

Centreon DocumentationRelease 370

Merethis

July 28 2015

Contents

i

ii

CHAPTER 1

Presentation

Centreon Map is an advanced mapping unit which represents user-friendly views of indicators being monitored byCentreon

Thanks to ldquodrill-downrdquo navigation users can create representations without any depth limitation

The most alarming statuses of elements being monitored are provided in real time through customisable views thatcorrespond to each userrsquos requirements business functional technical topological etc

Views can be created very easily (for example with drag-and-drop) and depend on the database of resources configuredin Centreon Views are automatically synchronised and updated thanks to information gathered by Centreon and thescheduler

1

Data is represented graphically and in real time which makes it possible to have one console focusing on monitoringits activities

Definition

bull Screen A single visual representation Each depth level corresponds to a Screen

bull View Set of Screens linked together by a tree structure system

bull Perspective Set of windows linked to internal operation of Centreon Map software

bull Window Perspective component linked to daily software management

bull Object Resource used to create Screens Objects come from the Centreon web interface or from CentreonMap

bull Drop-down menu Menu of actions can be accessed by right clicking the mouse when selecting an Object

bull Scheduler refere to Centreon Engine or Nagios

2MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 1 Presentation

CHAPTER 2

Prerequisites

21 Client

Centreon Map Version Supported Java versions Minimum Update Maximum Updatelt 36 16 17 0 25gt= 36 16 17 25 71gt= 36 18 40 40

The update version limitation applies only to Java Web Start launching The desktop client works well with any Java6 7 and 8 JVM version

22 Server

Softwares Minimum versionCentreon 25xNagios or Centreon Engine 3x or 1x

23 PHP

PHP version Required modules and softwareslt 53 Zend Optimizer php-mcrypt php-xml php-xml-writergt= 53 Zend Guard Loader php-mcrypt php-xml php-xml-writer

24 Centreon

The Centreon Map maintenance and support does not include the maintenance and support of Centreon andorNagios It is the system administratorrsquos responsibility to ensure that the Centreon amp Nagios system works correctlywhen installing Centreon Map extension

In order to fully benefit from the use of the Centreon Map module here is a non-exhaustive list of properties thatCentreon amp Nagios must have

bull Centreon installed and operational

bull No or little latency with Nagios Centreon Engine

3

bull Activation collection and presentation of RRDTool performance graphs in Centreon

bull No gap holes within the Centreon performance graphs

bull Nagios Centreon Engine logging

bull Operational downtime scheduling and comment submit

bull Operational notification system

bull Definition of monitoring indicators (hostsservices) in Centreon

bull MySQL database correctly configured

bull Operational and stable Linux Unix system

bull Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map

Once the prerequisites are met proceed with the installation of the Centreon Map module

All paths and service names in the following documentation are based on CentOs You may need to adapt these yourown linux distribution

For example lsquousrsharersquo may be lsquousrlocalrsquo and lsquohttpdrsquo may be lsquoapache2rsquo

4MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 2 Prerequisites

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 2: Centreon Map Enaa

Contents

i

ii

CHAPTER 1

Presentation

Centreon Map is an advanced mapping unit which represents user-friendly views of indicators being monitored byCentreon

Thanks to ldquodrill-downrdquo navigation users can create representations without any depth limitation

The most alarming statuses of elements being monitored are provided in real time through customisable views thatcorrespond to each userrsquos requirements business functional technical topological etc

Views can be created very easily (for example with drag-and-drop) and depend on the database of resources configuredin Centreon Views are automatically synchronised and updated thanks to information gathered by Centreon and thescheduler

1

Data is represented graphically and in real time which makes it possible to have one console focusing on monitoringits activities

Definition

bull Screen A single visual representation Each depth level corresponds to a Screen

bull View Set of Screens linked together by a tree structure system

bull Perspective Set of windows linked to internal operation of Centreon Map software

bull Window Perspective component linked to daily software management

bull Object Resource used to create Screens Objects come from the Centreon web interface or from CentreonMap

bull Drop-down menu Menu of actions can be accessed by right clicking the mouse when selecting an Object

bull Scheduler refere to Centreon Engine or Nagios

2MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 1 Presentation

CHAPTER 2

Prerequisites

21 Client

Centreon Map Version Supported Java versions Minimum Update Maximum Updatelt 36 16 17 0 25gt= 36 16 17 25 71gt= 36 18 40 40

The update version limitation applies only to Java Web Start launching The desktop client works well with any Java6 7 and 8 JVM version

22 Server

Softwares Minimum versionCentreon 25xNagios or Centreon Engine 3x or 1x

23 PHP

PHP version Required modules and softwareslt 53 Zend Optimizer php-mcrypt php-xml php-xml-writergt= 53 Zend Guard Loader php-mcrypt php-xml php-xml-writer

24 Centreon

The Centreon Map maintenance and support does not include the maintenance and support of Centreon andorNagios It is the system administratorrsquos responsibility to ensure that the Centreon amp Nagios system works correctlywhen installing Centreon Map extension

In order to fully benefit from the use of the Centreon Map module here is a non-exhaustive list of properties thatCentreon amp Nagios must have

bull Centreon installed and operational

bull No or little latency with Nagios Centreon Engine

3

bull Activation collection and presentation of RRDTool performance graphs in Centreon

bull No gap holes within the Centreon performance graphs

bull Nagios Centreon Engine logging

bull Operational downtime scheduling and comment submit

bull Operational notification system

bull Definition of monitoring indicators (hostsservices) in Centreon

bull MySQL database correctly configured

bull Operational and stable Linux Unix system

bull Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map

Once the prerequisites are met proceed with the installation of the Centreon Map module

All paths and service names in the following documentation are based on CentOs You may need to adapt these yourown linux distribution

For example lsquousrsharersquo may be lsquousrlocalrsquo and lsquohttpdrsquo may be lsquoapache2rsquo

4MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 2 Prerequisites

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 3: Centreon Map Enaa

ii

CHAPTER 1

Presentation

Centreon Map is an advanced mapping unit which represents user-friendly views of indicators being monitored byCentreon

Thanks to ldquodrill-downrdquo navigation users can create representations without any depth limitation

The most alarming statuses of elements being monitored are provided in real time through customisable views thatcorrespond to each userrsquos requirements business functional technical topological etc

Views can be created very easily (for example with drag-and-drop) and depend on the database of resources configuredin Centreon Views are automatically synchronised and updated thanks to information gathered by Centreon and thescheduler

1

Data is represented graphically and in real time which makes it possible to have one console focusing on monitoringits activities

Definition

bull Screen A single visual representation Each depth level corresponds to a Screen

bull View Set of Screens linked together by a tree structure system

bull Perspective Set of windows linked to internal operation of Centreon Map software

bull Window Perspective component linked to daily software management

bull Object Resource used to create Screens Objects come from the Centreon web interface or from CentreonMap

bull Drop-down menu Menu of actions can be accessed by right clicking the mouse when selecting an Object

bull Scheduler refere to Centreon Engine or Nagios

2MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 1 Presentation

CHAPTER 2

Prerequisites

21 Client

Centreon Map Version Supported Java versions Minimum Update Maximum Updatelt 36 16 17 0 25gt= 36 16 17 25 71gt= 36 18 40 40

The update version limitation applies only to Java Web Start launching The desktop client works well with any Java6 7 and 8 JVM version

22 Server

Softwares Minimum versionCentreon 25xNagios or Centreon Engine 3x or 1x

23 PHP

PHP version Required modules and softwareslt 53 Zend Optimizer php-mcrypt php-xml php-xml-writergt= 53 Zend Guard Loader php-mcrypt php-xml php-xml-writer

24 Centreon

The Centreon Map maintenance and support does not include the maintenance and support of Centreon andorNagios It is the system administratorrsquos responsibility to ensure that the Centreon amp Nagios system works correctlywhen installing Centreon Map extension

In order to fully benefit from the use of the Centreon Map module here is a non-exhaustive list of properties thatCentreon amp Nagios must have

bull Centreon installed and operational

bull No or little latency with Nagios Centreon Engine

3

bull Activation collection and presentation of RRDTool performance graphs in Centreon

bull No gap holes within the Centreon performance graphs

bull Nagios Centreon Engine logging

bull Operational downtime scheduling and comment submit

bull Operational notification system

bull Definition of monitoring indicators (hostsservices) in Centreon

bull MySQL database correctly configured

bull Operational and stable Linux Unix system

bull Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map

Once the prerequisites are met proceed with the installation of the Centreon Map module

All paths and service names in the following documentation are based on CentOs You may need to adapt these yourown linux distribution

For example lsquousrsharersquo may be lsquousrlocalrsquo and lsquohttpdrsquo may be lsquoapache2rsquo

4MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 2 Prerequisites

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 4: Centreon Map Enaa

CHAPTER 1

Presentation

Centreon Map is an advanced mapping unit which represents user-friendly views of indicators being monitored byCentreon

Thanks to ldquodrill-downrdquo navigation users can create representations without any depth limitation

The most alarming statuses of elements being monitored are provided in real time through customisable views thatcorrespond to each userrsquos requirements business functional technical topological etc

Views can be created very easily (for example with drag-and-drop) and depend on the database of resources configuredin Centreon Views are automatically synchronised and updated thanks to information gathered by Centreon and thescheduler

1

Data is represented graphically and in real time which makes it possible to have one console focusing on monitoringits activities

Definition

bull Screen A single visual representation Each depth level corresponds to a Screen

bull View Set of Screens linked together by a tree structure system

bull Perspective Set of windows linked to internal operation of Centreon Map software

bull Window Perspective component linked to daily software management

bull Object Resource used to create Screens Objects come from the Centreon web interface or from CentreonMap

bull Drop-down menu Menu of actions can be accessed by right clicking the mouse when selecting an Object

bull Scheduler refere to Centreon Engine or Nagios

2MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 1 Presentation

CHAPTER 2

Prerequisites

21 Client

Centreon Map Version Supported Java versions Minimum Update Maximum Updatelt 36 16 17 0 25gt= 36 16 17 25 71gt= 36 18 40 40

The update version limitation applies only to Java Web Start launching The desktop client works well with any Java6 7 and 8 JVM version

22 Server

Softwares Minimum versionCentreon 25xNagios or Centreon Engine 3x or 1x

23 PHP

PHP version Required modules and softwareslt 53 Zend Optimizer php-mcrypt php-xml php-xml-writergt= 53 Zend Guard Loader php-mcrypt php-xml php-xml-writer

24 Centreon

The Centreon Map maintenance and support does not include the maintenance and support of Centreon andorNagios It is the system administratorrsquos responsibility to ensure that the Centreon amp Nagios system works correctlywhen installing Centreon Map extension

In order to fully benefit from the use of the Centreon Map module here is a non-exhaustive list of properties thatCentreon amp Nagios must have

bull Centreon installed and operational

bull No or little latency with Nagios Centreon Engine

3

bull Activation collection and presentation of RRDTool performance graphs in Centreon

bull No gap holes within the Centreon performance graphs

bull Nagios Centreon Engine logging

bull Operational downtime scheduling and comment submit

bull Operational notification system

bull Definition of monitoring indicators (hostsservices) in Centreon

bull MySQL database correctly configured

bull Operational and stable Linux Unix system

bull Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map

Once the prerequisites are met proceed with the installation of the Centreon Map module

All paths and service names in the following documentation are based on CentOs You may need to adapt these yourown linux distribution

For example lsquousrsharersquo may be lsquousrlocalrsquo and lsquohttpdrsquo may be lsquoapache2rsquo

4MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 2 Prerequisites

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 5: Centreon Map Enaa

Data is represented graphically and in real time which makes it possible to have one console focusing on monitoringits activities

Definition

bull Screen A single visual representation Each depth level corresponds to a Screen

bull View Set of Screens linked together by a tree structure system

bull Perspective Set of windows linked to internal operation of Centreon Map software

bull Window Perspective component linked to daily software management

bull Object Resource used to create Screens Objects come from the Centreon web interface or from CentreonMap

bull Drop-down menu Menu of actions can be accessed by right clicking the mouse when selecting an Object

bull Scheduler refere to Centreon Engine or Nagios

2MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 1 Presentation

CHAPTER 2

Prerequisites

21 Client

Centreon Map Version Supported Java versions Minimum Update Maximum Updatelt 36 16 17 0 25gt= 36 16 17 25 71gt= 36 18 40 40

The update version limitation applies only to Java Web Start launching The desktop client works well with any Java6 7 and 8 JVM version

22 Server

Softwares Minimum versionCentreon 25xNagios or Centreon Engine 3x or 1x

23 PHP

PHP version Required modules and softwareslt 53 Zend Optimizer php-mcrypt php-xml php-xml-writergt= 53 Zend Guard Loader php-mcrypt php-xml php-xml-writer

24 Centreon

The Centreon Map maintenance and support does not include the maintenance and support of Centreon andorNagios It is the system administratorrsquos responsibility to ensure that the Centreon amp Nagios system works correctlywhen installing Centreon Map extension

In order to fully benefit from the use of the Centreon Map module here is a non-exhaustive list of properties thatCentreon amp Nagios must have

bull Centreon installed and operational

bull No or little latency with Nagios Centreon Engine

3

bull Activation collection and presentation of RRDTool performance graphs in Centreon

bull No gap holes within the Centreon performance graphs

bull Nagios Centreon Engine logging

bull Operational downtime scheduling and comment submit

bull Operational notification system

bull Definition of monitoring indicators (hostsservices) in Centreon

bull MySQL database correctly configured

bull Operational and stable Linux Unix system

bull Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map

Once the prerequisites are met proceed with the installation of the Centreon Map module

All paths and service names in the following documentation are based on CentOs You may need to adapt these yourown linux distribution

For example lsquousrsharersquo may be lsquousrlocalrsquo and lsquohttpdrsquo may be lsquoapache2rsquo

4MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 2 Prerequisites

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 6: Centreon Map Enaa

CHAPTER 2

Prerequisites

21 Client

Centreon Map Version Supported Java versions Minimum Update Maximum Updatelt 36 16 17 0 25gt= 36 16 17 25 71gt= 36 18 40 40

The update version limitation applies only to Java Web Start launching The desktop client works well with any Java6 7 and 8 JVM version

22 Server

Softwares Minimum versionCentreon 25xNagios or Centreon Engine 3x or 1x

23 PHP

PHP version Required modules and softwareslt 53 Zend Optimizer php-mcrypt php-xml php-xml-writergt= 53 Zend Guard Loader php-mcrypt php-xml php-xml-writer

24 Centreon

The Centreon Map maintenance and support does not include the maintenance and support of Centreon andorNagios It is the system administratorrsquos responsibility to ensure that the Centreon amp Nagios system works correctlywhen installing Centreon Map extension

In order to fully benefit from the use of the Centreon Map module here is a non-exhaustive list of properties thatCentreon amp Nagios must have

bull Centreon installed and operational

bull No or little latency with Nagios Centreon Engine

3

bull Activation collection and presentation of RRDTool performance graphs in Centreon

bull No gap holes within the Centreon performance graphs

bull Nagios Centreon Engine logging

bull Operational downtime scheduling and comment submit

bull Operational notification system

bull Definition of monitoring indicators (hostsservices) in Centreon

bull MySQL database correctly configured

bull Operational and stable Linux Unix system

bull Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map

Once the prerequisites are met proceed with the installation of the Centreon Map module

All paths and service names in the following documentation are based on CentOs You may need to adapt these yourown linux distribution

For example lsquousrsharersquo may be lsquousrlocalrsquo and lsquohttpdrsquo may be lsquoapache2rsquo

4MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 2 Prerequisites

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 7: Centreon Map Enaa

bull Activation collection and presentation of RRDTool performance graphs in Centreon

bull No gap holes within the Centreon performance graphs

bull Nagios Centreon Engine logging

bull Operational downtime scheduling and comment submit

bull Operational notification system

bull Definition of monitoring indicators (hostsservices) in Centreon

bull MySQL database correctly configured

bull Operational and stable Linux Unix system

bull Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map

Once the prerequisites are met proceed with the installation of the Centreon Map module

All paths and service names in the following documentation are based on CentOs You may need to adapt these yourown linux distribution

For example lsquousrsharersquo may be lsquousrlocalrsquo and lsquohttpdrsquo may be lsquoapache2rsquo

4MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 2 Prerequisites

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 8: Centreon Map Enaa

CHAPTER 3

Install

31 Install for Centreon enterprise server

MERETHIS also provides repository files for CES 2x and CES 3x respectively based on CentOs 5 and CentOs 6

Add the url of the repository and install Centreon Map

cd etcyumreposd wget httpurl-to-centreon-map-repositoryrepo yum install centreon-map-server

32 Package install

Several packages are provided by MERETHIS and are available on the download Web platform Each version hastwo different packages depending on the version of PHP 5x or 53+ For instance centreon-map-server-370-php5targz

Follow the procedure under root privileges

Uncompress the package and execute the installation script

tar zxf centreon-map-server-370-php5targz cd centreon-map-server-370-php5 installsh

Specify the path that contains the Centreon configuration files Usually lsquoetccentreonrsquo and press ldquoEnterrdquo to submit

Specify the phpini file path Usually lsquoetcrsquo and press ldquoEnterrdquo to submit and finish the installation

Since version 37 if these 2 files are located on default locations no action will be needed

33 License

A license has been provided to you by MERETHIS

The filename is ldquomerethis_liczlrdquo Keep this file as it is essential for the execution of Centreon Map

Copy this file in the license directory of the module then reload the web server service

cp merethis_liczl usrsharecentreonwwwmodulescentreon-map-serverlicense service httpd reload

5

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 9: Centreon Map Enaa

Whilst you can also upload the licence file from Centreon web interface you will still need to reload the httpd service

34 Web install

The rest of the installation of the module is achieved through the Centreon Web user interface

Navigate to the module management page Administration gt Extensions

Click on the installation icon of the ldquocentreon-map-serverrdquo module

On the new page click on ldquoInstall Modulerdquo

The module is now installed

6MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 3 Install

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 10: Centreon Map Enaa

CHAPTER 4

Update

To upgrade your module simply apply the same procedure as with the installation process

Follow the installation sequence the final step is slightly different for you will have to click on the Upgrade icon

Clicking on the ldquoUpgraderdquo will perform an update to the module

The update Centreon Map is incremental you may need to do this several times

7

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 11: Centreon Map Enaa

8MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 4 Update

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 12: Centreon Map Enaa

CHAPTER 5

Uninstall

In order to uninstall the Centreon Map module navigate in the Centreon interface to the module management pageAdministration gt Extensions

Click on the uninstall icon

A confirmation window will appear click on ldquoOKrdquo to confirm the uninstall of the module

Note that the uninstall of the Centreon Map module will result in the removal of all data related to the moduleand its components (Views Screens)

Lost data cannot be restored unless a database backup has been made

This procedure is not covered by the maintenance and support of the Centreon Map software

9

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 13: Centreon Map Enaa

10MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 5 Uninstall

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 14: Centreon Map Enaa

CHAPTER 6

User guide

61 Main Concepts

611 Centreon Map operation

Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manip-ulate monitoring-events By offering users a wide variety of technical and operational components it is possible toreach a very detailed presentation level that is adapted to various cases of use

bull Network views

bull Business views

bull Geographic views

bull Office plan

bull etc

Once the first Screens and Views have been created it is recommended that you customize the software preferenceoptions before proceeding Colours sounds and pop-ups etc and various other user settings are all beneficial for aproductive user-friendly environment

612 Used objects

Centreon Map integrates all monitoring Objects defined in the Centreon web interface

bull ldquoHostrdquo objects

bull ldquoServicerdquo objects

bull ldquoHost grouprdquo objects

bull ldquoService grouprdquo objects

bull ldquoMeta servicerdquo objects

bull ldquoBusiness Activityrdquo objects (Centreon BAM)

bull ldquoKPIrdquo objects Business Activities component (Centreon BAM)

We shall introduce new Objects that are specific to Centreon Map

bull ldquoImagerdquo ldquoshaperdquo and ldquotextrdquo objects for decorating Screens with visual elements

bull ldquoContainerrdquo objects elements for arbitrarily gathering other Objects

11

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 15: Centreon Map Enaa

bull ldquoLinkrdquo objects for creating Screens with logical or physical links between Objects

bull ldquoLegendrdquo objects which allow the user to be written on the code being used

All Objects except for images shapes texts links legends and shapes will have status information their own statusthat comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregatingchild states

This system makes it possible to move step-by-step in real time to quickly identify the elements at fault This procedureis known as ldquoDrilldownrdquo

62 Licence system

Centreon Map has 2 licence types ldquoadministrator licenserdquo and ldquouser licenserdquo

The terms ldquouser slotrdquo and ldquoadmin slotrdquo will be used within this document

621 User license

The user slots only allow view manipulation as opposed to administration

622 Administrator license

The admin slot permits all possible actions in Centreon Map

Actions are always subject to ACL even with an admin slot

The Centreon administrator can grant the ldquoCentreon Maprdquo admin rights and manage their ACL

The Centreon administrators are automatically Centreon Map administrators

12MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 16: Centreon Map Enaa

63 Login screen

When launching the application the login screen appears It allows you to choose a connection profile Centreon Mapand connect to the desired server

The login screen can be moved by drag and drop

If this screen does not appear it is necessary to verify the installation of the Java virtual machine

631 Profiles management form

A connection profile contains the information needed to connect to a server Centreon Map ie

bull A server represented by a name consisting of an address a port URL and whose connection can be madesecurely with SSL

bull (Optional) A named proxy having an address and a port and optional authorisation credentials a username andpassword

bull A delay that is the status refresh rate for objects displayed in the client Centreon Map

bull A Centreon login username and password

The Profile management form enables the creation and management of connection profiles and their relevant informa-tion It is accessible via the button to the right of the list of profiles

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

13

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 17: Centreon Map Enaa

It is possible to store the configuration of different connection profiles

Stored passwords are secured (Centreon and proxy) via the Blowfish algorithm encryption on the client workstation

List lsquoProfilesrsquo presents all the saved profiles The button to the right of this list allows upon confirmation the deletionof the selected profile

List lsquoServersrsquo shows the different existing servers Servers can be configured via a dedicated form provided madeavailable by clicking on the button next to the list A server must be selected in order to create a new profile

List lsquoProxiesrsquo displays all available proxies and the button to the right of the list opens the proxy management formIn is not necessary to select a proxy when creating a new profile

The field lsquoRefresh Timersquo is the interval in seconds between each object status update in the current view A numericvalue greater than 0 is required by default 60 seconds

Finally the fields lsquoLoginrsquo and lsquoPasswordrsquo are the Centreon login and password they are optional in the profile defini-tion However if they are not entered they must be manually typed at each connection

The label of a profile is automatically generated as

bull lsquoLogin server namersquo or

bull lsquoLogin server name proxy namersquo

14MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 18: Centreon Map Enaa

632 Servers management form

List lsquoServersrsquo presents all user-created servers The button to the right of the list after confirmation deletes theselected server

The server name is the label under which it will appear in different lists It is also displayed in the title of the mainwindow Centreon Map

In the lsquoAddressrsquo field simply enter the IP address or DNS name of the web Centreon server

Example ldquo1921681240rdquo or ldquomyservercomrdquo

Do not enter additional information about the protocol in this field (http )

Field lsquoPortrsquo is the connection port to the server it is usually port 80 for regular connections (HTTP) or 443 for a secureconnection (HTTPS) These two default values can be overridden

The field lsquoURLrsquo is the additional address to refer to the web directory Centreon

It is usually accessible via ldquocentreonrdquo or ldquordquo but can be customized by the administrator below

Example Centreon available at this address ldquohttpmonservercomcentreonrdquo the URL will be ldquocentreonrdquo Ex-ample Centreon available at this address ldquohttpmonservercomrdquo the URL will be ldquordquo

The lsquoSecure connectionrsquo enables the transmission of encrypted data over SSL (HTTPS) this option changes the defaultvalue of the field lsquoPortrsquo

63 Login screenMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

15

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 19: Centreon Map Enaa

633 Proxys management form

List lsquoProxiesrsquo presents all user-created proxies The button to the right of this list upon confirmation deletes theselected proxy

The proxy name is the label under which it will appear in different lists

In the lsquoAddressrsquo field enter the IP address or DNS name of the proxy address

Example ldquo1921681250rdquo or ldquomyproxycomrdquo

Do not enter any additional information on the protocol in this field ( http )

The proxy definition files such as ldquoproxypacrdquo are not supported in Centreon Map

Field lsquoPortrsquo is the connection port to the proxy it is usually port 3128 the default value which can be modified ifnecessary

The lsquoAuthenticationrsquo option enables user-entry for lsquoLoginrsquo and lsquoPasswordrsquo fields for proxy connections

The two proxy fields lsquoLoginrsquo and lsquoPassword must be explicitly set by the administrator and are distinct from Centreon

The two checkboxes allow to choose for wich connections the proxy will be used to the server Centreon Map andorto MapBox that needs acces to the Internet

16MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 20: Centreon Map Enaa

64 View Selection Perspective

The view selection perspective allows users using the administrator slot to create new views and delete them

Opening a view provides access to the monitoring perspective

There is a wide choice of parameters relating to visualization and access rights for views These options are config-urable from the Centreon web interface and are detailed later in this manual

Every view has a tooltip displaying all user rights of that view depending on the configuration of the ACL defined inCentreon and the slot used

641 Menus and toolbars

Main menu

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

17

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 21: Centreon Map Enaa

Action DescriptionDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

ldquoActionrdquo menu

Action DescriptionCentreon Map History Opens Centreon Map logs windowRefresh view list Refreshes views listCreate a new view Opens the view creation dialogImport latlong data imports latlong data from a CSV fileFull screen Activates full screen ( press F11 to deactivate it)

rdquordquo menu

Action DescriptionAbout Open the lsquoAboutrsquo dialog

Toolbar and search bar

The toolbar provides quick access to the main functions

Action DescriptionDisconnect Hides application window and displays login screenCreate a new view Opens the view creation dialogRefresh view list Refreshes views listFull screen Activates full screen ( press F11 to deactivate it)Use admin slot Toggles from one slot type to another

The search bar preceded by the label ldquoSearch rdquo filters out all views that do not contain the entered text

18MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 22: Centreon Map Enaa

Context menu

A right click on any picture displayed in the list will cause a context menu to show

Action DescriptionDisplay view Opens the monitoring perspective and displays the selected viewEdit Opens the view creation dialog filled with selected view dataDelete Deletes the selected viewCreate launcher file Opens the launcher file creation dialog

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

19

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 23: Centreon Map Enaa

View creation dialog

This window allows the creation of a new view The user must enter the view name to create it He can also provide aview description and select an icon from a predefined list

This window can also be used to edit the details of an existing view in which case these three fields are automaticallypre-filled with information from the selected view

Note these features are only available from the administrator slot

20MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 24: Centreon Map Enaa

Launcher file creation dialog

A launcher file holds on the local workstation login information for the current server and the selected view

Centreon Map uses information found in this file to connect to the server and open the user-selected view

More information concerning this feature is detailed in the life-cycle section

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

21

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 25: Centreon Map Enaa

About dialog

The ldquoAboutrdquo dialog displays the current version of the client and the list of contributors in alphabetical order

It also displays the installation details ie all components used produced by Merethis or from the Eclipse community

642 Import latlong data

Since version 36 Centreon Map has a new feature geolocation This displays the Centreon resources on a mapaccording to their latlong position It will be detailed in the next chapter

In this ldquoview selection perspectiverdquo it is possible to import a CSV file to associate geographical positions to Centreonresources

The CSV file format should have at least 5 columns in the following order additional columns are ignored

resource_typeresource_nameservice_namelatitudelongitude

bull The resource type can be host hostgroup service servicegroup metaservice bam

bull The resource name must be identical to the name configured in Centreon

bull The service name must be identical to the name configured in Centreon this column is used for only for servicesand may otherwise be empty

bull Latitude is a valid decimal number -90 to 90

bull Longitude is a valid decimal number -180 and 180

Centreon Map validates the imported data all errors are presented to the user with their line number

22MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 26: Centreon Map Enaa

Once the import is successfully completed the user can add imported Centreon resources to the view of his choice

64 View Selection PerspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

23

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 27: Centreon Map Enaa

65 Monitoring perspective

651 Workspace

This screenshot shows the monitoring perspective This is the main perspective in which the majority of actions andmanipulations are made

These actions are available via various means including the main menu the main toolbar and the palette which havebeen highlighted in this screenshot

Toolbars are provided for manipulating window resources such as the small-button filtering toolbar for the lsquoExplorerrsquowindow and finally right-click context menus for most application tool elements

At initial opening of the view the perspective will display the default view configuration that depends on the userprofile

bull The upper left area has a single window called lsquoExplorerrsquo which shows a tree representation of the current viewThis window is available for all users however some actions are restricted to the administrator

bull The bottom left area called lsquoResourcesrsquo is only available to the administrator Windows tabbed in this area display all resources configured within Centreon ie

ndash Hosts and Hosts groups in two separate views

ndash Meta-services and Service groups in two separate views

ndash Centreon BAM in its own view and finally

ndash The images available in Centreon

bull The main viewing area features lsquoscreensrsquo also known as lsquoeditorsrsquo these are components that enable the creationand display of maps and views in Centreon Map This main viewing area can be personalized and subdividedas required There are 4 different types of editors these will be described in more detail further on

24MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 28: Centreon Map Enaa

There are two other screen viewing areas they appear on this screenshot but are not displayed by default in theworkspace

bull ThersquoPreviewrsquo area comprises the following windows

ndash lsquoOutlinersquo which offers an overview of the active editor and simplifies navigation amongst the mainviews

ndash lsquoDowntimesrsquo and lsquoAcknowledgedrsquo highlight the resources that are either in downtime or acknowl-edged state

bull Finally the lsquoSummaryrsquo area has a set of windows that display an overall collective view of information

ndash The subwindow lsquoCentreon Map Historyrsquo displays important events in the current session

ndash The subwindow lsquoProblematic elementsrsquo presents a list of all objects whose status is not OK

ndash The subwindow lsquoPollersrsquo shows all pollers configured in Centreon their states and particular infor-mation

All these areas are default settings that may be freely customized

Each window can be closed and re-opened via a special component later described in this document

Windows can be displaced added to an existing zone or establish an independent zone at any desired location Todo this simply click the title of the view hold down the mousebutton and drag the window the application proposesvarious drop locations with dotted lines The child windows can also be dragged from the main window into a separatewindow

Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window

Lastly each zone can be resized to optimise the the display of each composing subwindow

The customized workspace (positions dimensions etc) is implicitly saved on the following events

bull Refresh the workspace

bull Display of the preferences

bull Return to the list of views

bull Logout

bull Application closure

This configuration is stored on a local file It is associated with the current user account the server and the currentview

This enables each user to tailor his own independent working environment for each different machine

The workspace conforms to this user-customized configuration upon opening of the monitoring perspective

The is a facility to reset the configuration back to factory settings

652 Main menus

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

25

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 29: Centreon Map Enaa

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveDisconnect Hides application window and displays login screenExit Closes application Centreon Map and all connections to Centreon server

Action DescriptionRefresh status Refreshes the status of the objects of the current viewRefresh everything Refreshes all the data of the objects of the current viewTabs rotation Toggles the tabs rotationFull screen Activates full screen to desactivates it press F11Restore perspective Restores windows and default positions of the perspective

Action DescriptionPreferences Displays the preferences dialog

653 Toolbars

The main toolbar is comprises two parts The first part on the left and detailed below is common to the wholeperspective and sports global features

Action DescriptionBack to view selector Saves the workspace state and returns to the view selection perspectiveWindows management Opens the windows manager this feature is detailed further onFull screen Activates full screen to deactivate it press F11Refresh status Refreshes the status of the objects in the current viewRefresh everything Refreshes all the data of the objects in the current viewTabs rotation Toggles the tabs rotationOpen problematic elements window Quick display of the list of problematic elements

The second is context-specific and depends on the selected view open in the workspace

26MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 30: Centreon Map Enaa

Action DescriptionZoom + Zoom on the current screenZoom - De-zoom on the current screenZoom levels Specifies the zoom level of the current screenExport the screen Exports the content of the current screen as an imagePrint the screen Prints the content of the current screenShow hide text Shows Hides the objects label in the current screenEnable disable tooltip Shows Hides tooltips in the current screenAutomatic order Show Hide info balloons activated when the mouse hovers over an itemShow hide grid Displays the grid and the lsquomagneticrsquo positioning modeAdd a legend Displays a legend of load link colorsOpen parent Displays the parent object of the editorPrevious Displays the previous object of the current screenrsquos navigation historyNext Displays the next object of the current screenrsquos navigation historySave position In geographic mode saves the current zoom level and lat long positionRestore position In geographic mode restores the saved zoom level and lat long position

Each objectrsquos zoom settings label display and automatic positioning are preserved on the server

Tooltips and grid parameters are stored locally along with the workspace state

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

27

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 31: Centreon Map Enaa

654 Context menus

Most application items presented have right-click context menus

Wherever an object is located the context menu defines the available actions for its particular state

The screenshot above shows the menu in its entirety in order to present all functions accessible through it

The first 9 menuitems and the 17th menuitem ldquoCreate a Shortcutrdquo are for building and navigating the workspace

The following 3 menuitems are content-editing actions

lsquoAcknowledgersquorsquoDowntimersquo and lsquostatus checkingrsquo are specific monitoring actions these originate from Nagios and arenot detailed here

The last 3 menuitems facilitate access to the supervised Centreon resource

28MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 32: Centreon Map Enaa

Action DescriptionOpen in new screen Displays the selected item in a new edition screenOpen in the same screen Displays the selected item in the current screen or opens a new oneOpen in a new informationscreen

Displays the tooltip of the selected item in a new dedicated screen

Open in the same informationscreen

Displays the tooltip of the selected item in its dedicated screen or opens a newone

Open in a new detailed tab Displays the selected item in a new lsquoDetailsrsquo windowOpen in the current detailed tab Displays the selected item in the current lsquoDetailsrsquo window or opens a new oneDisplay relations in new editor Shows the relationships of the selected item in a new dedicated screenDisplay relations in currenteditor

Shows the relationships of the selected item in its dedicated screen or opens anew one

Open log Shows a new lsquoLogsrsquo window corresponding to the selected itemAdd a container Creates a container with the selected item as parentRename Renames the selected itemDelete Removes the selected itemAcknowledgement Takes into account the status of the selected itemDowntime Declares a downtime for the selected itemStatus check Performs an immediate or scheduled check for the status of the selected itemChange style Changes the style of the selected itemCreate a shortcut Creates a shortcut to the selected itemRDP Client Opens a RDP command prompt to the selected serverTelnet console Opens a telnet console to the selected serverSSH Console Opens an SSH console to the selected server

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

29

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 33: Centreon Map Enaa

655 Windows

Explorer window

In the workspace the explorer window shows all the items in a tree-structured view

The root element is the view itself its children are the various user-added elements For clarity services and unsuper-vised elements (shapes images links etc) do not appear in this list

An option permits the display of the services of each host Warning this can be the cause of delay when views containthousands of elements

This window has two applicable ways of being filtered to facilitate the view of desired items

bull Filter by state the colored knobs correspond to the default state colors

When a knob is deselected all tree items whose status is that of the knob will be hidden By default all knobs areselected and therefore all items are displayed Filter by label using the text field at the top of the tree When a stringis entered only the elements whose label match are displayed (For convenience this search field is case-insensitive )

Both filters can be combined for greater precision in the selection of items

30MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 34: Centreon Map Enaa

In this window as is the case with most of the components from the monitoring perspective a context menu is availableby right-clicking on the items presented This menu will be detailed later in this document

Double-clicking on a tree item opens the selected item in the current screen displaying the children and other detailsnot displayed in the tree (such as links shapes and images)

Mini-map window

The mini-map shows an overview of the current screen

It offers an overview of its contents and displays the states of the elements in real time as the screen

It facilitates the navigation of elements particularly with very large screens using a user-defined blue frame to limitthe area of interest

Acknowledgements and Downtime windows

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

31

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 35: Centreon Map Enaa

Windows lsquoAcknowledgedrsquo and lsquoDowntimersquo present all lsquotaken into accountrsquo and lsquodowntimersquo elements of the currentview regardless of their hierarchical level

Warning only resources in the current view appear in these windows

Resources windows

32MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 36: Centreon Map Enaa

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

33

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 37: Centreon Map Enaa

Resources windows display all objects monitored by Centreon

By default they are piled in the bottom left corner of the workspace as shown earlier in the document Each windowhandles a specific object type

bull The hosts

34MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 38: Centreon Map Enaa

bull The host groups

bull The service groups

bull Meta-services

bull The Centreon Business Activity Monitoring (BAM)

These windows are only available to administrator-slot users because they entail the creation of views

To create a corresponding Centreon Map object simply drag any of these resources into either the edition screen orExplorer window

These created Centreon Map objects display Centreon information such as status as well as additional informationspecific to Centreon Map including icon position and inherited status

Such objects appear in the corresponding screen and in the tree view

The resource windows have a filter similar to the explorer window the search masks elements whose label does notcontain the search string

This behavior is similar in all Centreon Map and needs no further introduction

The hosts window however has an additional search feature a button by the search field toogles whether the searchtargets the name or IP address (Otherwise all resource windows use the same configurable search component)

Beside the standard search facility there is a mini-tree button which hides all elements in the tree view already presentin the main current view

On the righthand side of the mini-tree button the mini-tree button a yellow button to refresh the windowrsquos contents(Note the contents of these windows cannot be changed after a restart of the poller)

Images window

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

35

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 39: Centreon Map Enaa

The Images window is part of the resource windows in the sense that it presents objects for creating views

However it differs from other resources windows as it does not have elements monitored by Centreon These imagesare still from the server Centreon and can be managed via this interface

In addition it is the only window resource whose content can be modified via Centreon Map Indeed the user canadd images using the Centreon Map client and thus indirectly on Centreon in two different ways

bull The button lsquoAdd an image lsquo displays a dialog box for selecting an image file on the local machine

bull Dragging an image file onto an edition screen view or to the explorer window as a drop target

In both cases the new image is added to the Image window contents and to Centreon server

Centreon Map History window

This window displays the various important Centreon Map events such as logins status changes etc

Problematic elements window

The problematic elements window offers a concise view of all objects whose ldquoown statusrdquo or ldquoinherited statusrdquo is notOK

36MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 40: Centreon Map Enaa

This window also allows you to sort items by columns and features a customizable search component This allows youto select the columns on which the search is performed All elements that do not match the search string are hidden

The same object can appear multiple times in this table if present in different screens This feature allows access tothe different locations of the object

Warning only resources in the current view appear in this window

Details window

The lsquoDetailsrsquo window is a dynamic the contents depend on the element associated with the window This window canbe opened by double-clicking a host object or via the context menu of most Centreon Map objects

It presents in detail the children of the selected item

This window has essentially the same search and sort functions as the ldquoproblematic elementsrdquo window

Yet it offers two additional options

bull The button ldquoInclude sub-elementsrdquo represented by little green cubes displays the full object hierarchy in theview

bull The ldquoLock Unlockrdquo button enables the object associated with this window to be changed by merely clickingon a screen or tree

( Whereas the default behavior would require a double-click or access to a context menu)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

37

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 41: Centreon Map Enaa

Logs window

The logs window displays the historical monitoring data created by the scheduler It is available via the menuitemldquoOpen logrdquo from a host or service context menu

The log entries are categorized and displayed in tabs The first of these is a flat list of all entries regardless of category

This window has the same options ldquoInclude sub-elementsrdquo and ldquoLock Unlockrdquo as the window details

Windows manager

The windows manager enables the opening and closing of context-free windows in the workspace (These are viewsand windows that are not bound to any particular selected object)

38MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 42: Centreon Map Enaa

Some windows however are not context-free windows but rather contextual such are lsquoDetailsrsquo and lsquoLogsrsquo windowsThese refer to a selected object and are outside of the window managerrsquos sphere of control

When displaying the windows manager only the windows open in the workspace appear checked When the win-dows manager dialog box is validated the unchecked windows are closed the checked windows opened each at theirprevious location

656 The screen (editors)

View edition screen

The Editing Screen view is the central component of the application This is the graphical component that providesthe most thorough and precise monitoring information

Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and or inherited status

The central part is the elementrsquos own status the surrounding circle being its inherited status This provides a succinctview of an objects status and that of its children

In addition it is possible to navigate through the objects on the edition screen

bull Double-click to enter an element containing children

bull Using the lsquoParentrsquo button to go back one level in the tree

Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the hostlsquodummyrsquo in the previous screenshot

This operation can be performed by the interface Centreon

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

39

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 43: Centreon Map Enaa

When the mouse hovers an icon the application displays a contextual tooltip which presents all the informationavailable for this item The content of the tooltip differs depending on the selected element

(The above screenshot shows the tooltip for the host lsquoUNREACHABLErsquo)

The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globallyvia the ldquoPreferencesrdquo module detailed in this manual

The Edition screen also provides a range of features

Tools are available by clicking the icon in the palette selecting a tool changes the cursor icon and the correspondingaction available on the screen

The palette accessible by administrator-slot users only is located on the right-hand side of the screen otherwise bydefault it is hidden

Action DescriptionSimple selection Allows to select any item on the screen and move it by drag dropMultiple selection Allows to select a group of elementsRectangle Ellipse Adds the corresponding shape to the screenText Adds an editable text to the screen (font size and color are customizable)Basic link Creates a simple link between two elementsStatus link Creates a status link between two elementsLoad link Creates a load link between two elementsDisconnection Deletes a link between two elementsLink template Creates a link from a predefined template

Shapes abstract individual objects into a single logical group on the screen

Since version 34 of Centreon Map shapes take on the color of the status of the most critical sub-element Thevarious options available for shapes are available by right-clicking

Relationships screen

Centreon relying on the host dependency configuration allows the scheduler to determine whether a hostis unavailable or inaccessible

As of version 35 of Centreon Map these relations can be viewed by right-clicking on a host with the action ldquoDisplayrelations in new editorrdquo

40MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 44: Centreon Map Enaa

Three different representations exist

bull Radial (host-centered selection)

bull Tree (selected host is the tree-top node)

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

41

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 45: Centreon Map Enaa

bull Spring (hosts are grouped into blocks - rendering may vary from one display to another)

These three rules apply

42MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 46: Centreon Map Enaa

bull Only children of the selected host are displayed

bull The branches where there is no child available (ACL) are automatically dropped

bull If a host of a branch is not accessible (ACL) but its children are available only the host status is displayed

The Relationships perspective shows all host relationships irrespective of the host limitations configured for the viewTherefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows

Geoagraphic screen

Since version 36 of Centreon Map elements can overlay a map using their longlat coordinates

Maps are provided by the means of a third-party mapping service MapBox

Since version 37 the Google Maps mapping service is not supporter anymore

Configure geolocation

Activation of geolocation in Centreon Map requires specific configuration in Centreon Indeed this feature relieson an external mapping service to Centreon Map It is necessary to open a user account with one of these serviceproviders

MapBox free account allows 3000 downloads for free per month Beyond this limit the use of this service costsaround a dollar per 2000 downloads (current prices on March 1st 2014)

The configuration is made on the page Centreon gt Administration gt Extensions gt Centreon Map gt Geolocation

Once the process of opening a MapBox account is finished copy the lsquodefault API access tokenrsquo present on top of theMapBox page into the field lsquoMapBox API access tokenrsquo of the configuration page

At last create a new project in the MapBox interface and copy its ID into the field lsquoMaBox Project tokenrsquo

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

43

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 47: Centreon Map Enaa

Activate geolocalisation

In a standard view edition screen right click on the background open the context menu and select the action ldquoEditrdquoThe following dialog appears and allows had the map ID been configured in Centreon to activate the geographicalmode and enter the longlat coordinates

44MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 48: Centreon Map Enaa

Navigate within a map

Geolocation-enabled the screen background is replaced by a map having the latlong coordinates as the center and azoom level between 1 and 21

Zoom level 1 represents the full world map each successive level focuses on half of the previous view with twice thedetail

Two user actions trigger a request to the mapping service

bull A map relocation this can be done in 2 ways either by a dragdrop of the map or by direct access to a knownlatlong being a saved position or the position of one of the elements on the map

bull change the zoom level using the main toolbar or via the mouse wheel by holding the ldquoctrlrdquo key

Viewpoints

bull The map view is defined by having a particular position and a particular zoom level We shall henceforth referto the this positionzoom pair as being a ldquoviewpointrdquo Centreon maps has an active viewpoint and a defaultviewpoint

ndash The ldquoactive viewpointrdquo determines the area displayed on the screen it is modified for every displacement orzoom change and can be saved as the default viewpoint via the toolbar this viewpoint is never synchronizedbetween clients

ndash The ldquodefault viewpointrdquo establishes the initial coordinate and zoom level view of a map This viewpoint ismaintained on the server and transmitted to other users At any moment the user can revert to the defaultviewpoint via the toolbar

Map Element Positioning Recollect that a Centreon resource can be multiply represented by dragging and droppingthe resource on the map many times

There are two manners to organise such host elements on the map

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

45

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 49: Centreon Map Enaa

bull With resource-defined positions all resource map elements that ascribe to a Centreon resource will be posi-tioned at the resourcersquos coordinates

Editing the resourcesrsquos coordinates will displace all elements as one logical block

bull With element-defined positions host-mapped elements are freely placed on the map - each independent of theother

( Note that this is only possible when the hostrsquos coordinates are NOT defined )

When an object of the current map is selected in either the Explorer window or the problematic elements window thecurrent map is automatically centered to its coordinates This allows instant access to its immediate surroundings

Abstraction As map elements become ubiquitous on the screen it becomes rapidly evident that such need to beabstracted into more manageable constructs Centreon maps provides containers to logically group relatedelements and therefore filter the information from the data shielding the user from irrelevant details As wellas being map elements containers have viewpoints Each container is capable of portraying a viewpoint of themap The containers position as an element on the screen is used as a reference point for its internal viewpoint(A containerrsquos default view and element position are strongly bound concepts - updating the coordinates ofeither updates both) Typically the user will define a containerrsquos viewpoint such that all child elements bewithin scope Containers are also able to embed other containers recursively - this is a powerful paradigm forcomplexity management

[Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the clientrsquosdiscretion Additional costs and fees incurred by a third party service are the full responsibility of the clientMERETHIS cannot be held accountable The Centreon Map license updates and support do not includeprofessional services MapBox and Google Maps Ultimately Merethis cannot be held accountable for anyprofessional technical or financial prejudice due to a total or partial failure of the third party mapping service

The tooltips screen

46MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 50: Centreon Map Enaa

The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner

The above image depicts the service type lsquoPingrsquo as a graph showing the evolution of pings within the monitoringperspective

Depending on the element type this sort of visual representation can be made manifest by double-clicking or using acontext menu

Tabs rotation

In the former screenshot there are 10 tabs grouped into 4 zones Each zone is composed of at least one tabbed screenof which only one can be active at a time

Tab rotation revolves around the zonersquos list of tabbed screens a regular and configurable interval in order to have aglobal vision of the workspace without requiring human intervention

657 The links

The object link type is purely Centreon Map concept it is not supervised object and is only a visual help

A link can be created between any elements in an view edition screen with the exception of text objects

In addition it is possible to create multiple links between two objects They are created modified and deleted usingthe corresponding tools in the palette of the view edition screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

47

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 51: Centreon Map Enaa

There are 3 different types of links used to emphasize different aspects

Basic link

The basic link is used to link elements of the screen without displaying additional monitoring information

These links have configurable properties

bull a type (basic status or load)

bull a name and a description

bull the linersquos width

bull a line type continuous dotted etc

bull a style direct that displays a direct line or indirect with a right angles

bull a color

48MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 52: Centreon Map Enaa

Status link

The status link is a basic link having a fixed system-defined line type style and color whilst able to display the statusof a service

To be associated to a status link a service must be configured for this purpose in Centreon it must be associatedto a category that is associated with this type of link This configuration is established in the Centreon interfaceAdministration gt Extensions gt Centreon Map tab

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

49

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 53: Centreon Map Enaa

The link then displays the status of the configured service

This feature is particularly useful for modeling connectivity between two devices

The load link (unidirectional or bidirectional)

The bi-directional load link similar to the status link has fixed visual link properties

Similar to the status link it is associated with a service but instead displays metrics about the service

50MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 54: Centreon Map Enaa

To be associated with a load link a service must be configured for this purpose in Centreon it must be associated witha category that is associated with this type of link This configuration is done in the Centreon interface Administrationgt Extensions gt Centreon Map tab

The load link models the rate of flow between two devices

Typically it is used to model the state and bandwidth of the network

Since version 35 the load links can be unidirectional and also the user can define what metrics to display what is thecurrent value and what is the max value

658 Warnings

When changing to a critical state an error or any other significant event Centreon Map alerts the user in two ways

bull visual feedback as a colored popup at the bottom right of the screen

bull sound event

Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved

In this example there is a loss of connection between the client and the server the popup appears in red as it is importantinformation a specific sound is also played

659 Preferences

In Centreon Map many features are configurable you can customize the size of icons the colors used to indicatedifferent status etc

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

51

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 55: Centreon Map Enaa

Remote access

These preferences configure various settings of the remote access The above screenshot shows the configurationscreen of the 3 default access protocols

The tab lsquoCustomrsquo configures other actions by associating a name to an executable path and arguments For thispurpose predefined variables are shown in the submenu lsquoInformationsrsquo

52MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 56: Centreon Map Enaa

Drilldown

The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm

The first checkbox lsquoUse simple drilldown optionsrsquo is enabled by default Unchecked it activates the advanced config-uration mode presented by the lower screen

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

53

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 57: Centreon Map Enaa

In advanced mode the user can customize the rules for computing the inherited status of acknowledged or downtimeitems the order of criticality

The two following checkboxes are available in simple mode They determine the exclusion of acknowledged ordowntime resources from the algorithm

The checkbox lsquoDisplay poller-down statusrsquo this refers to a new status specific to Centreon Map This conditionoccurs when a poller is out of order All monitored elements depending on the defective poller enter poller-down state

lsquoUse soft statutes for inherited status when availablersquo lets the algorithm rely on unconfirmed states for inherited state

54MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 58: Centreon Map Enaa

processing This is more efficient but less reliable

The last check box excludes the internal links of a container from the inherited state calculation

Ensuing any change it is necessary to reload the statutes of the view for it to be applied

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

Graphics

This preference page allows the user to customize various visual settings

bull The style determines whether the objects displayed in screens are represented by an icon or a geometric shape

bull The police is for all on-screen text

bull The space between the icons is that used when they are placed automatically

bull blinking allows easier visualization of problematic elements

bull The unit selected is used to display load links

bull lsquoShow services in treersquo will cause services to be displayed in the lsquoExplorerrsquo Note This option can slow-down the processing as it increases the tree items by an order of magnitude

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

55

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 59: Centreon Map Enaa

bull The lsquoRotate delayrsquo determines the time between each tab rotation

This preference page allows the user to apply geometric styles of differing shapes and sizes to items

This preference page allows you to change the shapes and sizes of items for the geometric style

The lower preference page allows the user to pick a geometric shape to represent a discrete state

These settings do not affect the style icon

56MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 60: Centreon Map Enaa

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

57

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 61: Centreon Map Enaa

With the following preferences page the user can customize how an element icon is represented for every discrete stateIn particular this involves setting the color and opacity of the surrounding halo for a given state in a given condition

Finally the color opacity and the relative size displayed depending on each status can also be changed

Warning Incorrect configuration of these options can completely thwart the supervision Be careful

58MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 62: Centreon Map Enaa

Tooltip

On this preference page the tooltip can be disabled for all screens of the current view

Other options such as graph displaying and the period displayed can be set here

Finally the dimensions of the tooltip can also be defined

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

59

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 63: Centreon Map Enaa

Links Templates

This preference page allows you to create link templates

A user-created template has the same properties of the link type on which it is based

Created templates are available in the palette of the view edition screen

When creating a link from the template the link automatically takes on the template-defined properties without furtheruser interaction

When a link template is changed the changes are automatically applied to all links associated with the template

However it is possible to override one or more properties of a link associated with a template Such properties are notaffected by the modification of the template

60MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 64: Centreon Map Enaa

Popup

The popup preferences page addresses the properties of two different popups in Centreon Map

bull The first two forms relate to the warning popup It can be totally disabled or more finely configured to appearonly for certain events The color associated with each event can also be set individually

The lsquoPoller alertrsquo options concern the dialog that appears when a poller connection drops

The addition of the new status lsquoPoller downrsquo deprecates this alert and the above preferences allow you to disable orautomatically close this dialog

65 Monitoring perspectiveMERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

61

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide

Page 65: Centreon Map Enaa

Sounds

Sound settings allow you to choose which sound is to be associated with each state change

62MERETHIS 12 AVENUE RASPAIL FR94290 GENTILLY

Chapter 6 User guide