Centreon documentation

Centreon documentation

  • Documentation

›Guide

Getting Started

  • Installation & first steps
  • Tutorials

    • Introduction
    • Create a custom view
    • Create a graphical view
    • Model your IT services
    • Analyze resources availability

Installation

  • Introduction
  • Prerequisites
  • Architectures
  • Download
  • Installation of a Central server

    • Using Centreon ISO
    • Using packages
    • Using virtual machines (VMs)
    • Using sources
  • Web And Post Installation
  • Installation of a Poller

    • Using Centreon ISO
    • Using packages

    Installation of a Remote server

    • Using Centreon ISO
    • Using packages
  • What is Centreon CEIP?

Secure your platform

  • Secure your platform
  • Secure your MAP platform

Monitoring

  • About Monitoring
  • Generic actions
  • Basic Objects

    • Macros
    • Commands
    • Time periods
    • Contacts
    • Hosts
    • Services
    • Meta Services
  • Templates
  • Plugin Packs
  • Monitoring Servers

    • Add a Poller to configuration
    • Add a Remote Server to configuration
    • Communications
    • Deploying a configuration
    • Advanced configuration
  • Groups & Categories
  • Passive Monitoring

    • Enable SNMP Traps
    • Create SNMP Traps definitions
    • Monitoring with SNMP Traps
    • Debug SNMP Traps management
    • Dynamic Service Management
  • Anomaly detection
  • Discovery

    • Introduction
    • Installation
    • Hosts Discovery
    • Services Discovery
    • Administration
  • Auto Remediation
  • Import/Export

Alerts & Notifications

  • Concepts
  • Resources Status
  • Events consoles
  • Manage alerts
  • Notification

    • Concept
    • Configuration
    • Dependencies
    • Escalation
    • Flapping
    • To go further
  • Ticketing
  • Event Logs

Performance graphs

  • Charts managment
  • Graph template
  • Curves
  • Virtual metrics

Service Mapping

  • Introduction to Centreon BAM
  • Guide

    • Manage Business Activities
    • Monitor Business Activities
    • Report Business Activities
    • Settings
    • Widgets

    Administrate

    • Install Centreon BAM extension
    • Update the extension
    • Upgrade the extension
    • Migrate the extension
    • Install on a Remote Server

Graphical views

  • Introduction to Centreon MAP
  • Guide

    • Create a standard view
    • Create a geo view
    • Display views
    • Share a view

    Administrate

    • Install Centreon MAP extension
    • Update the extension
    • Upgrade the extension
    • Migrate the extension
    • Configure
    • Install on a Remote server
    • Advanced configuration
    • Known issues
    • Troubleshooter

Reporting

  • Introduction to Centreon MBI
  • Guide

    • Generate reports
    • Available reports
    • Widgets
    • Configure
    • Concepts
    • Report development

    Administrate

    • Install Centreon MBI extension
    • Update the extension
    • Upgrade the extension
    • Migrate the extension
    • Backup & restore

Administration

    Parameters

    • Centreon UI
    • Monitoring
    • Gorgone
    • LDAP
    • RRDTool
    • Debug
    • Data management
    • Medias
  • Access Control Lists
  • Extensions
  • Database partitioning
  • Centreon HA

    • Architectures
    • Installing a Centreon HA 2-nodes cluster
    • Installing a Centreon HA 4-nodes cluster
    • Monitoring Centreon-HA
    • Operating guide
    • Updating Centreon-HA platform
    • Upgrade from Centreon-Failover to Centreon-HA
    • Troubleshooting guide
  • Backup
  • Knowledge Base
  • Logging configuration changes
  • Platform statistics

Update, Upgrade & Migrate

    Update

    • Update a Centreon 20.10 platform

    Upgrade

    • Introduction to upgrade
    • Upgrade from Centreon 20.04
    • Upgrade from Centreon 19.10
    • Upgrade from Centreon 19.04
    • Upgrade from Centreon 18.10
    • Upgrade from Centreon 3.4

    Migrate

    • Introduction
    • Migrate from a Centreon 20.x platform
    • Migrate from a Centreon 3.4 platform
    • Nagios Reader to Centreon CLAPI
    • Migrate a platform with Poller Display module

