{"id":13584767,"url":"https://github.com/centreon/centreon-plugins","last_synced_at":"2025-05-15T06:07:19.543Z","repository":{"id":22343111,"uuid":"25678869","full_name":"centreon/centreon-plugins","owner":"centreon","description":"Collection of standard plugins to discover and gather cloud-to-edge metrics and status across your whole IT infrastructure. ","archived":false,"fork":false,"pushed_at":"2025-05-13T12:46:09.000Z","size":44263,"stargazers_count":318,"open_issues_count":157,"forks_count":289,"subscribers_count":57,"default_branch":"develop","last_synced_at":"2025-05-13T13:52:11.379Z","etag":null,"topics":["centreon","icinga2","monitor","monitoring-plugins","naemon","nagios-plugins","perl","snmp"],"latest_commit_sha":null,"homepage":"https://www.centreon.com","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/centreon.png","metadata":{"files":{"readme":"README.md","changelog":"changelog","contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2014-10-24T08:27:44.000Z","updated_at":"2025-05-12T16:27:20.000Z","dependencies_parsed_at":"2023-10-13T01:37:45.373Z","dependency_job_id":"f2866c93-d9eb-4a55-9c49-3170d7d0764a","html_url":"https://github.com/centreon/centreon-plugins","commit_stats":null,"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centreon%2Fcentreon-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/centreon","download_url":"https://codeload.github.com/centreon/centreon-plugins/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254283340,"owners_count":22045140,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["centreon","icinga2","monitor","monitoring-plugins","naemon","nagios-plugins","perl","snmp"],"created_at":"2024-08-01T15:04:30.516Z","updated_at":"2025-05-15T06:07:14.533Z","avatar_url":"https://github.com/centreon.png","language":"Perl","funding_links":[],"categories":["Perl","Nagios Monitoring"],"sub_categories":["Centreon"],"readme":"# centreon-plugins\n\n[![License](https://img.shields.io/badge/License-APACHE2-brightgreen.svg)](https://github.com/centreon/centreon-plugins/blob/master/LICENSE.txt)\n\n\u003c!-- SHIELDS --\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Stars][stars-shield]][stars-url]\n[![Forks][forks-shield]][forks-url]\n[![Issues][issues-shield]][issues-url]\n\n## What are Centreon Plugins\n\n[Centreon plugins](https://github.com/centreon/centreon-plugins/) is a free and open source project to monitor systems. The project can be used with Centreon and all monitoring softwares compatible with Nagios plugins.\n\n### Principles\n\n[Centreon plugins](https://github.com/centreon/centreon-plugins/) should comply with [Monitoring Plugins Development Guidelines](https://www.monitoring-plugins.org/doc/guidelines.html).\n\nIn short, they return:\n- An error code:\n    - `0` for `OK`\n    - `1` for `WARNING`\n    - `2` for `CRITICAL`\n    - `3` for `UNKNOWN`\n- A human understandable output message (example: `OK: CPU(s) average usage is 2.66 % - CPU '0' usage : 2.66 %`).\n- A set of metrics provided as *perfdata* after a `|` character (example: `'cpu.utilization.percentage'=2.66%;;;0;100 '0#core.cpu.utilization.percentage'=2.66%;;;0;100`).\n\n### What can Centreon Plugins monitor?\n\nYou can monitor many systems:\n* **Application**: Apache, Asterisk, Elasticsearch, Github, Jenkins, Kafka, Nginx, Pfsense, Redis, Tomcat, Varnish, etc.\n* **Cloud**: AWS, Azure, Docker, Office365, Nutanix, Prometheus, etc.\n* **Databases**: Firebird, Informix, MS SQL, MySQL, Oracle, Postgres, Cassandra.\n* **Hardware**: printers (RFC3805), UPS (Powerware, Mge, Standard), Sun Hardware, Cisco UCS, SensorIP, HP Proliant, HP Bladechassis, Dell Openmanage, Dell CMC, Raritan, etc.\n* **Network**: Aruba, Brocade, Bluecoat, Brocade, Checkpoint, Cisco AP/IronPort/ASA/Standard, Extreme, Fortigate, H3C, Hirschmann, HP Procurve, F5 BIG-IP, Juniper, PaloAlto, Redback, Riverbed, Ruggedcom, Stonesoft, etc.\n* **Operating systems**: Linux (SNMP, NRPE), Freebsd (SNMP), AIX (SNMP), Solaris (SNMP), etc.\n* **Storage**: EMC Clariion, Netapp, Nimble, HP MSA p2000, Dell EqualLogic, Qnap, Panzura, Synology, etc.\n\nTo get a complete list, run:\n\n```bash\nperl src/centreon_plugins.pl --list-plugin\n```\n\n### Basic Usage\n\nWe'll use a basic example to show you how to monitor a system. I have finished the install section and I want to monitor a Linux in SNMP.\nFirst, I need to find the plugin to use in the list:\n\n```bash\nperl centreon_plugins.pl --list-plugin | grep -i linux | grep 'PLUGIN'\n```\n\nIt will return:\n\n```\nPLUGIN: os::linux::local::plugin\nPLUGIN: os::linux::snmp::plugin\n```\n\nIt seems that 'os::linux::snmp::plugin' is the good one. So I verify with the option ``--help`` to be sure:\n\n    $ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --help\n    ...\n    Plugin Description:\n      Check Linux operating systems in SNMP.\n\nIt's exactly what I need. Now I'll add the option ``--list-mode`` to know what can I do with it:\n\n    $ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --list-mode\n    ...\n    Modes Available:\n     processcount\n     time\n     list-storages\n     disk-usage\n     diskio\n     uptime\n     swap\n     cpu-detailed\n     load\n     traffic\n     cpu\n     inodes\n     list-diskspath\n     list-interfaces\n     packet-errors\n     memory\n     tcpcon\n     storage\n\nI would like to test the 'load' mode:\n\n    $ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load\n    UNKNOWN: Missing parameter --hostname.\n\nIt's not working because some options are missing. I can have a description of the mode and options with the option ``--help``:\n\n    $ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load --help\n\nEventually, I have to configure some SNMP options:\n\n    $ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load --hostname=127.0.0.1 --snmp-version=2c --snmp-community=public\n    OK: Load average: 0.00, 0.00, 0.00 | 'load1'=0.00;;;0; 'load5'=0.00;;;0; 'load15'=0.00;;;0;\n\nI can set threshold with options ``--warning`` and ``--critical``:\n\n    $ perl centreon_plugins.pl --plugin=os::linux::snmp::plugin --mode=load --hostname=127.0.0.1 --snmp-version=2c --snmp-community=public --warning=1,2,3 --critical=2,3,4\n    OK: Load average: 0.00, 0.00, 0.00 | 'load1'=0.00;0:1;0:2;0; 'load5'=0.00;0:2;0:3;0; 'load15'=0.00;0:3;0:4;0;\n\nFor more information or help, please read ['doc/en/user/guide.rst'](./doc/en/user/guide.rst).\n\n## Contributions\n\n### Code contributions/pull requests\n\nIf you want to contribute by submitting new functionalities, enhancements or bug fixes, first thank you for participating :-)\nThen have a look, if not already done, to our **[development guide](https://github.com/centreon/centreon-plugins/blob/develop/doc/en/developer/guide.md)**.\nThen create a [fork](https://github.com/centreon/centreon-plugins/fork) and a development branch, and once it's done, you may submit a [pull request](https://github.com/centreon/centreon-plugins/pulls) that the corporate development team will examine.\n\n### Issues/bug reports\n\nIf you encounter a behaviour that is clearly a bug or a regression, you are welcome to submit an [issue](https://github.com/centreon/centreon-plugins/issues). Please be aware that this is an open source project and that there is no guaranteed response time.\n\n### Questions/search for help\n\nIf you have trouble using our plugins, but are not sure whether it's due to a bug or a misuse, please take the time to ask for help on [The Watch, Data Collection section](https://thewatch.centreon.com/data-collection-6) and become certain that it is a bug before submitting it here.\n\n### Feature/enhancement request\n\nThere is high demand for new plugins and new functionalities on existing plugins, so we have to rely on our community to help us prioritize them.\nHow? Post your suggestion on [The Watch Ideas](https://thewatch.centreon.com/ideas) with as much detail as possible and we will pick the most voted topics to add them to our product roadmap.\n\nTo develop a plugin/mode, we need the following information, depending on the protocol:\n* **SNMP**: MIB files and full snmpwalk of enterprise branch (`snmpwalk -ObentU -v 2c -c public address .1.3.6.1.4.1 \u003e equipment.snmpwalk`) or [SNMP collections](https://thewatch.centreon.com/product-how-to-21/snmp-collection-tutorial-132).\n* **HTTP API (SOAP, Rest/Json, XML-RPC)**: the documentation and some curl examples or HTTP [collections](https://thewatch.centreon.com/data-collection-6/centreon-plugins-discover-collection-modes-131).\n* **CLI**: command line examples (command + result).\n* **SQL**: queries + results + column types or [SQL collections](https://thewatch.centreon.com/product-how-to-21/sql-collection-tutorial-134).\n* **JMX**: mbean names and attributes.\n\nIf some information is confidential, such as logins or IP addresses, obfuscate them in what is sent publicly and we'll get in touch with you by private message if this information is needed.\n\nPlease note that all the developments are open source, we will not commit to a release date. If it is an emergency for you, please contact [Centreon's sales team](https://www.centreon.com/contact/).\n\n### Continuous integration\n\nPlease follow documentation [here](./doc/CI.md)\n\n\u003c!-- URL AND IMAGES FOR SHIELDS --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/centreon/centreon-plugins?color=%2384BD00\u0026label=CONTRIBUTORS\u0026style=for-the-badge\n[stars-shield]: https://img.shields.io/github/stars/centreon/centreon-plugins?color=%23433b02a\u0026label=STARS\u0026style=for-the-badge\n[forks-shield]: https://img.shields.io/github/forks/centreon/centreon-plugins?color=%23009fdf\u0026label=FORKS\u0026style=for-the-badge\n[issues-shield]: https://img.shields.io/github/issues/centreon/centreon-plugins?color=%230072ce\u0026label=ISSUES\u0026style=for-the-badge\n\n[contributors-url]: https://github.com/centreon/centreon-plugins/graphs/contributors\n[forks-url]: https://github.com/centreon/centreon-plugins/network/members\n[stars-url]: https://github.com/centreon/centreon-plugins/stargazers\n[issues-url]: https://github.com/centreon/centreon-plugins/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcentreon%2Fcentreon-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcentreon%2Fcentreon-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcentreon%2Fcentreon-plugins/lists"}