{ "info": { "author": "Andre Dieb Martins, Thiago Sousa Santos", "author_email": "andre.dieb@gmail.com, thiagossantos@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)", "Natural Language :: English", "Programming Language :: Python", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3" ], "description": "# om\n\nCollect disk usage, memory and cpu load info on remote boxes without having to install any software - as long as you can SSH into it.\n\n\n## Features\n\n- Disk and memory usage\n- CPU load\n- Supports email alerts when resources get to a critical state (e.g. nearly full disk, low free memory, high cpu load, etc)\n\n\n## Usage\n\nTo collect usage for a host:\n\n```shell\n$ ./om 192.168.0.1\n```\n\nTo collect usage for multiple hosts:\n\n```shell\n$ ./om 192.168.0.2,box2\n```\n\nThe tool also supports username, password and port if needed:\n\n```shell\n$ ./om root:mypass@mybox:44445\n```\n\n## Installation\n\nNo packages have been released yet. For a development preview, please fetch the code:\n\n```shell\n$ git clone https://github.com/overseer-monitoring/om.git\n$ cd overseer-mini\n$ pip install -r requirements.txt\n$ ./om\n```\n\n## Extra customization (optional)\n\nYou can tweak the ssh and metrics settings by saving the configs into a json config file.\n\nRunning against a config file:\n\n```shell\n$ ./om -c \n```\n\n### config.json format\n\n#### Machines\n\nThe config file is a JSON and informs which machines are to be monitored.\n\n```json\n{\n \"machines\": {\n \"my_rails_app\": {\n \"host\": \"125.22.13.12\",\n \"ssh\": {\n \"username\": \"foo\",\n \"password\": \"bar\"\n }\n }\n }\n}\n```\n\nThe only required field is ''host''. ''ssh'' is entirely optional if your local agent is already able to use keys to get to the machine.\n\n#### Metrics\n\nThe \"metrics\" section allows you to further customize your monitoring. Our current metrics are:\n\n- disk_usage\n- memory_usage\n\nFor instance, disk usages are reported as critical when they reach 80% usage. If for a certain box you want to be critical when it reaches 50%, then:\n\n```json\n{\n \"machines\": {\n \"my_rails_app\": {\n \"host\": \"125.22.13.12\",\n \"metrics\": {\n \"disk_usage\": {\n \"critical\": \"50%\"\n }\n }\n }\n }\n}\n```\n\nYou can also override the default value globally:\n\n```json\n{\n \"machines\": {\n \"my_rails_app\": {\n \"host\": \"125.22.13.12\",\n },\n \"my_postgres\": {\n \"host\": \"postgresbox\",\n \"disk_usage\": {\n \"critical\": \"60%\"\n }\n }\n },\n \"metrics\": {\n \"disk_usage\": {\n \"critical\": \"50%\"\n }\n }\n}\n```", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/overseer-monitoring/om", "keywords": null, "license": "LGPL", "maintainer": null, "maintainer_email": null, "name": "om", "package_url": "https://pypi.org/project/om/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/om/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/overseer-monitoring/om" }, "release_url": "https://pypi.org/project/om/0.0.1/", "requires_dist": null, "requires_python": null, "summary": "Collect usage for remote boxes without configuration.", "version": "0.0.1" }, "last_serial": 1200928, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "756eaad70eb27950cf6d36d27cd72a92", "sha256": "931312351f9952374f7f810f4ad4e0fca58c31dd973cc68603e2c69b83394e5d" }, "downloads": -1, "filename": "om-0.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "756eaad70eb27950cf6d36d27cd72a92", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 13125, "upload_time": "2014-08-25T03:18:18", "url": "https://files.pythonhosted.org/packages/4d/a7/74ecbe62825f1d9c4b04b3556a2fea5b783b61e05409441835ac58734ffc/om-0.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3c4f55c347dea8d7d75abff76c4790e2", "sha256": "fb209b13421ac5086fb332b67c9bf2ba098cbcbdd1b87e5e08365481faca6a20" }, "downloads": -1, "filename": "om-0.0.1.tar.gz", "has_sig": false, "md5_digest": "3c4f55c347dea8d7d75abff76c4790e2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9424, "upload_time": "2014-08-25T03:18:14", "url": "https://files.pythonhosted.org/packages/cc/61/f0776a5e4e0f960c24cfb504b50c80af3aa1e5cad8e202e3de66b5af59bb/om-0.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "756eaad70eb27950cf6d36d27cd72a92", "sha256": "931312351f9952374f7f810f4ad4e0fca58c31dd973cc68603e2c69b83394e5d" }, "downloads": -1, "filename": "om-0.0.1-py2-none-any.whl", "has_sig": false, "md5_digest": "756eaad70eb27950cf6d36d27cd72a92", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 13125, "upload_time": "2014-08-25T03:18:18", "url": "https://files.pythonhosted.org/packages/4d/a7/74ecbe62825f1d9c4b04b3556a2fea5b783b61e05409441835ac58734ffc/om-0.0.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3c4f55c347dea8d7d75abff76c4790e2", "sha256": "fb209b13421ac5086fb332b67c9bf2ba098cbcbdd1b87e5e08365481faca6a20" }, "downloads": -1, "filename": "om-0.0.1.tar.gz", "has_sig": false, "md5_digest": "3c4f55c347dea8d7d75abff76c4790e2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9424, "upload_time": "2014-08-25T03:18:14", "url": "https://files.pythonhosted.org/packages/cc/61/f0776a5e4e0f960c24cfb504b50c80af3aa1e5cad8e202e3de66b5af59bb/om-0.0.1.tar.gz" } ] }