Plugin Packs

  • Introduction to Plugin Packs
  • Tutorials

    • Collect OpenMetrics

    Applications

    • 3CX
    • Active Directory API
    • ActiveMQ JMX
    • Alyvix Server
    • Ansible
    • Ansible Tower
    • Antivirus ClamAV
    • Apache Server
    • Asterisk VoIP Server
    • Asterisk VoIP SNMP
    • Bind9 Web
    • BlueMind SSH
    • Cassandra
    • Cisco CMS
    • Cisco ISE
    • Cisco SSMS
    • Commvault CommServe Rest API
    • DRBD SSH
    • Dynatrace Rest API
    • EMC PPMA Rest API
    • Exchange 2010 API
    • Github
    • Github
    • Google Gsuite
    • Haproxy SNMP
    • Hibernate
    • IBM Tivoli Storage M
    • Microsoft DHCP SNMP
    • Microsoft IIS Server Restapi
    • Microsoft IIS Server NSClient API (Deprecated)
    • JBoss Server
    • Jenkins
    • Kafka
    • Kaspersky
    • Keepalived SNMP
    • Lync 2013
    • Maltem Insight Rest API
    • IP-Label datametrie API
    • IP-Label Newtest Rest API
    • McAfee Web Gateway
    • Microsoft Cluster Se
    • Microsoft IIS Server NRPE (Deprecated)
    • Microsoft SCCM
    • Microsoft WSUS
    • MS Active Directory
    • MS Biztalk
    • Graylog
    • MS Exchange 2K10
    • BlueMind
    • Mulesoft Anypoint
    • Netbackup Rest API
    • Netdata RestAPI
    • Nginx Server
    • Nginx Plus Restapi
    • OpenHeadend
    • OpenLDAP
    • OpenMetrics
    • OpenVPN OMI
    • OpenWeatherMap
    • Oracle GoldenGate SSH
    • Oracle VM Manager API
    • Pacemaker
    • Peoplesoft
    • Pfsense Fauxapi
    • PHP APC
    • PHP FPM
    • PVX
    • Quadstor
    • RabbitMQ RestAPI
    • Rapid Recovery SNMP
    • Redis Cli
    • Redis Restapi
    • Rubrik Rest API
    • Rudder
    • Salesforce
    • SAP HANA
    • SCOM Rest API
    • Gorgone Restapi
    • Selenium
    • Sendmail
    • Skype 2015
    • Smartermail Server
    • Solr
    • Squid SNMP
    • Symantec Netbackup
    • Tomcat JMX
    • Tomcat Webmanager
    • TrendMicro Iwsva
    • Varnish NRPE
    • Veeam
    • Veeam API
    • VerneMQ Restapi
    • VMware VCSA RestAPI
    • VTOM
    • Wazuh Rest API
    • Weblogic Server
    • ZIXI
    • Zookeeper

    Centreon

    • Centreon Central
    • Centreon Database
    • Centreon-HA
    • Centreon Map
    • Centreon Map4
    • Centreon MBI
    • Centreon Poller

    Cloud

    • Amazon API Gateway
    • Amazon CloudFront
    • Amazon CloudWatch
    • Amazon CloudWatch Logs
    • Amazon EBS
    • Amazon EC2
    • Amazon ElastiCache
    • Amazon EFS
    • Amazon Kinesis
    • Amazon RDS
    • Amazon S3
    • Amazon SNS
    • Amazon SQS
    • AWS Billing
    • AWS ELB
    • AWS Health
    • AWS Lambda
    • AWS Transit Gateway
    • AWS VPN
    • Amazon SES
    • Azure Automation
    • Azure Elastic Pool
    • Azure Event Grid
    • Azure ExpressRoute
    • Azure Firewall
    • Azure Key Vault
    • Azure Load Balancer
    • Azure Log Analytics
    • Azure Monitor
    • Azure Network Interface
    • Azure Public IP
    • Azure Recovery
    • Azure Resource
    • Azure ServiceBus
    • Azure SignalR
    • Azure SQL Database
    • Azure SQL Server
    • Azure Storage Account
    • Azure Virtual Machine
    • Azure Virtual Network
    • Azure VPN Gateway
    • Google CloudSQL MySQL
    • Google Compute Engine
    • Google Stackdriver
    • Google Storage
    • cAdvisor
    • Cloud Foundry
    • Docker
    • IBM Softlayer
    • Kubernetes API
    • Kubernetes w/ Prometheus
    • Office 365
    • Office365 Exchange
    • Office365 OneDrive
    • Office365 SharePoint
    • Office365 Skype
    • Office365 Teams
    • OVH
    • Prometheus Server
    • Node Exporter
    • VMware VeloCloud

    Database

    • CouchDB Rest API
    • Elasticsearch
    • Elasticsearch (Deprecated)
    • Firebird
    • InfluxDB
    • Informix DB
    • Informix DB SNMP
    • Microsoft SQL Server
    • MongoDB
    • MySQL/MariaDB
    • Oracle Database
    • PostgreSQL DB
    • RRDtool
    • Sybase
    • Warp10 Sensision

    Hardware Server

    • Adder AIM SNMP
    • AEG ACM
    • Avocent ACS 6000
    • Axis Video
    • Cisco Collaboration Endpoint Rest API
    • Cisco UCS
    • Dell CMC
    • Dell iDRAC
    • Dell OpenManage
    • Eltek eNexus SNMP
    • Fujitsu Server SNMP
    • Hanwha camera SNMP
    • Hikvision camera SNMP
    • HMS Ewon SNMP
    • Timelinkmicro Tms6001
    • HP Blade Chassis
    • HP Ilo Rest API
    • HP Ilo XMLAPI
    • HP OneView Rest API
    • HP Proliant
    • Huawei HMM
    • Huawei iBMC
    • IBM BladeCenter
    • IBM HMC SSH
    • IBM IMM
    • Lenovo XCC SNMP
    • Cisco Telepresence System SNMP
    • Masterclock NTP100GP
    • Pexip Infinity ManagementAPI
    • Polycom GroupSeries SNMP
    • Polycom Trio Rest API
    • Safenet Keysecure
    • Sun MgmtCard
    • Sun Mseries
    • Sun SFxxK
    • Supermicro

    Network

    • 3com Network
    • A10 AX
    • Acme Packet
    • Adva FSP 150 SNMP
    • Adva FSP 3000 SNMP
    • Aerohive
    • Alcatel Omniswitch
    • Allied Telesis SNMP
    • Alvarion BreezeACCESS SNMP
    • Arista Switch
    • Arkoon
    • Aruba Instant SNMP
    • Aruba Standard
    • Atrica Routeur
    • Athonet ePC SNMP
    • Atto Fibrebridge SNMP
    • Barracuda Cloudgen SNMP
    • Bee Ware
    • BGP Protocol SNMP
    • Bluecoat generic
    • Brocade Switch
    • CheckPoint firewall
    • Cisco Apic
    • Cisco ASA
    • Cisco Call Manager
    • Cisco Callmanager SXML
    • Cisco ESA XMLAPI
    • Cisco Firepower Management Console Rest API
    • Cisco Firepower SNMP
    • Cisco IronPort
    • Cisco Meraki Rest API
    • Cisco Meraki
    • Cisco Prime
    • Cisco Small Business
    • Cisco Standard
    • Cisco Standard SSH
    • Cisco VCS
    • Cisco Voice Gateway
    • Cisco Waas
    • Cisco WLC
    • Citrix Acceleration
    • Citrix Netscaler
    • Citrix SDX
    • Colubris SNMP
    • Cyberoam
    • D-Link DGS 3100
    • D-Link standard SNMP
    • Dell 6200
    • Dell 6200 SNMP
    • Dell N4000
    • Dell OS10 SNMP
    • Dell S-series
    • DenyAll SNMP
    • Dell Xseries
    • Digi Anywhere USB
    • Digi PortServers TS
    • Digi PortServers TS
    • Digi Sarian
    • Efficienti IP
    • Evertz FC7800
    • Extreme Network
    • F5 BigIP
    • Lenovo Flex System Switch
    • Fiberstore SNMP
    • Fortinet FortiAuthenticator SNMP
    • Fortinet Fortigate
    • Fortinet Fortimanage
    • Freebox
    • FritzBox
    • Gorgy NTP Server
    • H3C Network
    • Hirschmann switch
    • HP Procurve
    • HP Standard Network
    • HP Virtual Connect
    • Huawei
    • Infoblox SNMP
    • Juniper EX Series
    • Juniper GGSN
    • Juniper ISG
    • Juniper M-Series
    • Juniper Mag
    • Juniper SA
    • Juniper SRX
    • Juniper SSG
    • Juniper Trapeze
    • Kemp Loadbalancer
    • Meru SNMP
    • Mikrotik SNMP
    • Mitel 3300ICP
    • Moxa Switch
    • Mrv Optiswitch
    • NetASQ Network
    • Netgear MSeries
    • Netscaler MPX 8000
    • Nokia TiMos
    • Nortel Standard
    • Omniswitch 6850
    • OneAccess Network
    • Oracle Infiniband
    • Palo Alto firewall SNMP
    • Palo Alto firewall SSH
    • Peplink Balance
    • Peplink Pepwave SNMP
    • Perle IDS SNMP
    • pfSense
    • Rad Airmux SNMP
    • Radware Alteon
    • Raisecom
    • RedBack Router
    • Riverbed Interceptor
    • Riverbed SteelHead
    • Ruckus
    • Ruckus Zonedirector
    • Ruckus ICX
    • Ruckus SCG
    • Ruckus Smartzone
    • Ruggedcom Network
    • Silverpeak
    • Sonicwall
    • Sophos ES
    • Stonesoft
    • Stormshield SNMP
    • Stormshield SSH
    • Teltonika SNMP
    • Ubiquiti AirFiber SNMP
    • Traffic Director
    • Ucopia
    • Watchguard
    • Zyxel
    • Versa SNMP
    • Versa Director Restapi

    Operating System

    • AIX SNMP
    • Base Pack
    • FreeBSD SNMP
    • HP-UX
    • IBM AS400
    • Linux NRPE
    • Linux NRPE3
    • Linux SNMP
    • Linux SSH
    • Mac SNMP
    • Solaris SNMP
    • Windows NRPE
    • Windows NRPE 0.5
    • Windows NSClient API
    • Windows SNMP

    Printer

    • Printer standard

    Protocol

    • BGP Protocol
    • DHCP Server
    • DNS Service
    • FTP Server
    • Generic SNMP
    • HTTP Server
    • IMAP Server
    • JMX value
    • LDAP Server
    • Modbus
    • NTP Server
    • OSPF Protocol
    • POP Server
    • Protocol DHCP
    • Protocol SSH
    • Protocol TCP
    • Protocol UDP
    • Radius Service
    • SMTP Server
    • Telnet Scenario
    • TFTP Server
    • X509 Certificat

    Sensor

    • ABB CMS-700
    • AKCP Sensor
    • Geist p8000 sensor SNMP
    • Geist Sensor SNMP
    • HWg-STE Sensor
    • Jacarta Sensor
    • LM Sensors
    • Netbotz Sensor
    • Sensor IP
    • SensorGateway
    • Sensormetrix

    Storage

    • Adic Tape SNMP
    • Avid Isis
    • Buffalo TeraStation SNMP
    • Dell Compellent
    • Dell Compellent API
    • Dell Equallogic
    • Dell FluidFS
    • Dell MD3000
    • Dell Me4 Rest API
    • Dell ML6000
    • Dell TL2000
    • EMC Celerra
    • EMC Clariion
    • EMC Data Domain
    • EMC Isilon
    • EMC RecoveryPoint
    • EMC Symmetrix API
    • EMC Symmetrix NRPE
    • EMC Unisphere Rest API
    • EMC Vplex
    • EMC Xtremio
    • Exagrid
    • Fujitsu Eternus DX
    • Hitachi HCP SNMP
    • Hitachi NAS
    • Hitachi Standard
    • HP 3PAR 7000
    • HP 3PAR SSH
    • HP EVA
    • HP Lefthand
    • HP MSA2000
    • HP MSL
    • HP P2000
    • HP StoreOnce
    • HP StoreOnce SSH
    • IBM DS3000
    • IBM DS4000
    • IBM DS5000
    • IBM FlashSystem 900
    • IBM Storwize
    • IBM TS2900
    • IBM TS3100
    • IBM TS3200
    • IBM TS3500
    • Kaminario RestAPI
    • Lenovo S Series
    • NetApp Ontap OnCommand API
    • NetApp Ontap Rest API
    • NetApp Ontap SNMP
    • Netapp Santricity Restapi
    • Netgear Readynas SNMP
    • Nimble Storage
    • Nimble Storage Rest API
    • Oracle ZFS
    • Oracle ZS
    • Overland Neo
    • Panzura
    • Pure Storage RestAPI
    • Qnap
    • QSAN NAS
    • Quantum DXi Series
    • Quantum Scalar
    • Storagetek SL
    • Synology
    • Violin Memory 3000

    Toip Voip

    • Alcatel OXE
    • Asterisk VoIP Server
    • AudioCodes
    • Avaya AES SNMP
    • Avaya Media Gateway SNMP
    • Polycom DMA SNMP
    • Polycom HDX SNMP
    • Polycom RMX
    • Polycom RPRM SNMP
    • Sonus SBC
    • XiVO VoIP Server

    Ups Pdu

    • Alpha UPS SNMP
    • APC ATS
    • APC PDU
    • APC UPS
    • Clever PDU
    • CyberPower Systems PDU SNMP
    • Eaton ATS SNMP
    • Eaton PDU SNMP
    • Emerson PDU
    • HP UPS SNMP
    • MGE UPS System
    • Nitram UPS SNMP
    • Powerware UPS
    • Raritan PDU
    • Schleifenbauer Gateway SNMP
    • UPS Socomec Net Vision SNMP
    • UPS Standard

    Virtualization

    • Hyper-V 2012
    • Nutanix
    • Proxmox VE
    • VMware ESX
    • VMware ESX WS-MAN
    • VMware vCenter
    • VMware vCenter v4
    • VMware vCenter v5
    • VMware vCenter v6
    • VMware VM

