Monitor your first host
Basic principles of monitoringβ
Before starting to monitor, let's take a look at some basic concepts:
- A host is any device that has an IP address and that one wishes to monitor. For example, a physical server, a virtual machine, a temperature probe, an IP camera, a printer or a storage space.
- A service is a check point, or indicator, to be monitored on a host. This can be the CPU usage rate, temperature, motion detection, bandwidth usage rate, disk I/O, and so on.
- In order to collect each indicator value, monitoring plugins are used which are periodically executed by a collection engine called Centreon Engine.
- To be executed, a plugin needs a set of arguments that define, for example, which host to connect to or through which protocol. The plugin and its associated arguments form a command.
For example, to monitor a host with Centreon is to configure all the commands needed to measure the desired indicators, and then deploy that configuration to the collection engine so that these commands are run periodically.
Nevertheless, to drastically simplify the configuration, we will rely on monitoring templates:
- A host template defines the configuration of the indicators for a given type of equipment.
- It relies on service templates that define the configuration of the commands needed to collect these indicators.
- Centreon provides downloadable Plugins Packs to install on its monitoring platform: each Plugin Pack includes host and services templates to configure the monitoring of a particular device in a few clicks.
This quick start guide proposes to install the monitoring templates supplied free of charge with the Centreon solution and then to implement them to monitor your first equipment.
To go further with templates, please read the templates chapter.
If you have a license for it, you can use our Auto Discovery feature to find and configure hosts easily. See also our tutorial on how to detect AWS EC2 instances.
Installation of basic monitoring templatesβ
Go to the Configuration > Plugin Packs menu.
Configure the proxy to allow the Centreon server to access the internet.
Install the Base Generic Plugin Pack (if it is not already installed) by moving your cursor on it and by clicking on the + icon (it is a prerequisite to the installation of any other Plugin Packs):
You can also click on the Plugin Pack in order to know its content before installing it:
Install other Plugin Packs you probably need for your environment, for example Linux SNMP and Windows SNMP available for free:
Now you have the basic templates and plugins to start monitoring hosts!
Start to monitor your first hostβ
Monitor a Linux server with SNMPβ
Go to the Configuration > Plugin Packs menu and install Linux SNMP Plugin Pack:
Go to the Configuration > Hosts > Hosts menu and click on Add:
Fill in the following information:
- The name of the server
- A description of the server
- The IP address
- The SNMP version and community
Click on + Add a new entry button in Templates field, then select the OS-Linux-SNMP-custom template in the list.
Click on Save.
Your equipment has been added to the monitoring configuration:
Go to Configuration > Services > Services by host menu. A set of indicators has been automatically deployed:
Other indicators can be monitored. Click on Add button to add a new service as bandwidth usage for example:
In the Description field, enter the name of the service to create, then select the host to link this service. In the Template filed, select the OS-Linux-Traffic-Generic-Name-SNMP-custom template.
A list of macros corresponding to the model will then appear:
Enter the name of the network interface for the INTERFACENAME macro value and click on Save to add this indicator into the monitoring configuration.
Do the same to add packet error monitoring:
Or for file system:
It is now time to deploy the supervision.
Then go to the Monitoring > Status Details > Services menu and select All value for the Service Status filter. After a few minutes, the first results of the monitoring appear:
To go furtherβ
The Linux SNMP Plugin Pack provides several monitoring templates. When creating a service, it is possible to search the available models in the selection list:
It is also possible to access the Configuration > Services > Templates menu to know the complete list:
With Centreon IT Edition you can add very quickly and very simply the monitoring of your network cards, partition, processes and services using the Service Discovery functionality.
To know manually the name of the available files system you can execute the plugin in command line:
/usr/lib/centreon/plugins/centreon_linux_snmp.pl --plugin=os::linux::snmp::plugin \
--hostname=10.40.1.169 --snmp-community=public --snmp-version=2c --mode=list-storages
You will see the result:
List storage:
Skipping storage 'Physical memory': no type or no matching filter type
Skipping storage 'Swap space': no type or no matching filter type
Skipping storage 'Virtual memory': no type or no matching filter type
'/' [size = 21003583488B] [id = 31]
'/dev/shm' [size = 1986875392B] [id = 36]
'/run' [size = 1986875392B] [id = 38]
'/sys/fs/cgroup' [size = 1986875392B] [id = 39]
'/boot' [size = 1015308288B] [id = 57]
'/var/cache/centreon/backup' [size = 5150212096B] [id = 58]
'/var/lib/centreon-broker' [size = 5150212096B] [id = 59]
Skipping storage 'Memory buffers': no type or no matching filter type
'/var/lib/centreon' [size = 7264002048B] [id = 60]
'/var/log' [size = 10434662400B] [id = 61]
'/var/lib/mysql' [size = 16776032256B] [id = 62]
'/run/user/0' [size = 397377536B] [id = 63]
Skipping storage 'Cached memory': no type or no matching filter type
Skipping storage 'Shared memory': no type or no matching filter type
It is the same to know the name of the available network interfaces:
/usr/lib/centreon/plugins/centreon_linux_snmp.pl --plugin=os::linux::snmp::plugin \
--hostname=10.40.1.169 --snmp-community=public --snmp-version=2c --mode=list-interfaces
You will see the result:
List interfaces:
'lo' [speed = 10, status = up, id = 1]
'enp0s3' [speed = 1000, status = up, id = 2]
Monitor a Windows server with SNMPβ
Go to the Configuration > Plugin Packs menu and install Windows SNMP Plugin Pack:
Go to the Configuration > Hosts > Hosts menu and click on Add:
Fill in the following information:
- The name of the server
- A description of the server
- The IP address
- The SNMP version and community
Click on + Add a new entry button in Templates field, then select the OS-Windows-SNMP-custom template in the list.
Click on Save.
Your equipment has been added to the monitoring configuration:
Go to Configuration > Services > Services by host menu. A set of indicators has been automatically deployed:
Other indicators can be monitored. Click on Add button to add a new service as file system usage for example:
In the Description field, enter the name of the service to create, then select the host to link this service. In the Template filed, select the OS-Windows-Disk-Generic-Name-SNMP-custom template.
A list of macros corresponding to the model will then appear:
Enter the name of the file system for the DISKNAME macro value and add --regexp for the value of EXTRAOPTIONS macro, then and click on Save to add this indicator into the monitoring configuration.
Do the same to network bandwidth usage monitoring:
It is now time to deploy the supervision.
Then go to the Monitoring > Status Details > Services menu and select All value for the Service Status filter. After a few minutes, the first results of the monitoring appear:
To go furtherβ
The Windows SNMP Plugin Pack provides several monitoring templates. When creating a service, it is possible to search the available models in the selection list:
It is also possible to access the Configuration > Services > Templates menu to know the complete list:
With Centreon IT Edition you can add very quickly and very simply the monitoring of your network cards, partition, processes and services using the Service Discovery functionality.
To know manually the name of the available files system you can execute the plugin in command line:
/usr/lib/centreon/plugins/centreon_windows_snmp.pl --plugin=os::windows::snmp::plugin \
--hostname=10.40.1.254 --snmp-version='2c' --snmp-community='public' --mode=list-storages
You will see the result:
List storage:
'C:\ Label: Serial Number 2cb607df' [size = 53317988352B] [id = 1]
Skipping storage 'Virtual Memory': no type or no matching filter type
Skipping storage 'Physical Memory': no type or no matching filter type
It is the same to know the name of the available network interfaces:
/usr/lib/centreon/plugins/centreon_windows_snmp.pl --plugin=os::windows::snmp::plugin \
--hostname=10.40.1.254 --snmp-version='2c' --snmp-community='public' --mode=list-interfaces
You will see the result:
List interfaces:
'loopback_0' [speed = 1073, status = up, id = 1]
'ethernet_3' [speed = , status = notPresent, id = 10]
'ppp_1' [speed = , status = notPresent, id = 11]
'ethernet_10' [speed = 1000, status = up, id = 12]
'tunnel_4' [speed = 0.1, status = down, id = 13]
'ethernet_4' [speed = , status = up, id = 14]
'ethernet_5' [speed = , status = up, id = 15]
'ethernet_6' [speed = , status = up, id = 16]
'ethernet_7' [speed = , status = up, id = 17]
'ethernet_8' [speed = , status = up, id = 18]
'ethernet_9' [speed = , status = up, id = 19]
'tunnel_0' [speed = , status = down, id = 2]
'ethernet_11' [speed = 1000, status = up, id = 20]
'ethernet_12' [speed = 1000, status = up, id = 21]
'ethernet_13' [speed = 1000, status = up, id = 22]
'tunnel_1' [speed = , status = down, id = 3]
'tunnel_2' [speed = , status = down, id = 4]
'tunnel_3' [speed = , status = down, id = 5]
'ppp_0' [speed = , status = down, id = 6]
'ethernet_0' [speed = , status = up, id = 7]
'ethernet_1' [speed = , status = up, id = 8]
'ethernet_2' [speed = , status = up, id = 9]
Monitor a Cisco Router with SNMPβ
Go to the Configuration > Plugin Packs menu and install Cisco Standard Plugin Pack:
Go to the Configuration > Hosts > Hosts menu and click on Add:
Fill in the following information:
- The name of the server
- A description of the server
- The IP address
- The SNMP version and community
Click on + Add a new entry button in Templates field, then select the Net-Cisco-Standard-SNMP-custom template in the list.
Click on Save.
Your equipment has been added to the monitoring configuration:
Go to Configuration > Services > Services by host menu. A set of indicators has been automatically deployed:
Other indicators can be monitored. Click on Add button to add a new service as bandwidth usage for example:
In the Description field, enter the name of the service to create, then select the host to link this service. In the Template filed, select the OS-Linux-Traffic-Generic-Name-SNMP-custom template.
A list of macros corresponding to the model will then appear:
Enter the name of the network interface for the INTERFACENAME macro value and click on Save to add this indicator into the monitoring configuration.
Do the same to add packet error monitoring:
It is now time to deploy the supervision.
Then go to the Monitoring > Status Details > Services menu and select All value for the Service Status filter. After a few minutes, the first results of the monitoring appear:
To go furtherβ
The Cisco Standard Plugin Pack provides several monitoring templates. When creating a service, it is possible to search the available models in the selection list:
It is also possible to access the Configuration > Services > Templates menu to know the complete list:
With Centreon IT Edition you can add very quickly and very simply the monitoring of your network cards, partition, processes and services using the Service Discovery functionality.
To know manually the name of the available network interfaces you can execute the plugin in command line:
/usr/lib/centreon/plugins/centreon_cisco_standard_snmp.pl \
--plugin=network::cisco::standard::snmp::plugin \
--hostname=10.40.1.254 --snmp-community=public --snmp-version=2c --mode=list-interfaces
You will see the result:
List interfaces:
'Gi1/0/1' [speed = 1000, status = up, id = 10101]
'Gi1/0/2' [speed = 1000, status = up, id = 10102]
'Gi1/0/3' [speed = 10, status = down, id = 10103]
'Gi1/0/4' [speed = 10, status = down, id = 10104]
'Gi1/0/5' [speed = 10, status = down, id = 10105]
'Gi1/0/6' [speed = 1000, status = up, id = 10106]
'Gi1/0/7' [speed = 10, status = down, id = 10107]
'Gi1/0/8' [speed = 10, status = down, id = 10108]
'Gi1/0/9' [speed = 10, status = down, id = 10109]
'Gi1/0/10' [speed = 10, status = down, id = 10110]
'Gi1/0/11' [speed = 10, status = down, id = 10111]
'Gi1/0/12' [speed = 10, status = down, id = 10112]
'Gi1/0/13' [speed = 10, status = down, id = 10113]
'Gi1/0/14' [speed = 10, status = down, id = 10114]
'Gi1/0/15' [speed = 10, status = down, id = 10115]
'Gi1/0/16' [speed = 10, status = down, id = 10116]
'Gi1/0/17' [speed = 1000, status = up, id = 10117]
'Gi1/0/18' [speed = 10, status = down, id = 10118]
'Gi1/0/19' [speed = 10, status = down, id = 10119]
'Gi1/0/20' [speed = 100, status = up, id = 10120]
'Gi1/0/21' [speed = 10, status = down, id = 10121]
'Gi1/0/22' [speed = 1000, status = up, id = 10122]
'Gi1/0/23' [speed = 10, status = down, id = 10123]
'Gi1/0/24' [speed = 1000, status = up, id = 10124]
'Gi1/0/25' [speed = 10, status = down, id = 10125]
'Gi1/0/26' [speed = 10, status = down, id = 10126]
'Gi1/0/27' [speed = 10, status = down, id = 10127]
'Gi1/0/28' [speed = 10, status = down, id = 10128]
It is the same to know the name of the spanning-tree:
/usr/lib/centreon/plugins/centreon_cisco_standard_snmp.pl \
--plugin=network::cisco::standard::snmp::plugin \
--hostname=10.40.1.254 --snmp-community=public --snmp-version=2c --mode=list-spanning-trees
You will see the result:
List ports with Spanning Tree Protocol:
[port = GigabitEthernet1/0/20] [state = forwarding] [op_status = up] [admin_status = up] [index = 10120]
[port = Port-channel1] [state = forwarding] [op_status = up] [admin_status = up] [index = 5001]
Monitor a MySQL or MariaDB databaseβ
Go to the Configuration > Plugin Packs menu and install MySQL/MariaDB Plugin Pack:
Go to the Configuration > Hosts > Hosts menu and click on Add:
Fill in the following information:
- The name of the server
- A description of the server
- The IP address
Click on + Add a new entry button in Templates field, then select the App-DB-MySQL-custom template in the list.
A list of macros corresponding to the model will then appear:
Fill in the value of following macros:
- MYSQLUSERNAME: the username to connect to the database.
- MYSQLPASSWORD: the password of the user.
- MYSQLPORT: the TCP port to connect to the database, by default 3306.
Click on Save.
Your equipment has been added to the monitoring configuration:
Go to Configuration > Services > Services by host menu. A set of indicators has been automatically deployed:
It is now time to deploy the supervision.
Then go to the Monitoring > Status Details > Services menu and select All value for the Service Status filter. After a few minutes, the first results of the monitoring appear:
To go furtherβ
The MySQL/MariaDB Plugin Pack provides several monitoring templates. When creating a service, it is possible to search the available models in the selection list:
It is also possible to access the Configuration > Services > Templates menu to know the complete list:
Monitor Printer equipment with SNMPβ
Go to the Configuration > Plugin Packs menu and install Printer Standard Plugin Pack:
Go to the Configuration > Hosts > Hosts menu and click on Add:
Fill in the following information:
- The name of the server
- A description of the server
- The IP address
- The SNMP version and community
Click on + Add a new entry button in Templates field, then select the HW-Printer-standard-rfc3805-custom template in the list.
Click on Save.
Your equipment has been added to the monitoring configuration:
Go to Configuration > Services > Services by host menu. A set of indicators has been automatically deployed:
It is now time to deploy the supervision.
Then go to the Monitoring > Status Details > Services menu and select All value for the Service Status filter. After a few minutes, the first results of the monitoring appear:
Monitor UPS equipment with SNMPβ
Go to the Configuration > Plugin Packs menu and install UPS Standard Plugin Pack:
Go to the Configuration > Hosts > Hosts menu and click on Add:
Fill in the following information:
- The name of the server
- A description of the server
- The IP address
- The SNMP version and community
Click on + Add a new entry button in Templates field, then select the HW-UPS-Standard-Rfc1628-SNMP-custom template in the list.
Click on Save.
Your equipment has been added to the monitoring configuration:
Go to Configuration > Services > Services by host menu. A set of indicators has been automatically deployed:
It is now time to deploy the supervision.
Then go to the Monitoring > Status Details > Services menu and select All value for the Service Status filter. After a few minutes, the first results of the monitoring appear:
Deploying a configurationβ
On creation/deletion/change of objects via the configuration interface, the changes performed are not applied automatically to the monitoring engine. To apply the changes performed, it is necessary to follow the procedure below.
Go to Configuration > Pollers > Pollers.
Select the pollers whose configuration you want to export.
Click on Export configuration.
Check the following boxes:
- Generate Configuration Files
- Run monitoring engine debug (-v)
- Move Export Files
- Restart Monitoring Engine.
Click Export.
Check that no errors appear during generation.