centreon / centreon-documentation

Centreon documentation

Centreon - IT and Application monitoring software

               

   

Introduction

Centreon is one of the most flexible and powerful monitoring softwares on the market; it is absolutely free and Open Source.

Getting Started

Centreon software can be set up

• Using the sources
• Using the packages
• Using the ISO
• Using the VM (tutorial available on Youtube)

Supported versions

Regarding the Products Lifecycle Policy, only the following versions are supported:

• Centreon 21.10.x, released on November 2, 2021, full support
• Centreon 21.04.x, released on April 21, 2021, security and blocking issue support only
• Centreon 20.10.x, released on October 21, 2020, security support only

If your version is not one of the 3 versions specified above, we recommend that you upgrade your platform immediately.

Authors

Project leaders

   

Product managers

       

Development team

                             

Quality Assurance

       

Documentation

 

See also the list of our contributors

Security Acknowledgement page

We want to thank all reporters and pentesters who help us improve our product each day.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, bug report, feature request and the process for submitting pull requests for us.

License

This project is licensed under the Apache 2.0 License - see the LICENSE.md file for details

centreon-documentation's Issues

Install from sources needs to be updated to use centreon-collect

The documentation to install from sources is outdated: https://docs.centreon.com/fr/docs/installation/installation-of-a-central-server/using-sources/

This mentions that centreon-clib and centreon-engine must be installed from their repos, but these repositories have been merged in centreon-collect now.

add an option to applications-databases-oracle

The instructions to compile DBD-Oracle-1.80.tar.gz works fine, but the following command gives error:

perl Makefile.PL -m /usr/share/oracle/21/client64/demo/demo.mk

Issue on Cpan:
https://rt.cpan.org/Public/Bug/Display.html?id=134883

My workaround is to force the higher client version that DBD-Oracle-1.80 understand:
perl Makefile.PL -V 12.1.0 -m /usr/share/oracle/21/client64/demo/demo.mk

Is is possible to change the documentation adding -V 12.1.0 as option? Or add a note?

Thanks,

Dead link in mail configuration section

