You are on page 1of 66

Centreon Documentation

Release 3.6.7

Merethis

January 06, 2015

Contents

i

ii .

functional. Thanks to “drill-down” navigation. Views can be created very easily (for example with drag-and-drop) and depend on the database of resources configured in Centreon. Views are automatically synchronised and updated thanks to information gathered by Centreon and the scheduler.CHAPTER 1 Presentation Centreon Map is an advanced mapping unit. 1 . The most alarming statuses of elements being monitored are provided in real time through customisable views that correspond to each user’s requirements: business. technical. which represents user-friendly views of indicators being monitored by Centreon. topological etc. users can create representations without any depth limitation.

• Window: Perspective component linked to daily software management. Each depth level corresponds to a Screen. • View: Set of Screens linked together by a tree structure system.Data is represented graphically and in real time. • Perspective: Set of windows linked to internal operation of Centreon Map software. which makes it possible to have one console focusing on monitoring its activities. • Drop-down menu: Menu of actions can be accessed by right clicking the mouse when selecting an Object. • Scheduler : refere to Centreon Engine or Nagios. Presentation M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . Definition • Screen: A single visual representation. Objects come from the Centreon web interface or from Centreon Map. • Object: Resource used to create Screens. 2 Chapter 1.

The desktop client works well with any Java 6 and 7 JVM version. php-xml. It is the system administrator’s responsibility to ensure that the Centreon & Nagios system works correctly when installing Centreon Map extension.5.7 1.6 Supported Java versions 1. php-xml.6 / 1.3 PHP PHP version < 5. 2.3 Required modules and softwares Zend Optimizer.x 3.6 >= 3. php-xml-writer Zend Guard Loader.1 Client Centreon Map Version < 3. php-mcrypt.CHAPTER 2 Prerequisites 2.6 >= 3. php-xml-writer 2.4 Centreon The Centreon Map maintenance and support does not include the maintenance and support of Centreon and/or Nagios.7 1. here is a non-exhaustive list of properties that Centreon & Nagios must have: • Centreon installed and operational • No or little latency with Nagios / Centreon Engine 3 . In order to fully benefit from the use of the Centreon Map module.8 Minimum Update 0 25 40 Maximum Update 25 71 40 The update version limitation applies only to Java Web Start launching.x 2.6 / 1.3 >= 5.2 Server Softwares Centreon Nagios or Centreon Engine Minimum version 2. php-mcrypt.x or 1.

proceed with the installation of the Centreon Map module. collection and presentation of RRDTool performance graphs in Centreon • No gap holes within the Centreon performance graphs • Nagios / Centreon Engine logging • Operational downtime scheduling and comment submit • Operational notification system • Definition of monitoring indicators (hosts/services) in Centreon • MySQL database correctly configured • Operational and stable Linux / Unix system • Network topology adapted to allow a large bandwith of communications between Centreon and Centreon Map Once the prerequisites are met. All paths and service names in the following documentation are based on CentOs. For example ‘/usr/share’ may be ‘/usr/local’ and ‘httpd’ may be ‘apache2’.• Activation. 4 Chapter 2. You may need to adapt these your own linux distribution. Prerequisites M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .

Add the url of the repository and install Centreon Map : # cd /etc/yum. 5 .2 Package install Several packages are provided by MERETHIS and are available on the download Web platform. Keep this file as it is essential for the execution of Centreon Map. ‘/etc’ and press “Enter” to submit and finish the installation.repos.6. Each version has two different packages.3 License A license has been provided to you by MERETHIS.tar.3+ For instance : centreon-map-server-3. you will still need to reload the httpd service.6.0-php5 # .sh -i Specify the path that contains the Centreon configuration files. Specify the php. The filename is “merethis_lic.x or 5.0php5.zl”.x.1 Install for Centreon enterprise server MERETHIS also provides repository files for CES 2. ‘/etc/centreon’ and press “Enter” to submit.CHAPTER 3 Install 3. Copy this file in the license directory of the module then reload the web server service : # cp merethis_lic.tar.repo # yum install centreon-map-server 3. Follow the procedure under root privileges. Usually. respectively based on CentOs 5 and CentOs 6.0-php5.6.x and CES 3. Uncompress the package and execute the installation script : # tar zxf centreon-map-server-3. Usually.d # wget http://url-to-centreon-map-repository.gz # cd centreon-map-server-3./install. 3.gz. depending on the version of PHP 5.ini file path.zl /usr/share/centreon/www/modules/centreon-map-server/license/ # service httpd reload Whilst you can also upload the licence file from Centreon web interface.

6 Chapter 3. On the new page click on “Install Module”.3. The module is now installed. Install M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . Navigate to the module management page : Administration > Extensions Click on the installation icon of the “centreon-map-server” module.4 Web install The rest of the installation of the module is achieved through the Centreon Web user interface.

