{"id":15510942,"url":"https://github.com/ghoneycutt/puppet-module-nrpe","last_synced_at":"2025-04-23T03:09:04.676Z","repository":{"id":11797299,"uuid":"14342135","full_name":"ghoneycutt/puppet-module-nrpe","owner":"ghoneycutt","description":"Puppet module to manage nrpe","archived":false,"fork":false,"pushed_at":"2020-06-30T19:19:12.000Z","size":110,"stargazers_count":1,"open_issues_count":5,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-18T14:06:38.905Z","etag":null,"topics":["monitoring","nrpe","nrpe-plugin","puppet"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"alibaba/tengine","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ghoneycutt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-12T19:03:57.000Z","updated_at":"2019-01-09T22:30:14.000Z","dependencies_parsed_at":"2022-09-14T08:13:40.304Z","dependency_job_id":null,"html_url":"https://github.com/ghoneycutt/puppet-module-nrpe","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghoneycutt%2Fpuppet-module-nrpe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghoneycutt%2Fpuppet-module-nrpe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghoneycutt%2Fpuppet-module-nrpe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghoneycutt%2Fpuppet-module-nrpe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghoneycutt","download_url":"https://codeload.github.com/ghoneycutt/puppet-module-nrpe/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250360490,"owners_count":21417721,"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":["monitoring","nrpe","nrpe-plugin","puppet"],"created_at":"2024-10-02T09:51:57.432Z","updated_at":"2025-04-23T03:09:04.649Z","avatar_url":"https://github.com/ghoneycutt.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# puppet-module-nrpe\n===\n\n[![Build Status](https://travis-ci.org/ghoneycutt/puppet-module-nrpe.png?branch=master)](https://travis-ci.org/ghoneycutt/puppet-module-nrpe)\n\nThis module allows you to manage NRPE and its plugins. It does not name any of\nthe plugins, so you can use whatever you like by specifying a hash of plugins\nand their associated parameters.\n\n===\n\n# Compatibility\n---------------\nThis module supports Puppet v3 (with and without the future parser), v4,\nv5 and v6 with Ruby versions 1.8.7, 1.9.3, 2.0.0, 2.1.9, 2.4.1 and 2.5.1.\nSee `.travis.yml` for an exact matrix.\n\nIt is tested on the following platforms.\n\n* Debian 6\n* Debian 8\n* EL 6\n* Suse 11\n* Solaris 10\n* Solaris 11\n* Ubuntu 12\n\n===\n\n# Class `nrpe`\n\n## Parameters\n\nnrpe_package\n------------\nName of package(s) for NRPE.\n\n- *Default*: based on OS platform.\n\nnrpe_package_ensure\n-------------------\nString to pass to ensure attribute for the NRPE package.\n\n- *Default*: 'present'\n\nnrpe_package_adminfile\n----------------------\nPath to admin file for NRPE package.\n\n- *Default*: based on OS platform. (used on Solaris)\n\nnrpe_package_source\n-------------------\nSource to NRPE package.\n\n- *Default*: based on OS platform. (used on Solaris)\n\nnrpe_package_provider\n-------------------\nName of the package provider for the NRPE package.\n\n- *Default*: undef.\n\nnagios_plugins_package\n----------------------\nName of package(s) for nagios-plugins.\n\n- *Default*: based on OS platform.\n\nnagios_plugins_package_ensure\n-----------------------------\nString to pass to ensure attribute for the nagios plugins package.\n\n- *Default*: 'present'\n\nnagios_plugins_package_adminfile\n--------------------------------\nPath to admin file for nagios-plugins package.\n\n- *Default*: based on OS platform. (used on Solaris)\n\nnagios_plugins_package_source\n-----------------------------\nSource to nagios-plugins package.\n\n- *Default*: based on OS platform. (used on Solaris)\n\nnrpe_config\n-----------\nPath to nrpe.cfg file.\n\n- *Default*: based on OS platform.\n\nnrpe_config_owner\n-----------------\nOwner of nrpe.cfg file.\n\n- *Default*: 'root'\n\nnrpe_config_group\n-----------------\nGroup of nrpe.cfg file.\n\n- *Default*: 'root'\n\nnrpe_config_mode\n----------------\nMode of nrpe.cfg file.\n\n- *Default*: '0644'\n\nlibexecdir\n----------\nDirectory in which nrpe plugins are stored.\n\n- *Default*: based on OS platform.\n\nlog_facility\n------------\nThe syslog facility that should be used for logging purposes.\n\n- *Default*: 'daemon'\n\npid_file\n--------\nFile in which the NRPE daemon should write it's process ID number. To disable the use of the pid_file parameter, specify the value as 'absent'.\n\n- *Default*: based on OS platform.\n\nserver_port\n-----------\nInteger port number for nrpe between 0 and 65535, inclusive.\n\n- *Default*: 5666\n\nserver_address_enable\n---------------------\nBoolean to include server_address in nrpe.cfg.\n\n- *Default*: false\n\nserver_address\n--------------\nAddress that nrpe should bind to in case there are more than one interface and you do not want nrpe to bind on all interfaces.\n\n- *Default*: '127.0.0.1'\n\nnrpe_user\n---------\nThis determines the effective user that the NRPE daemon should run as.\n\n- *Default*: based on OS platform\n\nnrpe_group\n---------\nThis determines the effective group that the NRPE daemon should run as.\n\n- *Default*: based on OS platform\n\nallowed_hosts\n-------------\nArray of IP address or hostnames that are allowed to talk to the NRPE daemon.\n\n- *Default*: ['127.0.0.1']\n\ndont_blame_nrpe\n---------------\nThis option determines whether or not the NRPE daemon will allow clients to specify arguments to commands that are executed. 0=do not allow arguments, 1=allow command arguments.\n\n- *Default*: '0'\n\nallow_bash_command_substitution\n-------------------------------\nDetermines whether or not the NRPE daemon will allow clients to specify arguments that contain bash command substitutions. 0=do not allow, 1=allow. Allowing is a **HIGH SECURITY RISK**.\n\n- *Default*: '0'\n\ncommand_prefix_enable\n---------------------\nBoolean to include command_prefix in nrpe.cfg.\n\n- *Default*: false\n\ncommand_prefix\n--------------\nPrefix all commands with a user-defined string. Must be a fully qualified path.\n\n- *Default*: '/usr/bin/sudo'\n\ndebug\n-----\nIf debugging messages are logged to the syslog facility. Values: 0=debugging off, 1=debugging on\n\n- *Default*: '0'\n\ncommand_timeout\n---------------\nMaximum number of seconds that the NRPE daemon will allow plugins to finish executing before killing them off.\n\n- *Default*: '60'\n\nconnection_timeout\n------------------\nMaximum number of seconds that the NRPE daemon will wait for a connection to be established before exiting.\n\n- *Default*: '300'\n\nallow_weak_random_seed\n----------------------\nAllows SSL even if your system does not have a /dev/random or /dev/urandom. Values: 0=only seed from /dev/[u]random, 1=also seed from weak randomness\n\n- *Default*: '0'\n\ninclude_dir\n-----------\nInclude definitions from config files (with a .cfg extension) recursively from specified directory.\n\n- *Default*: based on OS platform.\n\nservice_ensure\n--------------\nValue of ensure parameter for nrpe service. Valid values are 'running' and 'stopped'.\n\n- *Default*: 'running'\n\nservice_name\n--------------\nValue of name parameter for nrpe service.\n\n- *Default*: based on OS platform.\n\nservice_enable\n--------------\nBoolean value of enable parameter for nrpe service.\n\n- *Default*: true\n\nhiera_merge_plugins\n-------------------\nBoolean to control merges of all found instances of nrpe::plugins in Hiera. This is useful for specifying file resources at different levels of the hierarchy and having them all included in the catalog.\n\nThis will default to 'true' in future versions.\n\n- *Default*: false\n\nplugins\n-------\nHash of plugins to be passed to nrpe::plugin with create_resources().\n\n- *Default*: undef\n\npurge_plugins\n-------------\nBoolean to purge the nrpe.d directory of entries not managed by Puppet.\n\n- *Default*: false\n\n===\n\n# Define `nrpe::plugin`\n\nCreates a fragment in the sudoers.d directory with `$name.cfg`. Each matches the following layout, where `$args` are optional.\n\n\u003cpre\u003e\ncommand[$name]=${libexecdir}/${plugin} $args\n\u003c/pre\u003e\n\n## Usage\nYou can optionally specify a hash of nrpe plugins in Hiera.\n\n\u003cpre\u003e\n---\nnrpe::plugins:\n  check_root_partition:\n    plugin: 'check_disk'\n    libexecdir: '/usr/lib64/nagios/plugins'\n    args: '-w 20% -c 10% -p /'\n  check_load:\n    args: '-w 10,8,8 -c 12,10,9'\n  check_myapp:\n\u003c/pre\u003e\n\n## Parameters\n\nensure\n------\nEnsure the plugin exists. Valid values are `present` and `absent`.\n\n- *Default*: present\n\nargs\n----\nArguments to pass to the plugin.\n\n- *Default*: undef\n\nlibexecdir\n----------\nDirectory in which nrpe plugin is stored.\n\n- *Default*: $nrpe::libexecdir, which is based on OS platform.\n\ncommand_prefix\n--------------\nPrefix an individual plugin command with a user-defined string. Must be a fully qualified path. Set to `USE_DEFAULTS` to use the value from `$nrpe::command_prefix` (defaults to `/usr/bin/sudo`).\n\nPlease be careful when enabling `$nrpe::command_prefix_enable` and also setting `nrpe::plugin::command_prefix`.\n\n- *Default*: undef\n\nplugin\n------\nName of the plugin to be executed.\n\n- *Default*: $name\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghoneycutt%2Fpuppet-module-nrpe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghoneycutt%2Fpuppet-module-nrpe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghoneycutt%2Fpuppet-module-nrpe/lists"}