{ "info": { "author": "Tim Skirvin", "author_email": "tskirvin@fnal.gov", "bugtrack_url": null, "classifiers": [], "description": "# omdclient\n\nomdclient provides a suite of command-line tools to interact with the APIs\nassociated with the `check_mk`/Open Monitoring Distribution tool suite.\n\n## WATO APIs\n\nWATO is used to create, remove, and modify entries within the OMD user\nsuite. This is documented at:\n\n\n\n### omd-activate\n\nActivates changes made by the API user.\n\n### omd-bulkimport\n\nTakes a list of hosts on STDIN and adds them to a specific folder in OMD.\n\n### omd-host-crud\n\nCreates/Reads/Updates/Deletes entries from an existing monitoring\ninterface.\n\n### omd-host-tag\n\nupdate/remove a given host tag in OMD\n\n### omd-reinventory\n\nReinventory a host in OMD.\n\n## Multisite/Nagios\n\n\n\n### omd-nagios-ack\n\nAcknowledges host/service alerts from the command-line.\n\n### omd-nagios-downtime\n\nSchedules host/service downtimes from the command-line.\n\n### omd-nagios-hostlist\n\nPrint a list of all hosts in the given nagios instance.\n\n### omd-nagios-hosts-with-problem\n\nPrint a list of hosts that are currently exhibiting a specific problem.\n\n### omd-nagios-report\n\nPrints a human-readable report on current host and service alerts.\n\n## Setup / How To Use\n\n### /etc/omdclient/config.yaml\n\nYou'll have to populate this file on your own:\n\n server: 'xxxxxx.example'\n site: 'xxxxxx'\n user: 'xxxx-api'\n apikey: 'xxxxxx'\n\nIf you set the 'OMDCONFIG' environment variable you can point at different\nconfigs, e.g.:\n\n OMDCONFIG=/tmp/myconfig.yaml omd-activate\n\n### Configuration of 'expanded views'\n\nThe report scripts depend on 'expanded view' versions of the\n`hostproblems` and `svcproblems` views, which add comments. In order to\nadd these, you generally have to:\n\n1. Edit view `hostproblems` - it's a default view, so you'll go to 'clone'.\n * Change the name from `hostproblems` to `hostproblems_expanded`.\n * Update the list of columns to read:\n 1. Hostname\n 2. Host icons\n 3. Host state\n 4. Output of host check plugin\n 5. Number of services in state OK\n 6. Number of services in state WARN\n 7. Number of services in state UNKNOWN\n 8. Number of services in state CRIT\n 9. Number of services in state PENDING\n 10. The age of the current host state\n 11. Host comments\n * (newer versions) set to 'public' and 'hidden'.\n * Save.\n2. Edit the view `svcproblems` and created `svcproblems_expanded`, same\n as above but just add the column `Service Comments`.\n\nIn newer versions of check\\_mk, you may also need to make these views\nPublic (check `Visibility` / `Make this view available for other users` /\n`Publish to all users`). Also, the `hostproblems` base view may have\nchanged: I have for `hostproblems_expanded`:\n\n(Thanks to Christian Bryn - https://github.com/epleterte - for the docs!)\n\n## How To Build\n\nThere is a `Makefile.bak` and a `*.spec` file that mirrors my local build\nprocess for RPMs, if this matches your requirements; just run\n`make -f Makefile.bak build-nomock`.\n\nOtherwise, you may want to just follow the general instructions\nin `*.spec`. Scripts from `usr/bin/*` go into your path; create\n`/etc/omdclient/config.yaml` as described above; make man pages with\n`pod2man` if you're ambitious; and run `python setup.py install` to\ninstall the python library.\n\n### Debian\n\n make -f Makefile.deb build\n\nThat should build a full .deb package.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/tskirvin/omdclient/", "keywords": "check_mk,omd,nagios,api,wato", "license": "Perl Artistic", "maintainer": "Tim Skirvin", "maintainer_email": "tskirvin@fnal.gov", "name": "omdclient", "package_url": "https://pypi.org/project/omdclient/", "platform": "", "project_url": "https://pypi.org/project/omdclient/", "project_urls": { "Homepage": "https://github.com/tskirvin/omdclient/" }, "release_url": "https://pypi.org/project/omdclient/1.4.2/", "requires_dist": null, "requires_python": "", "summary": "omdclient check_mk + WATO/OMD interface", "version": "1.4.2" }, "last_serial": 5721115, "releases": { "1.3.3.post4": [ { "comment_text": "", "digests": { "md5": "4822f256311cf8dbeba7118f8c74f467", "sha256": "9898bc339438c4005f4a2471d0ba8452bad833858b07279a06021c20b47f6729" }, "downloads": -1, "filename": "omdclient-1.3.3.post4.tar.gz", "has_sig": false, "md5_digest": "4822f256311cf8dbeba7118f8c74f467", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22512, "upload_time": "2019-03-18T21:28:00", "url": "https://files.pythonhosted.org/packages/97/8b/b5b0ab680fdfc96871a65bcd2cc50079f9268b615fe1ec0b58bb4ed204c5/omdclient-1.3.3.post4.tar.gz" } ], "1.3.5": [ { "comment_text": "", "digests": { "md5": "b866df9a75c1b3f717b45640a34aa69f", "sha256": "feb9d8cb599ed05736e50bc985e46a2a150087be95c8049bc7ea622b921929c5" }, "downloads": -1, "filename": "omdclient-1.3.5-py3-none-any.whl", "has_sig": false, "md5_digest": "b866df9a75c1b3f717b45640a34aa69f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 55788, "upload_time": "2019-03-19T15:52:32", "url": "https://files.pythonhosted.org/packages/dc/00/e6f93efc6252290b3948be0804ceb45040edd00c0d89333dc60bf26b2acd/omdclient-1.3.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1a7164dcf6f2cdbd7a3dd850b1994780", "sha256": "45aca2aecaf00057970cf4769bd17b6082c0ea2f3a425a08062a20355789a3c8" }, "downloads": -1, "filename": "omdclient-1.3.5.tar.gz", "has_sig": false, "md5_digest": "1a7164dcf6f2cdbd7a3dd850b1994780", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22816, "upload_time": "2019-03-19T15:52:33", "url": "https://files.pythonhosted.org/packages/6b/74/d5872c6528eaecd067a22bd11390d47bc8aacabffd23166cceb451aa45c3/omdclient-1.3.5.tar.gz" } ], "1.4.1": [ { "comment_text": "", "digests": { "md5": "9d95afb56737b54af83b078a8940493b", "sha256": "4a3cf6d94a2fd8eec7781731f0a0f103761a2a2d5a92cc67431cd270e1eb807c" }, "downloads": -1, "filename": "omdclient-1.4.1-py3-none-any.whl", "has_sig": false, "md5_digest": "9d95afb56737b54af83b078a8940493b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 55780, "upload_time": "2019-08-19T18:11:29", "url": "https://files.pythonhosted.org/packages/8e/8a/1eae20a8225ff969d55b0e65ebbdfbca8f0bac47a228501814d3b3034dbd/omdclient-1.4.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "41338bcb926850a8d75c6b0a0792921d", "sha256": "0c0a74d2c8b0bee55d52ad8cfbbbc3558126477fa6b267372ed909d688851f2d" }, "downloads": -1, "filename": "omdclient-1.4.1.tar.gz", "has_sig": false, "md5_digest": "41338bcb926850a8d75c6b0a0792921d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22834, "upload_time": "2019-08-19T18:11:30", "url": "https://files.pythonhosted.org/packages/cd/ce/00b80c0721c292cb785de689014e45ddaa155f7e2d9e1ad1f3beb57e32a4/omdclient-1.4.1.tar.gz" } ], "1.4.2": [ { "comment_text": "", "digests": { "md5": "eb68fc9d9627febe0c233d1ce9f1d778", "sha256": "cf1532065bbc82ce4b6b14f6ae4abddcfd11bd3a71fa721d44008823e3dd442a" }, "downloads": -1, "filename": "omdclient-1.4.2-py3-none-any.whl", "has_sig": false, "md5_digest": "eb68fc9d9627febe0c233d1ce9f1d778", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 55786, "upload_time": "2019-08-23T14:36:08", "url": "https://files.pythonhosted.org/packages/0f/69/c7ba364695021ea2aee0d8e5d845e755c5846fd02290729c2f8b28a6dbca/omdclient-1.4.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0011cbdcabff82205b7fc61973628fcf", "sha256": "2e2b08c2f791c74b5419583ebd1c986da6f80e14921352520ed5d425381c677d" }, "downloads": -1, "filename": "omdclient-1.4.2.tar.gz", "has_sig": false, "md5_digest": "0011cbdcabff82205b7fc61973628fcf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22848, "upload_time": "2019-08-23T14:36:09", "url": "https://files.pythonhosted.org/packages/21/4b/e41fb9c8b6d4e6ffb285bb40c1c6752092366986d928c1c8ff04b828d9ef/omdclient-1.4.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "eb68fc9d9627febe0c233d1ce9f1d778", "sha256": "cf1532065bbc82ce4b6b14f6ae4abddcfd11bd3a71fa721d44008823e3dd442a" }, "downloads": -1, "filename": "omdclient-1.4.2-py3-none-any.whl", "has_sig": false, "md5_digest": "eb68fc9d9627febe0c233d1ce9f1d778", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 55786, "upload_time": "2019-08-23T14:36:08", "url": "https://files.pythonhosted.org/packages/0f/69/c7ba364695021ea2aee0d8e5d845e755c5846fd02290729c2f8b28a6dbca/omdclient-1.4.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0011cbdcabff82205b7fc61973628fcf", "sha256": "2e2b08c2f791c74b5419583ebd1c986da6f80e14921352520ed5d425381c677d" }, "downloads": -1, "filename": "omdclient-1.4.2.tar.gz", "has_sig": false, "md5_digest": "0011cbdcabff82205b7fc61973628fcf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22848, "upload_time": "2019-08-23T14:36:09", "url": "https://files.pythonhosted.org/packages/21/4b/e41fb9c8b6d4e6ffb285bb40c1c6752092366986d928c1c8ff04b828d9ef/omdclient-1.4.2.tar.gz" } ] }