simply apply the same procedure as with the installation process. The update Centreon Map is incremental. you may need to do this several times. for you will have to click on the Upgrade icon. 7 . the final step is slightly different.CHAPTER 4 Update To upgrade your module. Clicking on the “Upgrade” will perform an update to the module. Follow the installation sequence.

Update M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .8 Chapter 4.

Lost data cannot be restored unless a database backup has been made.. navigate in the Centreon interface to the module management page Administration > Extensions Click on the uninstall icon.CHAPTER 5 Uninstall In order to uninstall the Centreon Map module. Screens. Note that the uninstall of the Centreon Map module will result in the removal of all data related to the module and its components (Views. This procedure is not covered by the maintenance and support of the Centreon Map software. 9 . A confirmation window will appear.). click on “OK” to confirm the uninstall of the module.

Uninstall M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .10 Chapter 5.

it is possible to reach a very detailed presentation level that is adapted to various cases of use: • Network views • Business views • Geographic views • Office plan • etc. “shape” and “text” objects for decorating Screens with visual elements • “Container” objects.1 Main Concepts 6. Business Activities component (Centreon BAM) We shall introduce new Objects that are specific to Centreon Map.1. sounds and pop-ups etc.1.1 Centreon Map operation Centreon Map enables the user to create customisable Views and Screens making it easier to learn about and manipulate monitoring-events. By offering users a wide variety of technical and operational components.2 Used objects Centreon Map integrates all monitoring Objects defined in the Centreon web interface.CHAPTER 6 User guide 6. Colours. • “Host” objects • “Service” objects • “Host group” objects • “Service group” objects • “Meta service” objects • “Business Activity” objects (Centreon BAM) • “KPI” objects. it is recommended that you customize the software preference options before proceeding. and various other user settings are all beneficial for a productive user-friendly environment. elements for arbitrarily gathering other Objects 11 . 6. Once the first Screens and Views have been created. • “Image”.

2. except for images. 6. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . This procedure is known as “Drilldown”. shapes. texts.2 Licence system Centreon Map has 2 licence types : “administrator license” and “user license”.• “Link” objects for creating Screens with logical or physical links between Objects • “Legend” objects. This system makes it possible to move step-by-step in real time to quickly identify the elements at fault. and shapes will have status information. The Centreon administrators are automatically Centreon Map administrators.2. The terms “user slot” and “admin slot” will be used within this document. The Centreon administrator can grant the “Centreon Map” admin rights and manage their ACL.2 Administrator license The admin slot permits all possible actions in Centreon Map. 6. links. Actions are always subject to ACL. their own status that comes from monitoring and their inherited status specific to Centreon Map that is the product of aggregating child states. 6. which allow the user to be written on the code being used All Objects. legends. 12 Chapter 6.1 User license The user slots only allow view manipulation as opposed to administration. even with an admin slot.

1 Profiles management form A connection profile contains the information needed to connect to a server Centreon Map ie: • A server. URL and whose connection can be made securely. represented by a name. having an address and a port and optional authorisation credentials: a username and password. It is accessible via the button to the right of the list of profiles.6.3. • A Centreon login username and password.3 Login screen When launching the application. The login screen can be moved by drag and drop. • A delay. If this screen does not appear it is necessary to verify the installation of the Java virtual machine. Login screen 13 M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . It allows you to choose a connection profile Centreon Map and connect to the desired server. • (Optional) A named proxy. consisting of an address. 6.3. a port. that is the status refresh rate for objects displayed in the client Centreon Map. The Profile management form enables the creation and management of connection profiles and their relevant information. 6. the login screen appears. with SSL.

they are optional in the profile definition. the deletion of the selected profile. List ‘Proxies’ displays all available proxies and the button to the right of the list opens the proxy management form. Finally the fields ‘Login’ and ‘Password’ are the Centreon login and password. A numeric value greater than 0 is required. upon confirmation. However if they are not entered. by default 60 seconds. Servers can be configured via a dedicated form provided. The button to the right of this list allows. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . The label of a profile is automatically generated as : • ‘Login @ server name’ or • ‘Login @ server name / proxy name’ 14 Chapter 6. they must be manually typed at each connection. made available by clicking on the button next to the list. A server must be selected in order to create a new profile. List ‘Servers’ shows the different existing servers. In is not necessary to select a proxy when creating a new profile. List ‘Profiles’ presents all the saved profiles. The field ‘Refresh Time’ is the interval in seconds between each object status update in the current view.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.

