{"id":23577960,"url":"https://github.com/couchbaselabs/couchbase-reference-nagios","last_synced_at":"2026-04-24T12:32:28.745Z","repository":{"id":66961769,"uuid":"108206954","full_name":"couchbaselabs/couchbase-reference-nagios","owner":"couchbaselabs","description":"A reference monitoring implementation for Couchbase using Nagios","archived":false,"fork":false,"pushed_at":"2017-10-25T02:08:34.000Z","size":53,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":33,"default_branch":"master","last_synced_at":"2026-04-21T01:59:50.421Z","etag":null,"topics":["couchbase","docker-image","nagios"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/couchbaselabs.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-10-25T02:03:10.000Z","updated_at":"2018-04-14T17:52:05.000Z","dependencies_parsed_at":"2023-03-11T00:28:59.643Z","dependency_job_id":null,"html_url":"https://github.com/couchbaselabs/couchbase-reference-nagios","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/couchbaselabs/couchbase-reference-nagios","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbaselabs%2Fcouchbase-reference-nagios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbaselabs%2Fcouchbase-reference-nagios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbaselabs%2Fcouchbase-reference-nagios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbaselabs%2Fcouchbase-reference-nagios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/couchbaselabs","download_url":"https://codeload.github.com/couchbaselabs/couchbase-reference-nagios/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbaselabs%2Fcouchbase-reference-nagios/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32223933,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T10:26:35.452Z","status":"ssl_error","status_checked_at":"2026-04-24T10:25:27.643Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["couchbase","docker-image","nagios"],"created_at":"2024-12-26T22:32:00.827Z","updated_at":"2026-04-24T12:32:28.723Z","avatar_url":"https://github.com/couchbaselabs.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Couchbase monitoring reference implementation\nThis project provides a reference implementation for monitoring [Couchbase](https://www.couchbase.com) with [Nagios](https://www.nagios.org/).\n\nTwo Docker images are provided: \n* couchbase/nagios: the Nagios server with preconfigured Couchbase host and service templates\n* couchbase/nrpe: the Nagios Remote Plugin Execution (NRPE) server with [check_couchbase](https://github.com/couchbase-partners/nagios-plugin-couchbase) and plugins to monitor the OS\n\n## Building the images\n\nTo build the Nagios server:\n```bash\ndocker build docker/nagios -t couchbase/nagios\n```\n\nTo build tne NRPE server:\n```bash\ndocker build docker/nrpe -t couchbase/nrpe\n```\n## Running the containers\nTo run the Nagios container:\n```bash\ndocker run --name nagios -v $(pwd)/etc:/opt/nagios/etc/ -p 8080:80 -p 5668:5668 -it couchbase/nagios\n```\nThe Nagios container should run on your monitoring server.\n\nTo run the NRPE container:\n```bash\ndocker run --name nrpe -v /:/mnt/ROOT -p 5666:5666 --net=host -it couchbase/nrpe\n```\nThe NRPE container runs on your Couchbase nodes.\n\n## Connecting to Nagios\nOpen your browser to http://localhost:8080\n\nThe default login credentials are: nagiosadmin:nagios\n\n## Configuring Nagios\nThe repository contains a top level \"etc\" directory which houses all of the Nagios config files.  The container mounts this directory, allowing the administrator to change Nagios config without rebuilding the image.  The container is configured to reload Nagios every 30 seconds to pick up new configuration.\n\nThe Nagios container runs 3 key services:\n* [nagios](https://www.nagios.org/): schedules and executes active checks\n* [nsca-ng](http://www.nsca-ng.org/): receives passive checks from the check_couchbase script and passes them to Nagios\n* [radar](https://exchange.nagios.org/directory/Addons/Passive-Checks/Radar--2D-add-hosts-and-services-automatically/details): scans the Nagios log for unknown host and service errors and dynamically creates host and service entries for them\n\n### Config layout\n* etc: contains the main Nagios and NSCA configuration files\n* etc/objects/default: the default templates that ship with Nagios\n* etc/objects/commands/common.cfg: command definitions\n* etc/objects/hosts/couchbase-servers.cfg: host and hostgroup definitions\n* etc/objects/services\n  * couchbase-common.cfg: active service definitions that apply to all Couchbase nodes\n  * couchbase-data.cfg: active service definitions that apply to Couchbase data nodes\n  * couchbase-index.cfg: active service definitions that apply to Couchbase index nodes\n  * couchbase-query.cfg: active service definitions that apply to Couchbase query nodes\n  * couchbase-passive.cfg: a service template that is used for all passive checks\n* etc/dynamic: contains the host and service definitions dynamically generated by Radar\n\n### Minimum configuration\nThere are two required configurations in order to monitor a couchbase host:\n1. You must add your Couchbase node(s) to etc/objects/hosts/couchbase-servers.cfg.  Each node should be configured in the following format: \n```\ndefine host{\n        use couchbase-server\n        hostgroups +couchbase-data,couchbase-query,couchbase-index\n        host_name 192.168.61.102\n        address 192.168.61.102\n}\n```\nNote that ```hostgroups``` should reflect the configured services on the node\n\n2. The check_couchbase service in etc/objects/services/couchbase-common.cfg should be updated to use your monitoring host's IP address or hostname (change 127.0.0.1):\n```\ndefine service{\n\tuse couchbase-service\n\tservice_description check_couchbase.py\n\tcheck_command check_nrpe!check_couchbase!127.0.0.1 localhost\n}\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcouchbaselabs%2Fcouchbase-reference-nagios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcouchbaselabs%2Fcouchbase-reference-nagios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcouchbaselabs%2Fcouchbase-reference-nagios/lists"}