{"id":15048349,"url":"https://github.com/github/nagioseasier-module","last_synced_at":"2026-01-10T21:43:54.404Z","repository":{"id":65974873,"uuid":"22369878","full_name":"github/nagioseasier-module","owner":"github","description":"Make nagios easier to use, because you deserve it.","archived":true,"fork":true,"pushed_at":"2014-07-29T07:25:54.000Z","size":186,"stargazers_count":10,"open_issues_count":0,"forks_count":14,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-09-30T00:41:54.244Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"wfarr/nagioseasier-module","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/github.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":"2014-07-29T06:25:22.000Z","updated_at":"2024-07-31T03:22:31.000Z","dependencies_parsed_at":"2023-02-19T18:00:59.278Z","dependency_job_id":null,"html_url":"https://github.com/github/nagioseasier-module","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fnagioseasier-module","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fnagioseasier-module/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fnagioseasier-module/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fnagioseasier-module/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/github","download_url":"https://codeload.github.com/github/nagioseasier-module/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235238018,"owners_count":18958033,"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":[],"created_at":"2024-09-24T21:11:03.751Z","updated_at":"2025-10-04T10:30:43.843Z","avatar_url":"https://github.com/github.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nagios Easier\n\nOnce upon a time, some pretty all right folks wrote a tool [nagiosharder](https://github.com/railsmachine/nagiosharder). It allowed you to interact with Nagios without having to load the web interface. It was pretty all right too, but due to the nature of screen scraping, it tended to break whenever Nagios versions changed (that's no fun!) and meant more screen scraping had to be done for all sorts of nested tables.\n\nNagios Easier attempts to provide a similarly useful interface, but using the new Query Handler support in Nagios 4. This allows us to interact with Nagios using a Unix domain socket. Since this API is standardized, it's a lot less brittle than worrying about screen scraping 5x nested tables.\n\n## Installation\n\n### Dependencies\n\n* nagios\n* libltdl-dev\n\n### Building\n\nThen you should just be able to build this with:\n\n```\nmake\n```\n\nAnd then you'll get a `nagioseasier.so` file. You can put it wherever, really, but I recommend `/usr/lib/nagioseasier/nagioseasier.so`.\n\nFrom there you can load it in your Nagios configuration as an Event Broker Module with a config line like so:\n\n```\nbroker_module=/usr/lib/nagioseasier/nagioseasier.so\n```\n\n## Using\n\nEnabling this module in Nagios adds a new `nagioseasier` query handler to the Nagios query handler socket. This allows you to interact with Nagios for common administrative tasks in a convenient way. Some examples of what you can do with nagioseasier:\n\n```\n#nagioseasier status app1\n#nagioseasier status app1/nginx\n\n#nagioseasier downtime app1/nginx 15 @wfarr testing changes\n\n#nagioseasier disable_notifications busted1\n\n#nagioseasier problems puppet-environment\n#nagioseasier problems puppet-environment unknown\n```\n\n### Commands\n\n```\nAvailable commands:\n  status \u003chost|service\u003e                          Display the status of a host or service\n  check \u003chost|service\u003e                           Schedule a re-check of the host or service\n\n  enable_notifications \u003chost|service\u003e            Enable notifications for a host or host-service\n  disable_notifications \u003chost|service\u003e           Disable notifications for a host or host-service\n\n  acknowledge \u003chost|service\u003e [\u003ccomment\u003e]         Acknowledge a host/service problem (opt. comment)\n  unacknowledge \u003chost|service\u003e                   Unacknowledge a host/service problem\n\n  downtime \u003chost|service\u003e [\u003cminutes\u003e \u003ccomment\u003e]  Schedule downtime for a host/service (opt. num minutes, comment)\n\n  problems [\u003csvcgroup|hstgroup\u003e \u003cstate\u003e]         Display all services in a non-OK state\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fnagioseasier-module","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgithub%2Fnagioseasier-module","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fnagioseasier-module/lists"}