Integrations

    External

    • Accedian PVX Skylight
    • Maltem Insight Performances Rest API

    Notifications

    • Notify with Telegram bot

    Open Tickets

    • BMC Footprints
    • BMC Remedy
    • EasyVista
    • GLPI
    • GLPI RestAPI
    • iTop
    • IWS Isilog
    • Jira
    • Mail
    • OTRS RestAPI
    • Request Tracker RestAPI
    • Serena
    • ServiceNow

    Stream Connectors

    • BSM
    • Elasticsearch events
    • Elasticsearch metrics
    • NDO
    • Opsgenie integration
    • HP OMI
    • PagerDuty Service integration
    • ServiceNow Event Manager
    • ServiceNow MID Server
    • Splunk Metrics
    • Splunk Events
    • Warp10

Mobile App.

  • Introduction

API

  • Introduction
  • Command Line API (v1)
  • Rest API (v1)
  • Rest API (v2)
  • Graphical views API (beta)

Developer resources

  • About developer resources
  • How to write a module
  • How to write a Stream Connector
  • How to translate Centreon
  • How to write a widget
  • Centreon Broker

    • Stream connectors
    • The BBDO protocol
    • Centreon Broker Event Mapping

Releases

  • Centreon Platform 20.10.0
  • Products lifecycle policy
  • Release notes by component

    • Centreon Core
    • Commercial Extensions
    • Open Source Extensions