Dead link here:
https://github.com/centreon/centreon-documentation/blob/staging/versioned_docs/version-22.04/administration/postfix.md?plain=1#L8
(https://docs.centreon.com/docs/administration/postfix/)

Applies to versions 21.04, 21.10, 22.04, both EN & FR

Freebox centreon API : How to install --> Procedure OK

• curl http://"IP de la freebox"/api/v4/login/authorize -d '{"app_id":"centreon","app_name":"centreon","app_version":"3.0","device_name":"Freebox"}'
• Autoriser sur la Freebox
• Obtention of a Token : you will have Token ID et app_id
• Go to on web page : http://mafreebox.freebox.fr/api/v4/login/authorize/"app_id"
  --> You can check on the webpage of the Freebox Granted access and Appllications if it's ok.
• Go on your centreon :
  --> Host - Ip Adress : "IP of your Box"
  --> FREEBOXAPPID : "app-id"
  --> FREEBOXAPPTOKEN : "The token as you have received as is "

missing documentation for new plugin pack

The "Azure Virtual Machine Scale Sets" is missing it's documentation

The plugin pack opens the following link when pressing [i]
https://docs.centreon.com/current/en/integrations/plugin-packs/procedures/cloud-azure-compute-vmscalesets.html

The plugin pack isn't present in the documentation when searching for it manually.

Missing database schema

The new documentation miss the database schema.

Something like the schema in the old doc:

• https://docs.centreon.com/docs/centreon/en/19.04/faq/performance.html#databases-schema
• https://docs.centreon.com/docs/centreon/en/19.04/_images/centreon.png

Thanks,

The "publication rules" section of the reporting feature is missing

The "publication rules" section is missing.
This link:
https://github.com/centreon/centreon-documentation/blame/master/en/reporting/generate-reports.md#L194
is still set to "TODO"
(same for FR version as shown in the following screenshot)

[Centreon-PP] MSSQLServer - file freetds.conf specific location for debian

On debian 11 the location of freetds.conf has changed.
The new directory is here: /etc/freetds/freetds.conf instead of /etc/freetds.conf on other distribs
and the tds version is set to "auto"

RPM Url return 404

Describe the bug
Url error in page https://docs.centreon.com/current/fr/installation/installation-of-a-poller/using-packages.html in french version.

The RPM url http://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm

Return 404 errror :

 dnf install -y http://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm
CentOS Stream 8 - PowerTools                                                                                                      11 MB/s | 2.0 MB     00:00
Extra Packages for Enterprise Linux Modular 8 - x86_64                                                                           719 kB/s | 557 kB     00:00
Extra Packages for Enterprise Linux 8 - x86_64                                                                                    12 MB/s | 9.3 MB     00:00
[MIRROR] centreon-release-20.10-2.el8.centos.noarch.rpm: Status code: 404 for https://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm (IP: 52.85.14.84)
[MIRROR] centreon-release-20.10-2.el8.centos.noarch.rpm: Status code: 404 for https://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm (IP: 52.85.14.84)
[MIRROR] centreon-release-20.10-2.el8.centos.noarch.rpm: Status code: 404 for https://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm (IP: 52.85.14.84)
[MIRROR] centreon-release-20.10-2.el8.centos.noarch.rpm: Status code: 404 for https://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm (IP: 52.85.14.84)
[FAILED] centreon-release-20.10-2.el8.centos.noarch.rpm: Status code: 404 for https://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm (IP: 52.85.14.84)
Status code: 404 for https://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-2.el8.centos.noarch.rpm (IP: 52.85.14.84)

Desktop (please complete the following information):

• OS: CentOS 8-stream

Network flows for HA

The HA documentation miss a table with the network flow, like this one:
https://docs.centreon.com/current/en/installation/architectures.html#tables-of-network-flows

Typo error in the ServiceNow openTicket page

ServiceNow has to replace iTop at the bottom of this page
https://docs.centreon.com/20.10/en/integrations/open-tickets/servicenow.html

"As of now, the provider is able to retrieve the following objects from Itop:"
to
"As of now, the provider is able to retrieve the following objects from ServiceNow:"

Thank you, guys!

Deep understand the parameter --filter

I'm confuse every time i have use the paramter --filter on Centreon

My situation that example i have this output:

Checking nic
Adapter HPE Ethernet 1Gb 4-port 369i Adapter - 'Port 3' status is 'Link Down'
Adapter HPE Ethernet 1Gb 4-port 369i Adapter - 'Port 2' status is 'Unknown'
Adapter HPE Ethernet 1Gb 4-port 369i Adapter - 'Port 1' status is 'OK'
Adapter HP Ethernet 1Gb 2-port 332T Adapter - 'Port 1' status is 'Unknown'
Adapter HP Ethernet 1Gb 2-port 332T Adapter - 'Port 2' status is 'OK'

Because only 2 of 5 nic has been use so i want to skip check on another 3 port (1 link Down and 2 Unknow) , example i try to use --filter "Adapternic,HPE Ethernet 1Gb 4-port 369i Adapter - Port 2' and it working but i don't understanding how it work ? so i want to know how it working and i can use the parameter in the future .

P/S: i have search but can't found how --filter working, not sure if --filter will working same method on all plugin or it will working diffrent for each plugin.

Thank you

Additional context
Add any other context or screenshots about the feature request here.

Mikrotik SNMP page in the docs is missing something ?

Hi,

On this page
https://docs.centreon.com/20.04/en/integrations/plugin-packs/procedures/network-mikrotik-snmp.html
It says to install the package centreon-plugin-Network-Mikrotik-Snmp with yum, which I did :

[root@monmaster ~]# yum install centreon-plugin-Network-Mikrotik-Snmp
Modules complémentaires chargés : fastestmirror
Loading mirror speeds from cached hostfile
 * base: centos.crazyfrogs.org
 * centos-sclo-rh: centos.crazyfrogs.org
 * centos-sclo-sclo: centos.crazyfrogs.org
 * epel: fr2.rpmfind.net
 * extras: centos.crazyfrogs.org
 * updates: centos.crazyfrogs.org
Résolution des dépendances
--> Lancement de la transaction de test
---> Le paquet centreon-plugin-Network-Mikrotik-Snmp.noarch 0:20210113-100416.el7.centos sera installé
--> Résolution des dépendances terminée

Dépendances résolues

==============================================================================================================================================================================================================================================
 Package                                                                 Architecture                             Version                                                      Dépôt                                                    Taille
==============================================================================================================================================================================================================================================
Installation :
 centreon-plugin-Network-Mikrotik-Snmp                                   noarch                                   20210113-100416.el7.centos                                   centreon-stable-noarch                                    64 k

Résumé de la transaction
==============================================================================================================================================================================================================================================
Installation   1 Paquet

Taille totale des téléchargements : 64 k
Taille d'installation : 450 k
Is this ok [y/d/N]: y
Downloading packages:
centreon-plugin-Network-Mikrotik-Snmp-20210113-100416.el7.centos.noarch.rpm                                                                                                                                            |  64 kB  00:00:00     
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Installation : centreon-plugin-Network-Mikrotik-Snmp-20210113-100416.el7.centos.noarch                                                                                                                                                  1/1 
  Vérification : centreon-plugin-Network-Mikrotik-Snmp-20210113-100416.el7.centos.noarch                                                                                                                                                  1/1 

Installé :
  centreon-plugin-Network-Mikrotik-Snmp.noarch 0:20210113-100416.el7.centos                                                                                                                                                                   

Terminé !

Then, it says to add a host in Centreon, and to choose "Net-Mikrotik-SNMP-custom" in "Templates".
But this template does not exists.

Should the yum command be enough to create this template, or is there something more to do ?

Using Centreon 20.10.0 installed with the official iso.

Thank you

Gorgone API's documentation missing

Hello,

Is your feature request related to a problem? Please describe.
The gorgone API's documentation is not available on our official documentation.

Describe the solution you'd like
The gorgone API's documentation needs to be available on our official documentation.

Regards.

Documentation of windows-winrm-wsman is truncated

Hello,

The following documentation in truncated :

https://docs.centreon.com/fr/pp/integrations/plugin-packs/getting-started/how-to-guides/windows-winrm-wsman-tutorial/

The last working link in the right side is :
[Accorder des autorisations pour les services]

All the following chapters are missing.

Regards.

Dead link in Oracle Database monitoring procedure

Describe the bug
dead link here:
https://github.com/centreon/centreon-documentation/blame/staging/versioned_docs/version-21.10/integrations/plugin-packs/procedures/applications-databases-oracle.md#L101
same for FR

to be replaced by:
https://www.oracle.com/fr/database/technologies/instant-client/linux-x86-64-downloads.html

Debian part missing

Hi,

In the https://docs.centreon.com/docs/administration/secure-platform documentation it is missing all the debian part.
When can this be achieved?

Examples:
What is the equivalent on debian for etc/centreon/centreon.conf.php?
Also i found that the file /usr/share/centreon/config/centreon.config.php is seeking for files that does not exist (lie 21-22).
Also, for debian, apache user is www-data, not apache

Same for the installation from packages, it seems the documentation for debian has been forked with no verification (i.e dnf does not exist on debian)

Filter some alarm centreon_vmware_connector_client

Hello all,
Currently i want to exclude some alert vCenter on Centreon, we know that this can be disable on vCenter but sadly that we don't manage it so it impossible.

here my command:

/usr/lib/centreon/plugins/centreon_vmware_connector_client.pl --plugin=apps::vmware::connector::plugin --mode=alarm-datacenter --custommode=connector --connector-hostname='localhost' --connector-port='5700' --container='vc353054' --filter --warning-status='%{status} =~ /yellow/i' --critical-status='%{status} =~ /red/i' --warning-total-alarm-warning='' --critical-total-alarm-warning='' --warning-total-alarm-critical='' --critical-total-alarm-critical='' --verbose --ignore-warn-msg --debug

the output:
checking datacenter 'EMEA-HCI2 Datacenter' warning: alarm [yellow] [HostSystem] [abc3.abc3] [196714Z] High pNic error rate detected. Check the host's vSAN performance view for details/Default alarm to monitor 'pNic Error Rate' critical: alarm [red] [HostSystem] [abc2.abc2] [974099Z] High pNic error rate detected. Check the host's vSAN performance view for details/Default alarm to monitor 'pNic Error Rate' warning: alarm [yellow] [HostSystem] [abc1.abc1] [196935Z] High pNic error rate detected. Check the host's vSAN performance view for details/Default alarm to monitor 'pNic Error Rate'

but i don't want alarm related to pNic Error Rate appear on Centreon, how can i fix that ?
Thank you

Missing macros in PP Microsoft WSUS NSClient++

In the list of macros in https://docs.centreon.com/docs/integrations/plugin-packs/procedures/applications-wsus-nsclient/#host-configuration, mandatory macros WSUSSERVER & WSUSPORT are not described:

Erreur sur la page d'installation du plugin Gsuite

Describe the bug
Sur la page d'installation du plugin Gsuite (https://docs.centreon.com/20.04/fr/integrations/plugin-packs/procedures/applications-google-gsuite-api.html) il y a une erreur dans la commande d'installation du plugin.

Expected behavior
Il faut modifier la commande décrite dans la partie "Installation", point 1 et l'autre point 1 un peu plus loin :
yum install centreon-plugin-centreon-plugin-Applications-Google-Gsuite-Api
pour
yum install centreon-plugin-Applications-Google-Gsuite-Api

ERROR - Could not install Centreon SELinux packages (RHEL9 - 24.04)

Describe the bug
We have an error installing the centreon-gorgoned-selinux package on repo 24.04 / RHEL 9

To Reproduce
24.04 script install on RHEL9 VM.
Launch the script.

Expected behavior
Correct execution of the script.

Screenshots

Erreur : Impossible de trouver une correspondance: centreon-gorgoned-selinux
2024-05-16 10:02:06+02:00 - ERROR - Could not install Centreon SELinux packages

Desktop (please complete the following information):

• Version: 24.04
• OS: RHEL9

Additional context
Looking at the documentation for version 24.04, we need to install the centreon-gorgoned-selinux package, but it doesn't seem to be available under this name in the repo.
On the other hand, there is the centreon-gorgone-selinux package:

Paquets disponibles
Nom          : centreon-gorgone-selinux
Version      : 24.04.0
Publication  : 1.el8
Architecture : noarch
Taille       : 19 k
Source       : centreon-gorgone-selinux-24.04.0-1.el8.src.rpm
Dépôt        : centreon-24.04-stable-noarch
Résumé       : Selinux for centreon-gorgone
URL          : https://www.centreon.com
Licence      : Apache-2.0
Description  : Selinux for centreon-gorgone
Commit       : 96e3edbb1a70378fb372f22141fbdd0484d9e221

# dnf repoquery -l centreon-gorgone-selinux
/usr/share/selinux/packages/centreon/centreon-gorgoned.pp