deletes the selected server. Example: Centreon available at this address: “http://mon.2 Servers management form List ‘Servers’ presents all user-created servers.com/”. Login screen 15 M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .168. the URL will be “/centreon/”. It is also displayed in the title of the main window Centreon Map..1. In the ‘Address’ field. Field ‘Port’ is the connection port to the server. The server name is the label under which it will appear in different lists. after confirmation. The field ‘URL’ is the additional address to refer to the web directory Centreon. the URL will be “/”. this option changes the default value of the field ‘Port’.3. The button to the right of the list. It is usually accessible via “/centreon/” or “/” but can be customized by the administrator below : Example: Centreon available at this address: “http://mon. Do not enter additional information about the protocol in this field (http:// .com/centreon/”. The ‘Secure connection’ enables the transmission of encrypted data over SSL (HTTPS).com”. it is usually port 80 for regular connections (HTTP) or 443 for a secure connection (HTTPS).). simply enter the IP address or DNS name of the web Centreon server.server.3.240” or “my. Example: “192.6.server.server. These two default values can be overridden.. 6.

). The proxy name is the label under which it will appear in different lists.pac” are not supported in Centreon Map.com”. The two proxy fields ‘Login’ and ‘Password must be explicitly set by the administrator and are distinct from Centreon.. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .168.3 Proxys management form List ‘Proxies’ presents all user-created proxies.6.250” or “my. Do not enter any additional information on the protocol in this field ( http:// .proxy. it is usually port 3128. deletes the selected proxy. The button to the right of this list. the default value. In the ‘Address’ field. The ‘Authentication’ option enables user-entry for ‘Login’ and ‘Password’ fields for proxy connections. The proxy definition files such as “proxy. which can be modified if necessary. 16 Chapter 6.. Example: “192. upon confirmation.1.3. enter the IP address or DNS name of the proxy address. Field ‘Port’ is the connection port to the proxy.

These options are configurable from the Centreon web interface and are detailed later in this manual.4 View Selection Perspective The view selection perspective allows users. depending on the configuration of the ACL defined in Centreon and the slot used.1 Menus and toolbars Main menu 6. View Selection Perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 17 .4. 6. to create new views and delete them. using the administrator slot.6. Every view has a tooltip displaying all user rights of that view.4. There is a wide choice of parameters relating to visualization and access rights for views. Opening a view provides access to the monitoring perspective.

Action Disconnect Create a new view Refresh view list Full screen Use admin slot Description Hides application window and displays login screen Opens the view creation dialog Refreshes views list Activates full screen ( press F11 to deactivate it) Toggles from one slot type to another The search bar..Action Disconnect Exit Description Hides application window and displays login screen Closes application Centreon Map and all connections to Centreon server “Action” menu Action Centreon Map History Refresh view list Create a new view Import lat/long data Full screen Description Opens Centreon Map logs window Refreshes views list Opens the view creation dialog imports lat/long data from a CSV file Activates full screen ( press F11 to deactivate it) ”?” menu Action About Description Open the ‘About’ dialog Toolbar and search bar The toolbar provides quick access to the main functions..”. preceded by the label “Search . 18 Chapter 6. filters out all views that do not contain the entered text. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .

Action Display view Edit Delete Create launcher file Description Opens the monitoring perspective and displays the selected view Opens the view creation dialog filled with selected view data Deletes the selected view Opens the launcher file creation dialog 6.Context menu A right click on any picture displayed in the list will cause a context menu to show. View Selection Perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 19 .4.

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 a
view 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 automatically
pre-filled with information from the selected view.
Note: these features are only available from the administrator slot.

20

Chapter 6. User guide
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY

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.

6.4. View Selection Perspective
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY

21

About dialog

The “About” 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.

6.4.2 Import lat/long data
Since version 3.6, Centreon Map has a new feature: geolocation. This displays the Centreon resources on a map
according to their lat/long position. It will be detailed in the next chapter.
In this “view selection perspective” it is possible to import a CSV file to associate geographical positions to Centreon
resources.
The CSV file format should have at least 5 columns in the following order, additional columns are ignored:
resource_type,resource_name,service_name,latitude,longitude

• The resource type can be: host, hostgroup, service, servicegroup, metaservice, bam
• The resource name must be identical to the name configured in Centreon
• The service name must be identical to the name configured in Centreon, this column is used for only for services
and may, otherwise, be empty
• Latitude is a valid decimal number -90 to 90
• 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.

22

Chapter 6. User guide
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY

6.4. the user can add imported Centreon resources to the view of his choice. View Selection Perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 23 .Once the import is successfully completed.

This main viewing area can be personalized and subdivided as required. At initial opening of the view. Toolbars are provided for manipulating window resources. and finally – The images available in Centreon. such as the small-button filtering toolbar for the ‘Explorer’ window. these will be described in more detail further on.5. in two separate views – Centreon BAM. which shows a tree representation of the current view. the perspective will display the default view configuration that depends on the user profile : • The upper left area has a single window called ‘Explorer’. which have been highlighted in this screenshot. This window is available for all users however some actions are restricted to the administrator. the main toolbar and the palette. There are 4 different types of editors. These actions are available via various means. these are components that enable the creation and display of maps and views in Centreon Map.6. including the main menu. This is the main perspective in which the majority of actions and manipulations are made. in its own view. 24 Chapter 6.5 Monitoring perspective 6. • The main viewing area features ‘screens’ also known as ‘editors’. called ‘Resources’ is only available to the administrator. Windows tabbed in this area display all reso – Hosts and Hosts groups in two separate views – Meta-services and Service groups.1 Workspace This screenshot shows the monitoring perspective. • The bottom left area. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . and finally right-click context menus for most application tool elements.

the ‘Summary’ area has a set of windows that display an overall collective view of information: – The subwindow ‘Centreon Map History’ displays important events in the current session. added to an existing zone. Lastly.2 Main menus 6.) is implicitly saved on the following events: • Refresh the workspace • Display of the preferences • Return to the list of views • Logout • Application closure This configuration is stored on a local file. hold down the mousebutton and drag the window. It is associated with the current user account. they appear on this screenshot but are not displayed by default in the workspace: • The’Preview’ area comprises the following windows: – ‘Outline’. – The subwindow ‘Problematic elements’ presents a list of all objects whose status is not OK. the server and the current view. the application proposes various drop locations with dotted lines. To do this. This enables each user to tailor his own independent working environment for each different machine.5. The child windows can also be dragged from the main window into a separate window. 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. Each window can be closed and re-opened via a special component later described in this document. • Finally. Windows can be displaced.5. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 25 . their states and particular information.There are two other screen viewing areas. each zone can be resized to optimise the the display of each composing subwindow. The customized workspace (positions. All these areas are default settings that may be freely customized. – ‘Downtimes’ and ‘Acknowledged’ highlight the resources that are either in downtime or acknowledged state. 6. Whilst editor subwindows can be reorganised in their reserved zone they cannot be separated from the main window. – The subwindow ‘Pollers’ shows all pollers configured in Centreon. which offers an overview of the active editor and simplifies navigation amongst the main views. or establish an independent zone at any desired location. simply click the title of the view. etc. dimensions.

to deactivate it. is common to the whole perspective and sports global features.Action Back to view selector Disconnect Exit Action Refresh status Refresh everything Tabs rotation Full screen Restore perspective Action Preferences Description Saves the workspace state and returns to the view selection perspective Hides application window and displays login screen Closes application Centreon Map and all connections to Centreon server Description Refreshes the status of the objects of the current view Refreshes all the data of the objects of the current view Toggles the tabs rotation Activates full screen. press F11 Restores windows and default positions of the perspective Description Displays the preferences dialog 6. to desactivates it. 26 Chapter 6. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . The first part. press F11 Refreshes the status of the objects in the current view Refreshes all the data of the objects in the current view Toggles the tabs rotation Quick display of the list of problematic elements The second is context-specific and depends on the selected view open in the workspace. this feature is detailed further on Activates full screen.5. on the left and detailed below.3 Toolbars The main toolbar is comprises two parts. Action Back to view selector Windows management Full screen Refresh status Refresh everything Tabs rotation Open problematic elements window Description Saves the workspace state and returns to the view selection perspective Opens the windows manager.

Action Zoom + Zoom Zoom levels Export the screen Print the screen Show / hide text Enable / disable tooltip Automatic order Show / hide grid Add a legend Open parent Previous Next Save position Restore position Description Zoom on the current screen De-zoom on the current screen Specifies the zoom level of the current screen Exports the content of the current screen as an image Prints the content of the current screen Shows / Hides the objects label in the current screen Shows / Hides tooltips in the current screen Show / Hide info balloons. restores the saved zoom level and lat / long position Each object’s zoom settings. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 27 . Tooltips and grid parameters are stored locally along with the workspace state. activated when the mouse hovers over an item Displays the grid and the ‘magnetic’ positioning mode Displays a legend of load link colors Displays the parent object of the editor Displays the previous object of the current screen’s navigation history Displays the next object of the current screen’s navigation history In geographic mode. label display and automatic positioning are preserved on the server.5. 6. saves the current zoom level and lat / long position In geographic mode.

“Create a Shortcut”. are for building and navigating the workspace. The screenshot above shows the menu in its entirety in order to present all functions accessible through it.’Downtime’ and ‘status checking’ are specific monitoring actions.6.5. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . The last 3 menuitems facilitate access to the supervised Centreon resource. these originate from Nagios and are not detailed here. The first 9 menuitems and the 17th menuitem. 28 Chapter 6. Wherever an object is located.4 Context menus Most application items presented have right-click context menus. ‘Acknowledge’. the context menu defines the available actions for its particular state. The following 3 menuitems are content-editing actions.

Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 29 .5.Action Open in new screen Open in the same screen Open in a new information screen Open in the same information screen Open in a new detailed tab Open in the current detailed tab Display relations in new editor Display relations in current editor Open log Add a container Rename Delete Acknowledgement Downtime Status check Change style Create a shortcut RDP Client Telnet console SSH Console Description Displays the selected item in a new edition screen Displays the selected item in the current screen or opens a new one Displays the tooltip of the selected item in a new dedicated screen Displays the tooltip of the selected item in its dedicated screen or opens a new one Displays the selected item in a new ‘Details’ window Displays the selected item in the current ‘Details’ window or opens a new one Shows the relationships of the selected item in a new dedicated screen Shows the relationships of the selected item in its dedicated screen or opens a new one Shows a new ‘Logs’ window corresponding to the selected item Creates a container with the selected item as parent Renames the selected item Removes the selected item Takes into account the status of the selected item Declares a downtime for the selected item Performs an immediate or scheduled check for the status of the selected item Changes the style of the selected item Creates a shortcut to the selected item Opens a RDP command prompt to the selected server Opens a telnet console to the selected server Opens an SSH console to the selected server 6.

using the text field at the top of the tree. The root element is the view itself. the colored knobs correspond to the default state colors. Both filters can be combined for greater precision in the selection of items. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .6. When a knob is deselected. (For convenience.5.. the explorer window shows all the items in a tree-structured view. etc. images. this search field is case-insensitive ). 30 Chapter 6. When a string is entered. its children are the various user-added elements. all knobs are selected and therefore all items are displayed. This window has two applicable ways of being filtered to facilitate the view of desired items: • Filter by state. all tree items whose status is that of the knob will be hidden. Warning : this can be the cause of delay when views contain thousands of elements. * Filter by label. By default.) do not appear in this list.5 Windows Explorer window In the workspace. only the elements whose label match are displayed. links. For clarity. services and unsupervised elements (shapes. An option permits the display of the services of each host.

as is the case with most of the components from the monitoring perspective. This menu will be detailed later in this document. using a user-defined blue frame to limit the area of interest. a context menu is available by right-clicking on the items presented. It offers an overview of its contents and displays the states of the elements in real time as the screen. shapes and images). displaying the children and other details not displayed in the tree (such as links. Acknowledgements and Downtime windows 6. Mini-map window The mini-map shows an overview of the current screen.In this window. particularly with very large screens. It facilitates the navigation of elements. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 31 . Double-clicking on a tree item opens the selected item in the current screen.5.

Resources windows 32 Chapter 6.Windows ‘Acknowledged’ and ‘Downtime’ present all ‘taken into account’ and ‘downtime’ elements of the current view regardless of their hierarchical level. Warning: only resources in the current view appear in these windows. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .

6. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 33 .5.

34 Chapter 6. Each window handles a specific object type: • The hosts.Resources windows display all objects monitored by Centreon. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . By default. they are piled in the bottom left corner of the workspace as shown earlier in the document.

(Note: the contents of these windows cannot be changed after a restart of the poller). The hosts window. the search masks elements whose label does not contain the search string. • The Centreon Business Activity Monitoring (BAM) These windows are only available to administrator-slot users because they entail the creation of views. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 35 . all resource windows use the same configurable search component. the mini-tree button. has an additional search feature: a button by the search field toogles whether the search targets the name or IP address. simply drag any of these resources into either the edition screen or Explorer window.) Beside the standard search facility.5.• The host groups. On the righthand side of the mini-tree button. a yellow button to refresh the window’s contents. position. These created Centreon Map objects display Centreon information such as status as well as additional information specific to Centreon Map including icon. and inherited status. The resource windows have a filter: similar to the explorer window. This behavior is similar in all Centreon Map and needs no further introduction. • The service groups. Such objects appear in the corresponding screen and in the tree view. • Meta-services. however. Images window 6. there is a mini-tree button which hides all elements in the tree view already present in the main current view. (Otherwise. To create a corresponding Centreon Map object.

36 Chapter 6. • Dragging an image file onto an edition screen view or to the explorer window as a drop target.The Images window is part of the resource windows in the sense that it presents objects for creating views.. etc. In addition it is the only window resource whose content can be modified via Centreon Map. such as logins. These images are still from the server **Centreon and can be managed via this interface. Problematic elements window The problematic elements window offers a concise view of all objects whose “own status” or “inherited status” is not OK. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . Centreon Map History window This window displays the various important Centreon Map events. However it differs from other resources windows as it does not have elements monitored by Centreon*. Indeed. In both cases. status changes. the new image is added to the Image window contents and to Centreon server. the user can add images using the Centreon Map client and thus indirectly on Centreon in two different ways : • The button ‘Add an image ‘ displays a dialog box for selecting an image file on the local machine.

displays the full object hierarchy in the view. Details window The ‘Details’ window is a dynamic: the contents depend on the element associated with the window. • The “Lock / Unlock” button enables the object associated with this window to be changed by merely clicking on a screen or tree. This window has essentially the same search and sort functions as the “problematic elements” window. This window can be opened by double-clicking a host object or via the context menu of most Centreon Map objects. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 37 . The same object can appear multiple times in this table if present in different screens.This window also allows you to sort items by columns and features a customizable search component.5. Yet it offers two additional options: • The button “Include sub-elements”. All elements that do not match the search string are hidden. This allows you to select the columns on which the search is performed. represented by little green cubes. Warning: only resources in the current view appear in this window. It presents in detail the children of the selected item. ( Whereas the default behavior would require a double-click or access to a context menu) 6. This feature allows access to the different locations of the object.

The first of these is a flat list of all entries regardless of category. It is available via the menuitem “Open log” from a host or service context menu. Windows manager The windows manager enables the opening and closing of context-free windows in the workspace. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . This window has the same options “Include sub-elements” and “Lock / Unlock” as the window details.Logs window The logs window displays the historical monitoring data created by the scheduler. (These are views and windows that are not bound to any particular selected object) 38 Chapter 6. The log entries are categorized and displayed in tabs.

6.Some windows. When displaying the windows manager.5.6 The screen (editors) View edition screen The Editing Screen view is the central component of the application. the checked windows opened each at their previous location. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 39 . These refer to a selected object and are outside of the window manager’s sphere of control. it is possible to navigate through the objects on the edition screen: • Double-click to enter an element containing children. This provides a succinct view of an objects status and that of its children. This is the graphical component that provides the most thorough and precise monitoring information. The central part is the element’s own status. When the windows manager dialog box is validated. In addition. however. Centreon Map objects are displayed as icons surrounded by a halo with one or two colors according to their own and / or inherited status. • Using the ‘Parent’ button to go back one level in the tree. This operation can be performed by the interface Centreon. 6. the surrounding circle being its inherited status. the unchecked windows are closed. Each Centreon Map object type has its own default icon and each can be assigned a custom icon such as the host ‘dummy’ in the previous screenshot. only the windows open in the workspace appear checked. are not context-free windows but rather contextual: such are ‘Details’ and ‘Logs’ windows.5.

When the mouse hovers an icon. Tools are available by clicking the icon in the palette. The palette. The Edition screen also provides a range of features. 40 Chapter 6. selecting a tool changes the cursor icon and the corresponding action available on the screen. accessible by administrator-slot users only. Allows to select a group of elements Adds the corresponding shape to the screen Adds an editable text to the screen (font. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . is located on the right-hand side of the screen otherwise by default it is hidden. size and color are customizable) Creates a simple link between two elements Creates a status link between two elements Creates a load link between two elements Deletes a link between two elements Creates a link from a predefined template Shapes abstract individual objects into a single logical group on the screen. (The above screenshot shows the tooltip for the host ‘UNREACHABLE’). with the action “Display relations in new editor”. shapes take on the color of the status of the most critical sub-element. the application displays a contextual tooltip. which presents all the information available for this item. The automatic display of tooltips can be disabled locally via a button for this purpose on the main toolbar or globally via the “Preferences” module detailed in this manual. The various options available for shapes are available by right-clicking. allows the scheduler to determine whether a host is unavailable or inaccessible.5 of Centreon Map. Relationships screen Centreon. The content of the tooltip differs depending on the selected element.4 of Centreon Map. As of version 3. Since version 3. Action Simple selection Multiple selection Rectangle / Ellipse Text Basic link Status link Load link Disconnection Link template Description Allows to select any item on the screen and move it by drag / drop. these relations can be viewed by right-clicking on a host. relying on the host dependency configuration.

Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 41 .Three different representations exist: • Radial (host-centered selection) • Tree (selected host is the tree-top node) 6.5.

User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .• Spring (hosts are grouped into blocks .rendering may vary from one display to another) These three rules apply: 42 Chapter 6.

• The branches where there is no child available (ACL) are automatically dropped. MapBox provides a unique ID as a reference. only the host status is displayed. Beyond this limit. creating and customizing a personalized map is finished. Geoagraphic screen Since version 3. Maps are provided by the means of a third-party mapping service.000 downloads (current prices on March 1st 2014). It is necessary to open a user account with one of these service providers. Indeed. 6.000 downloads for free per month. Whilst MapBox is the service provider we recommend. The Relationships perspective shows all host relationships irrespective of the host limitations configured for the view. Google Maps is also supported. choose MapBox supplier and paste the map ID in the text field ‘Token’ provided for this purpose. Therefore there may be hosts visible in the relationships window that are not present in other Centreon Map windows. this feature relies on an external mapping service to Centreon Map. In Centreon > Administration > Extensions > Centreon Map > Geolocation. but its children are available.• Only children of the selected host are displayed. Once the process of opening a MapBox account.5. • If a host of a branch is not accessible (ACL). Configure geolocation Activation of geolocation in Centreon Map. the use of this service costs around a dollar per 2. elements can overlay a map using their long/lat coordinates. MapBox free account allows 3. requires specific configuration in Centreon.6 of Centreon Map. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 43 .

had the map ID been configured in Centreon. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . The following dialog appears and allows. Navigate within a map Geolocation-enabled.Activate geolocalisation In a standard view edition screen. the screen background is replaced by a map having the lat/long coordinates as the center and a 44 Chapter 6. to activate the geographical mode and enter the long/lat coordinates. open the context menu and select the action “Edit”. right click on the background.

– The “default viewpoint” establishes the initial coordinate and zoom level view of a map. At any moment. technical or financial prejudice due to a total or partial failure of the third party mapping service 6.5. the current map is automatically centered to its coordinates. Additional costs and fees incurred by a third party service are the full responsibility of the client. this viewpoint is never synchronized between clients. each successive level focuses on half of the previous view with twice the detail. As well as being map elements. containers have viewpoints. Viewpoints: • The map view is defined by having a particular position and a particular zoom level. The containers position as an element on the screen is used as a reference point for its internal viewpoint. The Centreon Map license. the user will define a container’s viewpoint such that all child elements be within scope. host-mapped elements are freely placed on the map . • With element-defined positions. There are two manners to organise such host elements on the map. using the main toolbar or via the mouse wheel by holding the “ctrl” key. • With resource-defined positions. [Legal disclaimer] The choice of the third party mapping service for Centreon Map is entirely at the client’s discretion. Abstraction: As map elements become ubiquitous on the screen. Centreon maps provides containers to logically group related elements and therefore filter the information from the data. shielding the user from irrelevant details.updating the coordinates of either updates both. Zoom level 1 represents the full world map. Merethis cannot be held accountable for any professional. Two user actions trigger a request to the mapping service: • A map relocation : this can be done in 2 ways. Map Element Positioning: Recollect that a Centreon resource can be multiply represented by dragging and dropping the resource on the map many times. This viewpoint is maintained on the server and transmitted to other users. This allows instant access to its immediate surroundings.zoom level between 1 and 21. (A container’s default view and element position are strongly bound concepts . the user can revert to the default viewpoint via the toolbar. Containers are also able to embed other containers recursively .each independent of the other. Ultimately. Centreon maps has an active viewpoint and a default viewpoint. it becomes rapidly evident that such need to be abstracted into more manageable constructs. – The “active viewpoint” determines the area displayed on the screen. MERETHIS cannot be held accountable. ( Note : that this is only possible when the host’s coordinates are NOT defined ) When an object of the current map is selected in either the Explorer window or the problematic elements window.this is a powerful paradigm for complexity management.) Typically. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 45 . all resource map elements that ascribe to a Centreon resource will be positioned at the resource’s coordinates. it is modified for every displacement or zoom change and can be saved as the default viewpoint via the toolbar. We shall henceforth refer to the this position/zoom pair as being a “viewpoint”. Each container is capable of portraying a viewpoint of the map. either by a drag/drop of the map or by direct access to a known lat/long. Editing the resources’s coordinates will displace all elements as one logical block. being a saved position or the position of one of the elements on the map • change the zoom level. updates and support do not include professional services MapBox and Google Maps.

46 Chapter 6.The tooltips screen The tooltip screen allows you to create a tab displaying the same content as a tooltip yet in a persistent manner. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . this sort of visual representation can be made manifest by double-clicking or using a context menu. showing the evolution of pings within the monitoring perspective. Depending on the element type. The above image depicts the service type ‘Ping’ as a graph.

there are 10 tabs grouped into 4 zones. of which only one can be active at a time. modified and deleted using the corresponding tools in the palette of the view edition screen. A link can be created between any elements in an view edition screen. They are created. In addition it is possible to create multiple links between two objects. 6. it is not supervised object and is only a visual help.Tabs rotation In the former screenshot.5. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 47 .7 The links The object link type is purely Centreon Map concept. 6.5. with the exception of text objects. Tab rotation revolves around the zone’s list of tabbed screens a regular and configurable interval in order to have a global vision of the workspace without requiring human intervention. There are 3 different types of links used to emphasize different aspects. Each zone is composed of at least one tabbed screen.

status or load) • a name and a description • the line’s width • a line type. continuous. • a style. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . dotted. direct that displays a direct line or indirect with a right angles • a color 48 Chapter 6. etc.Basic link The basic link is used to link elements of the screen without displaying additional monitoring information.. These links have configurable properties: • a type (basic.

Administration > Extensions > Centreon Map tab 6. To be associated to a status link. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 49 . style and color whilst able to display the status of a service. a service must be configured for this purpose in Centreon : it must be associated to a category that is associated with this type of link.5. This configuration is established in the Centreon interface.Status link The status link is a basic link having a fixed system-defined line type.

it is associated with a service but instead displays metrics about the service. similar to the status link. Similar to the status link. has fixed visual link properties. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .The link then displays the status of the configured service. The load link (unidirectional or bidirectional) The bi-directional load link. This feature is particularly useful for modeling connectivity between two devices. 50 Chapter 6.

In this example there is a loss of connection between the client and the server. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 51 . the colors used to indicate different status. etc. many features are configurable: you can customize the size of icons. Administration > Extensions > Centreon Map tab The load link models the rate of flow between two devices. 6.5. the load links can be unidirectional and also the user can define what metrics to display. 6. Centreon Map alerts the user in two ways: • visual feedback.8 Warnings When changing to a critical state. 6.To be associated with a load link. an error or any other significant event. Typically it is used to model the state and bandwidth of the network. This configuration is done in the Centreon interface. as a colored popup at the bottom right of the screen • sound event Both alerts vary depending on the severity of the event and can occur until the reported problem is resolved..5.9 Preferences In Centreon Map. the popup appears in red as it is important information.5. a specific sound is also played. what is the current value and what is the max value. Since version 3. a service must be configured for this purpose in Centreon : it must be associated with a category that is associated with this type of link.5.

The tab ‘Custom’ configures other actions by associating a name to an executable path and arguments. predefined variables are shown in the submenu ‘Informations’.Remote access These preferences configure various settings of the remote access. For this purpose. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . The above screenshot shows the configuration screen of the 3 default access protocols. 52 Chapter 6.

Unchecked. it activates the advanced configuration mode. 6.Drilldown The Drilldown preferences page is used to configure the behaviour of the inherited state algorithm. presented by the lower screen. The first checkbox ‘Use simple drilldown options’ is enabled by default. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 53 .5.

All monitored elements depending on the defective poller enter poller-down state. ‘Use soft statutes for inherited status when available’ lets the algorithm rely on unconfirmed states for inherited state 54 Chapter 6. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . This condition occurs when a poller is out of order. The checkbox ‘Display poller-down status’. The two following checkboxes are available in simple mode. They determine the exclusion of acknowledged or downtime resources from the algorithm. * the order of criticality. this refers to a new status specific to Centreon Map.In advanced mode the user can customize the rules for: * computing the inherited status of acknowledged or downtime items.

processing. it is necessary to reload the statutes of the view for it to be applied. This is more efficient but less reliable. • ‘Show services in tree’ will cause services to be displayed in the ‘Explorer’. • The unit selected is used to display load links. Warning: Incorrect configuration of these options can completely thwart the supervision. • blinking allows easier visualization of problematic elements.5. Be careful! Graphics This preference page allows the user to customize various visual settings: • The style determines whether the objects displayed in screens are represented by an icon or a geometric shape. • The police is for all on-screen text. The last check box excludes the internal links of a container from the inherited state calculation. Ensuing any change. Note : This option can slowdown the processing as it increases the tree items by an order of magnitude. • The space between the icons is that used when they are placed automatically. 6. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 55 .

User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .• The ‘Rotate delay’ determines the time between each tab rotation. The lower preference page allows the user to pick a geometric shape to represent a discrete state. 56 Chapter 6. These settings do not affect the style icon. 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.

Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 57 .6.5.

opacity. and the relative size displayed depending on each status can also be changed. In particular. Warning: Incorrect configuration of these options can completely thwart the supervision. this involves setting the color and opacity of the surrounding halo for a given state in a given condition. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . Finally the color. Be careful! 58 Chapter 6.With the following preferences page the user can customize how an element icon is represented for every discrete state.

Finally. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 59 .5. 6. Other options such as graph displaying and the period displayed can be set here. the dimensions of the tooltip can also be defined.Tooltip On this preference page. the tooltip can be disabled for all screens of the current view.

When creating a link from the template. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY . When a link template is changed the changes are automatically applied to all links associated with the template.Links Templates This preference page allows you to create link templates. Created templates are available in the palette of the view edition screen. Such properties are not affected by the modification of the template. it is possible to override one or more properties of a link associated with a template. the link automatically takes on the template-defined properties without further user interaction. A user-created template has the same properties of the link type on which it is based. 60 Chapter 6. However.

6. The color associated with each event can also be set individually. It can be totally disabled or more finely configured to appear only for certain events.5. • The first two forms relate to the warning popup.Popup The popup preferences page addresses the properties of two different popups in Centreon Map. The ‘Poller alert’ options concern the dialog that appears when a poller connection drops. Monitoring perspective M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY 61 . The addition of the new status ‘Poller down’ deprecates this alert and the above preferences allow you to disable or automatically close this dialog.

Sounds Sound settings allow you to choose which sound is to be associated with each state change. 62 Chapter 6. User guide M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY .