A full-featured monitoring event broker, compatible with MySQL, RRDtool, Graphite and more
C++ Python CMake C PLSQL Shell Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bam feat(lua): cache provides access to host/service groups and their mem… Mar 19, 2018
build chore(build): update version to 18.9.0. Jun 20, 2018
config Core: change the meaning of filters: read_filters and write_filters a… Sep 14, 2015
core feat(lua): new method get_state() on broker_socket Apr 27, 2018
correlation core: apply changes of shutdown exception class wherever it is used. Apr 12, 2017
doc feat(lua): new method get_state() on broker_socket Apr 27, 2018
dumper core: apply changes of shutdown exception class wherever it is used. Apr 12, 2017
generator core: apply changes of shutdown exception class wherever it is used. Apr 12, 2017
graphite feat(graphite): escape dots. Dec 13, 2017
influxdb fix(influxdb): correctly set default connection port to 8086 Dec 13, 2017
lua feat(lua): new method get_state() on broker_socket Apr 27, 2018
neb chore(build): update copyright information printed in cbd and neb mod… Mar 12, 2018
notification fix(notifications): minor compilation error. Feb 7, 2018
rrd RRD: update the second RRA to aggregate by the hour. Jul 12, 2017
script script: fix PID path variable in Debian startup script. Feb 14, 2017
sql sql: Reordering in alphabetical order fields in sql query. Sep 15, 2017
stats stats: normalize properties naming. Mar 22, 2017
storage feat(lua): add lua module Feb 6, 2018
tcp TCP: implement peer() in tcp::stream. Jun 20, 2017
test core: remove tmpnam() from sources and replace it with a mkstemp wrap… Dec 7, 2015
tls TLS: ensure that gcrypt library is properly locked when using GNU TLS… May 10, 2017
watchdog watchdog: update code style. May 24, 2017
.gitignore fix(bam): while the applier configures the ba, there was a segfault Mar 13, 2018
Jenkinsfile chore(build): update Jenkinsfile for Centreon 18.9 compatibility. Jun 20, 2018
LICENSE Change Centreon Broker license to Apache Software License version 2. Sep 9, 2015
README.md fix typo Jun 27, 2016
thanks.txt core: updating thanks.txt. Apr 20, 2017

README.md

Centreon Broker

Centreon Broker is an extensible open-source monitoring event transmitter (broker). It is a low-level component of the Centreon software suite.

Centreon Broker is released under the Apache License, Version 2.0 and is endorsed by the Centreon company.

Centreon Broker is the communication backbone of the Centreon software suite so most events are processed by one or more of its module. Centreon Broker has multiple modules that perform specific tasks. The list below describes the most common of them.

  • SQL: store real-time monitoring events in a SQL database
  • storage: parse and store performance data in a SQL database
  • RRD: write RRD graph files from monitoring performance data
  • BAM: compute Business Activity status and availability
  • Graphite: write monitoring performance data to Graphite
  • InfluxDB: write monitoring performance data to InfluxDB

Centreon Broker is extremely fast and is a credible alternative to the old NDOutils. It is also extremly modular and can fit most network security requirements. Just give it a try !

Documentation

The full Centreon Broker documentation is available online here. It is generated from ReST files located in the ./doc/ directory of Centreon Broker sources.

The documentation extensively covers all aspects of Centreon Broker such as installation, compilation, configuration, use and more. It is the reference guide of the software. This README is only provided as a quick introduction.

Installing from binaries

Warning: Centreon Broker is a low-level component of the Centreon software suite. If this is your first installation you would probably want to install it entirely.

Centreon (the company behind the Centreon software suite) provides binary packages for RedHat / CentOS. They are available either as part of the Centreon Entreprise Server distribution or as individual packages on our RPM repository.

Once the repository installed a simple command will be needed to install Centreon Broker.

$# yum install centreon-broker

Fetching sources

The reference repository is hosted at GitHub. Beware that the repository hosts in-development sources and that it might not work at all.

Stable releases are available as gziped tarballs on Centreon's download site.

Compilation (quickstart)

Warning: Centreon Broker is a low-level component of the Centreon software suite. If this is your first installation you would probably want to install it entirely.

This paragraph is only a quickstart guide for the compilation of Centreon Broker. For a more in-depth guide with build options you should refer to the online documentation.

Once the sources of Centreon Broker extracted, got to the ./build/ directory and launch the CMake command. This will look for required dependencies and print a summary of the compilation parameters if everything went fine.

$> cd centreon-broker/build
$> cmake .
...

Now launch the compilation using the make command and then install the software by running make install as priviledged user.

$> make -j 4
...
$# make install

You're done !

Bug reports / Feature requests

The best way to report a bug or to request a feature is to open an issue in GitHub's issue tracker.

Please note that Centreon Broker follows the same workflow as Centreon to process issues.

For a quick resolution of a bug your message should contain :

  • the problem description
  • precise steps on how to reproduce the issue (if you're using Centreon web UI tell us where you click)
  • the expected behavior
  • the Centreon products versions
  • the operating system you're using (name and version)
  • if possible configuration, log and debug files

Contributing

Contributions are much welcome ! If possible provide them as pull-requests on GitHub. If not, patches will do but describe against which version/commit they apply.

For any question or remark feel free to send a mail to the project maintainer : Matthieu Kermagoret (mkermagoret@centreon.com).