Edit

Create a standard view

To create standard views, you have to use Centreon Map Desktop client.

Best practices & limitations

In a production environment, you might have lot of views & information to share with your final users.

Here are some best practices to have in mind when creating views.*

Content limitations : Try not to have more than ~100 000 elements loaded "at a time". A loaded element is an element in an opened view. An opened view is a view that at least one user is looking at (using desktop client or through the web interface).

Find below some usefull best practices to help you designing optimized views:

  • We more than highly recommend activating the ACL optimization (gate.useResourcesAccess=false).
  • When you want to visualize application statuses, we highly recommend modelling them using Business Activities. This will help you to limit the number of elements you need to add to a view. Adding one Business Activity to a view means only 1 element is added instead of all the hosts & services you would have added in the view to model the application otherwise.
  • Avoid duplicating the same resources (hostgroups, servicegroups, hosts, services) in the same view or in multiple views.
  • If a view seems to contain "too many elements" (see Content limitation above), try to conceptually group several elements in order to split into multiple views.
  • Create views having less than 5 levels (drill down)
  • Do not display more than 100 elements in a single view level. (element: container, host, hostgroup, service, business activity)
  • Do not display more than 10 widgets in a single view level.

How to calculate the number of element?

Here is an example that may help you: Let's imagine a view opened by a user containing 10 containers, each containing 10 hosts, each host containing 10 services.

Number of elements: 10 containers + 10 containers * (10 host + 10 host * 10 services) = 1110 elements.

1110 elements will be loaded when at least one user opens this view. According to the content limitations, it means you can have 100 views such as this one opened by at least one user.

These limitations/recommendations are based on a Centreon Map server having 8GB of RAM, 8vCPU (2.6Ghz), Google Chrome (latest version) with a minimum of 5GB of memory on the computer.

You cannot add any objects (e.g., text, gauge, pie chart, graph etc.) to, or modify/copy-paste the contents of, a host, host group, service group or business activity.

Connect to the desktop client

To connect the desktop client to the server you must first create a profile:

image

Add a profile by clicking on the "+" to the right of the Profile window:

image

  • Address: Address of the Map Server
  • Login: Your Centreon Web username
  • Password: Password for your Centreon Web username
  • Use TLS: Check here if the Map Server is configured for HTTPS
  • Port: Listening port for the Map Server -- it uses 8080 by default and 8443 if you have configured for HTTPS
  • URL: The URL for reaching Map Server. The default value is "/".

If there is a proxy between your computer and the Map Server or internet, configure it here:

  • Proxies: Address of proxy server
  • Port: Port of proxy server
  • Proxy Login (not mandatory): Proxy server login
  • Proxy Password (not mandatory): Login password for proxy server
  • Use proxy for internet: Check here if a proxy is required to connect to the internet. It will be useful for automatically downloading updates to the desktop client.
  • Use proxy for server: Check here if a proxy is required to reach your Map Server.

