{"id":21954877,"url":"https://github.com/thefox/nagios-plugins","last_synced_at":"2026-04-18T02:06:51.378Z","repository":{"id":138668582,"uuid":"130550267","full_name":"TheFox/nagios-plugins","owner":"TheFox","description":"A collection of Nagios Plugins.","archived":false,"fork":false,"pushed_at":"2019-09-26T18:36:00.000Z","size":48,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-22T18:45:04.562Z","etag":null,"topics":["api","bitcoin","bitcoin-price","burningseries","coinmarketcap","ethereum","github","json-rpc","nagios","nagios-plugins","rpc","ruby","rubygems","series","tvseries","twitter","twitter-followers"],"latest_commit_sha":null,"homepage":"https://fox21.at","language":"Ruby","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/TheFox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG-v0.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-22T08:47:05.000Z","updated_at":"2023-06-07T01:38:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"35fad828-2052-46a4-a5b3-e9365c2cc452","html_url":"https://github.com/TheFox/nagios-plugins","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/TheFox/nagios-plugins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fnagios-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fnagios-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fnagios-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fnagios-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheFox","download_url":"https://codeload.github.com/TheFox/nagios-plugins/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheFox%2Fnagios-plugins/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31953517,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["api","bitcoin","bitcoin-price","burningseries","coinmarketcap","ethereum","github","json-rpc","nagios","nagios-plugins","rpc","ruby","rubygems","series","tvseries","twitter","twitter-followers"],"created_at":"2024-11-29T07:26:27.613Z","updated_at":"2026-04-18T02:06:51.341Z","avatar_url":"https://github.com/TheFox.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nagios Plugins\n\nA collection of my [Nagios](https://www.nagios.org/) plugins.\n\n## Check Bitcoin Price Nagios Plugin\n\nScript: [check_bitcoin_price.rb](check_bitcoin_price.rb)\n\nA plugin for checking the Bitcoin price.\n\nThis plugin lets you check every crypto currency listed on [Coin Market Cap](https://coinmarketcap.com/). It uses the [Ticker (Specific Currency) API](https://coinmarketcap.com/api/) to the get the current price of your favourite crypto currency. You can choose every fiat currency listed on Coin Market Cap.\n\n![](https://img.fox21.at/public/20180501/nagios_btc_s.png)\n\n### Usage\n\nSince this plugin doesn't rely on a specific host you can add it to any existing host. Or you can just create a fake host like example.com.\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n    command_name    check_bitcoin_price_above\n    command_line    $USER1$/check_bitcoin_price.rb --coin $ARG1$ --fiat $ARG2$ -w $ARG3$ -c $ARG4$\n}\n\ndefine command{\n    command_name    check_bitcoin_price_below\n    command_line    $USER1$/check_bitcoin_price.rb --coin $ARG1$ --fiat $ARG2$ -w $ARG3$ -c $ARG4$ --below\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# fake.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               fake\n    alias                   FAKE\n    address                 www.example.com\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             BTC Above\n    check_command                   check_bitcoin_price_above!bitcoin!EUR!6800!7000\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             ETH Below\n    check_command                   check_bitcoin_price_below!ethereum!EUR!400!320\n}\n```\n\n## Check Burning Series Nagios Plugin\n\nScript: [check_bsto_series.rb](check_bsto_series.rb)\n\nThere is this site called [Burning Series](https://bs.to) where you can watch and download TV series for free. The default language for new episodes is English. But the target language is German. They only offer English and German.\n\nThis plugin let you set a notifcation about new episodes on Burning Series for each series they host.\n\n![](https://img.fox21.at/public/20180422/nagios_s.png)\n\n### Usage\n\nSince this plugin doesn't rely on a specific host you can add it to any existing host. Or you can just create a fake host like example.com.\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name\tcheck_bsto_series\n\tcommand_line\t$USER1$/check_bsto_series.rb --series \"$ARG1$\" --season $ARG2$ -w $ARG3$ -c $ARG4$ --lang $ARG5$\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# fake.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               fake\n    alias                   FAKE\n    address                 www.example.com\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             Family Guy\n    check_command                   check_bsto_series!Family-Guy!15!19!20!de\n}\n```\n\n## Check Twitter Followers Nagios Plugin\n\nScript: [check_twitter_followers.rb](check_twitter_followers.rb)\n\nThis script checks the Twitter Followers of any given user.\n\nIt has 3 different operation modes.\n\n1. Check Twitter Followers Above\n2. Check Twitter Followers Below\n3. Collect Data\n\nThe 3. one always returns OK state. This is only for collecting data, for example to show in a graph. 1 and 2 are designed to send you a notifcation.\n\n![](https://img.fox21.at/public/20180424/nagios_s.png)\n\n### Usage\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name\tcheck_twitter_followers_onlydata\n\tcommand_line\t$USER1$/check_twitter_followers.rb -u $ARG1$\n}\n\ndefine command{\n\tcommand_name\tcheck_twitter_followers_above\n\tcommand_line\t$USER1$/check_twitter_followers.rb -u $ARG1$ -w $ARG2$ -c $ARG3$ --above\n}\n\ndefine command{\n\tcommand_name\tcheck_twitter_followers_below\n\tcommand_line\t$USER1$/check_twitter_followers.rb -u $ARG1$ -w $ARG2$ -c $ARG3$\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# fake.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               fake\n    alias                   FAKE\n    address                 www.example.com\n}\n\ndefine service{\n    use                             generic-service,graphed-service\n    host_name                       fake\n    service_description             Twitter Followers wikileaks\n    check_command                   check_twitter_followers_onlydata!wikileaks\n}\n\ndefine service{\n    use                             generic-service,graphed-service\n    host_name                       fake\n    service_description             Twitter Followers briankrebs\n    check_command                   check_twitter_followers_below!briankrebs!222000!200000\n}\n```\n\n## Check Ethereum JSON-RPC Nagios Plugin\n\nScript: [check_ethereum_rpc.rb](check_ethereum_rpc.rb)\n\nThis script lets you check every value provided by the [Ethereum JSON-RPC API](https://github.com/ethereum/wiki/wiki/JSON-RPC).\n\nWhen you use [go-ethereum](https://github.com/ethereum/go-ethereum) (geth) you have to add `--rpc` to the cli options to activate the RPC.\n\n![](https://img.fox21.at/public/20180428/nagios_s.png)\n\n### Usage\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name check_ethereum_rpc_above\n\tcommand_line $USER1$/check_ethereum_rpc.rb -H $ARG1$ -p $ARG2$ -w $ARG3$ -c $ARG4$ $ARG5$ $ARG6$\n}\n\ndefine command{\n\tcommand_name check_ethereum_rpc_below\n\tcommand_line $USER1$/check_ethereum_rpc.rb -H $ARG1$ -p $ARG2$ -w $ARG3$ -c $ARG4$ $ARG5$ $ARG6$\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# server1.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               server1\n    alias                   Server1\n    address                 server1.dev\n}\n\ndefine service{\n    use                             generic-service,graphed-service\n    host_name                       server1\n    service_description             Ethereum Sync 3m\n    check_command                   check_nrpe_ethereum_rpc_above!127.0.0.1!8545!2999999!3000000!eth_syncing!currentBlock\n}\n\ndefine service{\n    use                             generic-service,graphed-service\n    host_name                       server1\n    service_description             Ethereum Block 6m\n    check_command                   check_nrpe_ethereum_rpc_above!127.0.0.1!8545!5990000!6000000!eth_syncing!highestBlock\n}\n```\n\n## Check IMDb Nagios Plugin\n\nScript: [check_imdb.rb](check_imdb.rb)\n\nThis script can be used to check the end of a TV series on [IMDb](https://www.imdb.com/). You either provide the full URL to the IMDb page or only the Title ID.\n\nFor example, the full URL to *Family Guy* is \u003chttps://www.imdb.com/title/tt0182576/\u003e. The last part of the URL, `tt0182576`, would be the Title ID.\n\n![](https://img.fox21.at/public/20180501/nagios_imdb_s.png)\n\n![](https://img.fox21.at/public/20180501/nagios_imdb_bb_s.png)\n\n### Usage\n\nSince this plugin doesn't rely on a specific host you can add it to any existing host. Or you can just create a fake host like example.com.\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name\tcheck_imdb_series\n\tcommand_line\t$USER1$/check_imdb.rb --title $ARG1$ --series\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# fake.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               fake\n    alias                   FAKE\n    address                 www.example.com\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             Family Guy\n    check_command                   check_imdb_series!tt0182576\n}\n```\n\n## Check Git Commit Age Nagios Plugin\n\nScript: [check_git_commit_age.rb](check_git_commit_age.rb)\n\nThis script can be used to check the age of the last commit of a specific Git repository. Sometimes you are not always aware when your favourite Software project gets abandoned. This Nagios plugin can you help to get notified when the last commit of a certain Git repository reaches a specific age.\n\n![](https://img.fox21.at/public/20180531/nagios_20180531_120958_s.png)\n\n## Usage\n\nSince this plugin doesn't rely on a specific host you can add it to any existing host. Or you can just create a fake host like example.com.\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name\tcheck_git_commit_age\n\tcommand_line\t$USER1$/check_git_commit_age.rb --repository $ARG1$ --destination $ARG2$ -w $ARG3$ -c $ARG4$\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# fake.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               fake\n    alias                   FAKE\n    address                 www.example.com\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             Git Commit Age: ethereum/go-ethereum\n    check_command                   check_git_commit_age!https://github.com/ethereum/go-ethereum.git!/tmp/geth!1d!2d\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             Git Commit Age: ansible\n    check_command                   check_git_commit_age!https://github.com/ansible/ansible.git!/tmp/ansible!1d!2d\n}\n```\n\nTime string examples:\n\n- `3y` = 3 Years\n- `1M` = 1 Month\n- `2w` = 2 Weeks\n- `1d` = 1 Day\n- `23h` = 23 Hours\n- `5m` = 5 Minutes\n- `230s` = 230 Seconds\n- `250` = 250 Seconds\n\n## Check GitHub Release Nagios Plugin\n\nScript: [check_github_release.rb](check_github_release.rb)\n\nThis script can be used to check a release of a [GitHub](https://github.com/) Repository. You can either choose a specific version, or dynamic. When checking the version dynamically you specify a command (`--cmd`) and a [regular expression](https://en.wikipedia.org/wiki/Regular_expression) (`--cmdregexp`) to read the current version from the installed software.\n\n![](https://img.fox21.at/public/20180531/nagios_20180531_121323_s.png)\n\n## Usage\n\nSince this plugin doesn't rely on a specific host you can add it to any existing host. Or you can just create a fake host like example.com.\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name\tcheck_github_release_fix\n\tcommand_line\t$USER1$/check_github_release.rb --name $ARG1$ -w $ARG2$ -c $ARG3$\n}\n\ndefine command{\n\tcommand_name\tcheck_github_release_cmd\n\tcommand_line\t$USER1$/check_github_release.rb --name $ARG1$ --cmd '$ARG2$' --cmdregexp '$ARG3$'\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# fake.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               fake\n    alias                   FAKE\n    address                 www.example.com\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             GitHub: ethereum/go-ethereum\n    check_command                   check_github_release_fix!ethereum/go-ethereum!1.8.9!1.9\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             GitHub: ethereum/go-ethereum\n    check_command                   check_github_release_cmd!ethereum/go-ethereum!geth version!^Version: (\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})\n}\n```\n\n## Check (Ruby) Gem Release Nagios Plugin\n\nScript: [check_gem_release.rb](check_gem_release.rb)\n\nThis script can be used to check a release of a [RubyGems](https://rubygems.org/) Repository.\n\n![](https://img.fox21.at/public/20180603/nagios_20180603_130835_s.png)\n\n## Usage\n\nSince this plugin doesn't rely on a specific host you can add it to any existing host. Or you can just create a fake host like example.com.\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name\tcheck_gem_release\n\tcommand_line\t$USER1$/check_gem_release.rb -n $ARG1$ -w $ARG2$ -c $ARG3$\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# fake.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               fake\n    alias                   FAKE\n    address                 www.example.com\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       fake\n    service_description             Gem Release: redcarpet\n    check_command                   check_gem_release!redcarpet!3.4.1!3.5.0\n}\n```\n\n## Check File Type Nagios Plugin\n\n![](https://img.fox21.at/public/20180531/nagios_20180531_125102_s.png)\n\n### Usage\n\nHere is an example **Commands** configuration:\n\n```\n# commands.cfg\n\ndefine command{\n\tcommand_name\tcheck_file_type\n\tcommand_line\t$USER1$/check_file_type.rb --file $ARG1$ --regexp $ARG2$\n}\n```\n\nHere is an example **Host** configuration:\n\n```\n# localhost.cfg\n\ndefine host{\n    use                     generic-host\n    host_name               localhost\n    alias                   Localhost\n    address                 localhost\n}\n\ndefine service{\n    use                             generic-service\n    host_name                       localhost\n    service_description             File Type: /tmp/test.txt\n    check_command                   check_file_type!/tmp/test.txt!ASCII\n}\n```\n\n## License\n\nCopyright (C) 2018 Christian Mayer \u003chttps://fox21.at\u003e\n\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthefox%2Fnagios-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthefox%2Fnagios-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthefox%2Fnagios-plugins/lists"}