{"id":18497672,"url":"https://github.com/centreon/centreon-collect","last_synced_at":"2026-03-16T12:09:32.542Z","repository":{"id":37084107,"uuid":"261475996","full_name":"centreon/centreon-collect","owner":"centreon","description":"Centreon collect software collection","archived":false,"fork":false,"pushed_at":"2026-01-12T17:47:33.000Z","size":128089,"stargazers_count":15,"open_issues_count":29,"forks_count":5,"subscribers_count":17,"default_branch":"develop","last_synced_at":"2026-01-12T18:00:33.662Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/centreon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-05-05T13:21:10.000Z","updated_at":"2026-01-09T08:27:13.000Z","dependencies_parsed_at":"2023-10-12T14:19:24.662Z","dependency_job_id":"5bad34b1-7998-4818-be4f-47814bb9caa7","html_url":"https://github.com/centreon/centreon-collect","commit_stats":null,"previous_names":[],"tags_count":212,"template":false,"template_full_name":null,"purl":"pkg:github/centreon/centreon-collect","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-collect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-collect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-collect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-collect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/centreon","download_url":"https://codeload.github.com/centreon/centreon-collect/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-collect/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28565872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T08:53:44.001Z","status":"ssl_error","status_checked_at":"2026-01-19T08:52:40.245Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T13:35:19.249Z","updated_at":"2026-01-19T11:00:58.546Z","avatar_url":"https://github.com/centreon.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Centreon Collect                                                                 \n                                                                                   \nCentreon Collect is a collection of softwares:                                                                                     \n  * [Centreon Engine](#centreon-engine)                                                         \n  * [Centreon Broker](#centreon-broker)                                                            \n  * [Centreon Connector](#centreon-connector) \n  * [Centreon Monitoring Agent](#centreon-monitoring-agent-cma)      \n                                                   \nCentreon Collect brings also [Centreon tests](centreon-tests/README.md) to test these softwares.\n\n## Centreon Engine                                                                 \n                                                                                   \nCentreon Engine is a fast and powerful open-source monitoring scheduler.           \nIt is a low-level component of the                                                 \n[Centreon software suite](https://www.centreon.com).                               \n                                                                                   \nCentreon Engine is released under the General Public License version 2             \nand is endorsed by the [Centreon company](https://www.centreon.com).               \n                                                                                   \nThis project was started as a fork of Nagios, the well known open-source           \nmonitoring application. While keeping its configuration file format and            \nits stability we improved it in several ways:                                      \n                                                                                   \n- Reduced startup time                                                             \n- Faster standard check execution engine                                           \n- New light check execution system (connectors)                                    \n- On-the-fly configuration reload                                                  \n- Less obscure configuration options                                               \n- Frequent bugfix releases                                                         \n                                                                                   \nJust give it a try!                                                                \n                                                                                   \n## Centreon Broker                                                                  \n                                                                                   \nCentreon Broker is an extensible open-source monitoring event                      \ntransmitter (broker). It is a low-level component of the                           \n[Centreon software suite](https://www.centreon.com).                               \n                                                                                   \nCentreon Broker is released under the Apache License, Version 2.0                  \nand is endorsed by the [Centreon company](https://www.centreon.com).               \n                                                                                   \nCentreon Broker is the communication backbone of the Centreon software             \nsuite so most events are processed by one or more of its module.                   \nCentreon Broker has multiple modules that perform specific tasks. The              \nlist below describes the most common of them.                                      \n                                                                                   \n- SQL: store real-time monitoring events in a SQL database                         \n- storage: parse and store performance data in a SQL database                      \n- RRD: write RRD graph files from monitoring performance data                      \n- BAM: compute Business Activity status and availability                           \n- Graphite: write monitoring performance data to Graphite                          \n- InfluxDB: write monitoring performance data to InfluxDB                          \n                                                                                   \nCentreon Broker is extremely fast and is a credible alternative to the             \nold NDOutils. It is also extremly modular and can fit most network                 \nsecurity requirements. Just give it a try!                                         \n                                                                                   \n## Centreon Connector                                                             \n                                                                                   \nCentreon Connector is extremely fast open-source monitoring check                \nexecution daemons designed to work with [Centreon Engine](https://github.com/centreon/centreon-collect).                    \n                                                                                   \nIt is a low-level component of the                                                 \n[Centreon software suite](https://www.centreon.com).                               \n                                                                                   \nCentreon Connector is released under the Apache Software License version 2       \nand is endorsed by the [Centreon company](https://www.centreon.com).               \n                                                                                   \nThere are currently two open-source connectors :                                   \n                                                                                   \n- **Centreon Connector Perl** : persistent Perl interpreter that                   \n  executes Perl plugins very fast                                                  \n- **Centreon Connector SSH** : maintain SSH connexions opened to reduce            \n  overhead of plugin execution over SSH     \n\n## Centreon Monitoring Agent (CMA)\n\nThe **Centreon Monitoring Agent** is a lightweight, asynchronous service designed to monitor system health and metrics on Windows and Linux hosts degined to work with [Centreon Engine](https://github.com/centreon/centreon-collect).\n\nMore information [CMA](https://github.com/centreon/centreon-collect/blob/develop/agent/doc/agent-doc.md)\n\n## Documentation\n\n*https://docs.centreon.com*\n\n## Installing from binaries\n\n\u003e Centreon Collect is a low-level component of the Centreon\n\u003e software suite. If this is your first installation you would probably\n\u003e want to [install it entirely](https://docs.centreon.com/current/en/installation/installation-of-a-central-server/using-sources.html).\n\nCentreon ([the company behind the Centreon software suite](http://www.centreon.com))\nprovides binary packages for RedHat / CentOS. They are available either\nas part of the [Centreon Platform](https://www.centreon.com/en/platform/)\nor as individual packages on [our RPM repository](https://docs.centreon.com/current/en/installation/installation-of-a-poller/using-packages.html).\n\nOnce the repository installed a simple command will be needed to install\nCentreon Collect.\n\n```shell\nyum install centreon-broker centreon-clib centreon-connector centreon-engine\n```\n\n## Fetching sources\n\nBeware that the repository hosts in-development sources and that it\nmight not work at all.\n\nStable releases are available as gziped tarballs on [Centreon's\ndownload site](https://download.centreon.com).\n\n## Compilation\n\nThis paragraph is only a quickstart guide for the compilation of\nCentreon Collect.\n\n### CentOS / Debian / Raspbian / Ubuntu\n\nCompilation of these distributions is pretty straightforward.\n\n#### Packages to install\n\nOn Debian/Raspbian/Ubuntu, you should install these packages:\n\n```shell\napt install librrd-dev libgnutls28-dev liblua5.3-dev libperl-dev libgcrypt20-dev libssl-dev libssh2-1-dev zlib1g-dev libcurl4-openssl-dev\n```\n\nOn CentOS, you should install these packages:\n\n```shell\ndnf install gnutls-devel libgcrypt-devel lua-devel rrdtool-devel selinux-policy-devel openssl-devel libssh2-devel libcurl-devel zlib-devel\n```\n\nAnd you'll probably need to enable some repos for the installation to succeed, for example:\n\n```shell\ndnf config-manager --set-enabled powertools\ndnf update\n```\n\n#### Compilation\n\nYou'll need to download the project and launch the *cmake-vcpkg.sh* script to prepare the compilation environment:\n\n```shell\ngit clone https://github.com/centreon/centreon-collect\ncd centreon-collect\n./cmake-vcpkg.sh\n```\n\nNow launch the compilation using the *make* command and then install the\nsoftware by running *make install* as priviledged user:\n\n```shell\nmake -Cbuild\nmake -Cbuild install\n```\n\n**Remark. ** The cmake-vcpkg.sh initializes two environment variables like this:\n* `VCPKG_ROOT=`*path to centreon-collect*`/vcpkg`\n* `PATH=$VCPKG_ROOT:$PATH`\n\nThese two variables are very important if you want to recompile the project later.\n\n\n### Other distributions\n\nIf you are on another distribution, then follow the steps below.\n\nCheck if you have these packages installed (Note that packages names\ncome from CentOS distributions, so if some packages names don't match\non your distribution try to find their equivalent names): git, make, cmake, gcc-c++, python3, libgnutls-devel, liblua-devel, librrd-devel, openssl-devel, zlib-devel, libcurl-devel, libssh2-devel.\n\nYou can now prepare the compilation environment:\n\n```shell\ngit clone https://github.com/centreon/centreon-collect\ncd centreon-collect\nexport VCPKG_ROOT=$PWD/vcpkg\nexport PATH=$VCPKG_ROOT:$PATH\ngit clone -b 2024.01.12 https://github.com/Microsoft/vcpkg.git\n./vcpkg/bootstrap-vcpkg.sh\nmkdir build\ncmake -B build \\\n      -DVCPKG_OVERLAY_TRIPLETS=custom-triplets \\\n      -DVCPKG_TARGET_TRIPLET=x64-linux-release \\\n      -DVCPKG_OVERLAY_PORTS=overlays \\\n      -DWITH_TESTING=On \\\n      -DWITH_CREATE_FILES=OFF \\\n      -DWITH_CONF=OFF \\\n      -S .\n```\n\nThis will look for required dependencies and print a summary of the\ncompilation parameters if everything went fine.\n\nNow launch the compilation using the *make* command and then install the\nsoftware by running *make install* as priviledged user:\n\n```shell\nmake -Cbuild\nmake -Cbuild install\n```\n\nNormally if all compiles, you have finished installing Collect. But if\nyou want, you can also check it. From the *build* directory you\ncan execute these commands:\n\n```shell\ntests/ut_broker\ntests/ut_engine\n```\n\nYou're done!\n\n### Inside a docker, ubuntu for example\nIn my case I have the home directory of the centreon project in /data/dev/centreon-collect\n\nFirst create the ubuntu container and jump into\n```shell\ndocker container run --name ubuntu22.04 -ti -v /data/dev/centreon-collect:/root/centreon-collect  ubuntu:22.04 /bin/bash\n```\nNow you are in your ubuntu container\n```shell\ncd /root/centreon-collect/\napt install librrd-dev libgnutls28-dev liblua5.3-dev libperl-dev libgcrypt20-dev libssl-dev libssh2-1-dev zlib1g-dev libcurl4-openssl-dev cmake\n./cmake-vcpkg.sh \nmake -Cbuild\nmake -Cbuild install\n```\nThen you have all binaries compiled in the ubuntu distribution.\nYou can access it outside the container in the /data/dev/centreon-collect/build directory\n\n### Windows \n Only the Centreon Monitoring Agent and the CMA installer can be compiled on Windows\n#### Prerequisites\nTo compile the agent, ensure the following tools are installed::\n* [Msbuild tools](https://visualstudio.microsoft.com/downloads/) install desktop development with C++\n* [Git](https://git-scm.com/downloads/win)\n* [NSIS](https://sourceforge.net/projects/nsis/files/NSIS%202/)\n* [PowerShell Core](https://github.com/PowerShell/PowerShell/releases)\n#### Compiling the Agent\nThen you have to:\n* Add NSIS path to environment variables\n* Open x64 Native Tools Command Prompt for VS\n```shell\ncd centreon-collect/\ncentreon_cmake.bat\n ```\n When Executing centreon_cmake.bat. It first installs vcpkg in your home directory and then Prompt you to set two environment variables: VCPKG_ROOT and PATH. \n\u003e ⚠️ **Warning:** However, be aware that each time you open a new x64 Native Tools Command Prompt, it may set VCPKG_ROOT to an incorrect value by default.\nYou will need to manually reset VCPKG_ROOT to the correct path before building again\n\n* Then install agent\\conf\\agent.reg in the registry and modify parameters such as server, certificates or logging.\n\n!!! note  \n    To compile the agent with the installer add the option : DWITH_BUILD_AGENT_INSTALLER=On\n\n## Bug reports / Feature requests\n\nThe best way to report a bug or to request a feature is to open an issue\nin GitHub's [issue tracker](https://github.com/centreon/centreon-collect/issues/).\n\nPlease note that Centreon Collect follows the\n[same workflow as Centreon](https://github.com/centreon/centreon/issues/new/choose)\nto process issues.\n\nFor a quick resolution of a bug your message should contain:\n\n- The problem description\n- Precise steps on how to reproduce the issue (if you're using Centreon\n  web UI tell us where you click)\n- The expected behavior\n- The Centreon product**s** version**s**\n- The operating system you're using (name and version)\n- If possible configuration, log and debug files\n\n## Contributing\n\nContributions are much welcome! If possible provide them as\npull-requests on GitHub. If not, patches will do but describe against\nwhich version/commit they apply.\n\nFor any question or remark feel free to send a mail to the project\nmaintainers:\n\n\u003ca href=\"https://github.com/bouda1\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/6324413?s=400\u0026v=4\" title=\"David Boucher\" width=\"80\" height=\"80\"\u003e\u003c/a\u003e \u0026nbsp;\n\u003ca href=\"https://github.com/jean-christophe81\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/98889244?v=4\" title=\"Jean-Christophe Roques\" width=\"80\" height=\"80\"\u003e\u003c/a\u003e \u0026nbsp;\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcentreon%2Fcentreon-collect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcentreon%2Fcentreon-collect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcentreon%2Fcentreon-collect/lists"}