Add a view

Empty view

Here is how to create your first view:

Once you are logged in to your desktop client, you will see this screen:

image

Click on File > Create View or right click on the empty left panel, then Add.

A new wizard will appear. Enter a name for the new view (and an optional description).

image

You can then either click Finish to create the view or click Next to associate an image to it.

Once done, you will see your new view in the left tab panel.

image

Now, double click on the view to open it. Your main panel will have a white background and you will be able to start adding elements to it: simply drag and drop resources from your resource panel to the main panel.

You cannot add any objects (e.g., a gauge, pie chart or graph) to, or modify/copy-paste the contents of, a host, host group, service group or business activity.

Congratulations, your have just created your first view.

image

From an existing container

When you want to share the sublevel of a view to a different profile without duplicating its contents or assigning full access to the main view, you can create another view that is directly linked to a container.

To do so, right click on the container or inside the target one and click on Create a view from that container.

If you rename the view that is linked to the container, the container will automatically be renamed.

image

Add a geographic background

After linking your Mapbox account you can create a standard view and define a geo background:

  1. Open your desktop client,
  2. Open a view,
  3. Right click on the background of the view and select "Edit",
  4. Check the "Geographic" checkbox.

image

Your view will now appear as a geographic background on which you can zoom and move around.

By default, the whole world is displayed. Every time you open the view, the zoom is set to its default value: 1. You can change this setting.

Navigate around your view, zoom and go to the exact point where you would like your view to open by default. Then use the "Set current lat / long / zoom as defaut" button on the top of your desktop client.

image

Whenever you open this view either through the desktop or the web interface, the geographic view will always appear with the pre-defined zoom level.

Modify object style

When displaying any resource (group, host, services, business activity, etc.) or container in a view, three different styles may be applied:

image

To change the style of an element, simply right click on it, select the "Style" menu and pick the style you want. You can also select multiple elements at the same time.

image

The default style for a geographic view is "geometric".

The default style for a standard view is "Icon".

Use widgets

Dedicated data reprezentation called "Widgets" are available in the "Palette" tab panel:

image

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

Graphs

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

image

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

image

Gauges

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

image

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

Pie charts

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

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

image

Output

Default behaviour

The output widget describes the output of a service.

image

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

image

Customizing the output

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

You will see this page:

image

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

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

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

Example

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

To display the following output :

image

Configure the output widget as follows:

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

URL

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

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

Process

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

Here is an example:

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

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

image

To create a service dedicated to an "action":

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

Then you can assign that service to the widget.

Create links between objects

When using Centreon MAP, you can create links between any elements. There are three kinds of link:

  • Simple link: Connects two elements in color.
  • Status link: Uses a color based on the status of a service.
  • Metric link: Displays the % of a metric, appearing in a color according to this value.

You may use the concept of "link template" in Centreon Map to accelerate the creation of lot of links with the same properties.

When you delete a link template, it removes all the links created with this template.

Simple links

The simple link in this view show the logical connection between different elements.

image

Status links

Status links can be used to represent the ability of a resource to reach another resource/area of the infrastructure, wether it's a service on one of the two element connected or if it's on another resource.

The lines on this views shows the ability of users to connect to a system using Citrix and then the ability of different technical areas to reach each others. Detailed information are available when putting your mouse over a link on the web interface.

image

Metric link

When configuring a metric link, choose a metric to associate it with. For double links you need to choose two metrics.

A good example is the traffic metric. You generaly have a traffic_in and traffic_out associated with your traffic service.

image

Detailed informations are available when mouse hovering a link on the web interface.

The color you see on the link is only visible to you, you may want to configure links color globaly for all user.

Add images

By default, all the images added to Centreon are automatically available to Centreon MAP so that they can be linked to objects and added to views. These images are imported into the "centreon" folder and you cannot add or modify images in that folder. However, if you want to add new media than will only be used in Centreon MAP, follow this procedure:

  1. Open the Media panel,
  2. Create at least one folder,
  3. Right click on the new folder,
  4. Click on Import.

image

When adding new images to your Centreon platform (not from Centreon MAP) you may click on Actions > Synchronize Media so that added or deleted images from Centreon are mirrored to Centreon Map.

The following formats can be used in Centreon MAP:

  • PNG
  • GIF (will only animate on the web interface)
  • JPEG.

Create System command (desktop only)

Centreon MAP allows you to launch applications installed on your computer using parameters from your Centreon. Proceed by right clicking on an host in Centreon MAP to start a Putty / SSH session directly, without entering any parameters.

Example for Linux with Terminator

Here is how you would create a SSH command using the binary terminator.

Start by creating a new system command. Go to the Preferences page, under the System commands menu. Then enter the following:

image

  • Label: SSH

  • Path: terminator

  • Parameters:

    -e ssh [root@%host.address](mailto:root@%host.address%)
    

Here, the %host.address% will be automatically replaced by the host address of the element you right click on.

Click on Save.

Your command is now available for every element on which you right click in the System commands submenu.

Example for Windows with Putty

image

Advanced configuration

In the parameters, you can use variables from the element you selected and also from your account, such as username and password. To do so, add the variables $user.login$ and $user.password$. This is convenient for validating users over an LDAP with all the servers connected.

You can also set default parameters and request whether the user wants to override them at runtime. To do so, use the following syntax:

\&user=root&

The command and arguments will be:

-ssh &user=root&@%host.address%

Every time the command is run, a prompt will be displayed proposing the default value. The user can either press ENTER to validate or override it with another value.

← Introduction to Centreon MAPCreate a geo view →
  • Best practices & limitations
  • Connect to the desktop client
  • Add a view
    • Empty view
    • From an existing container
    • Add a geographic background
  • Modify object style
  • Use widgets
    • Graphs
    • Gauges
    • Pie charts
    • Output
    • URL
    • Process
  • Create links between objects
    • Simple links
    • Status links
    • Metric link
  • Add images
  • Create System command (desktop only)
    • Example for Linux with Terminator
    • Example for Windows with Putty
    • Advanced configuration
Centreon documentation
Documentation
Getting StartedAPI ReferencesReleases
Resources
Centreon WebsiteBlogDownload
Follow us
centreon
Follow @Centreon
Copyright © 2005 - 2021 Centreon