{ "info": { "author": "Farzad Ghanei", "author_email": "", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Networking :: Monitoring" ], "description": "*******\nNavdoon\n*******\n\n.. image:: https://travis-ci.org/farzadghanei/navdoon.svg?branch=master\n :target: https://travis-ci.org/farzadghanei/navdoon\n\n.. image:: https://codecov.io/github/farzadghanei/navdoon/coverage.svg?branch=master\n :target: https://codecov.io/github/farzadghanei/navdoon?branch=master\n\n.. image:: https://ci.appveyor.com/api/projects/status/67gbsru6tp3tjxaq/branch/master?svg=true\n :target: https://ci.appveyor.com/project/farzadghanei/navdoon?branch=master\n\n\nPowerful Statsd server, made easy.\n\nNavdoon is a portable Statsd server with useful features to make it easy to\nuse, extend and integrate.\n\nFeatures\n--------\n* Portable with few dependencies, easy to install on most platforms\n* Support TCP, UDP\n* Receive metrics from multiple addresses\n* Flush to multiple Graphite backends\n* Flush to files (in Graphite and CSV format)\n* Easy to integrate with custom programs\n* Ability to reload the server without losing the metrics\n\n\nDetails\n=======\n\n* Navdoon uses collectors to receive Statsd metrics and recieves metrics over\n UDP (`--collect-udp`) and TCP (`--collect-tcp`),\n and accepts multiple collectors.\n\n* The server saves/sends (flushes) the accumulated metrics every often\n (`--flus-interval`) to a persistent storage.\n `Carbon `_ (from `Graphite `_ project)\n is a very common backend for Statsd servers. Navdoon accepts multiple Graphite addresses (`--flush-graphite`)\n so it can flush to multiple backends (all share the same interval).\n Metrics can be flushed to standard output (`--flush-stdout`) to pipe to another\n program, so it's easy to integrate with any custom backend.\n\n* Logging can be helpful or can be wasteful, depending on the deployment and the usage of the application.\n Navdoon provides detailed configuration on logging, so you can chose what will be logged (`--log-level`)\n and how to log, send logs to syslog (`--log-syslog`), to a file (`--log-file`) or standard error\n (`--log-stderr`) to be piped to another program.\n\n* While not claiming to be the fastest, good performance is considered in the design.\n Navdoon uses threads for each collector and flush backend.\n Future versions will offer improved performance as it was not a priority\n for the first releases.\n\n* Server supports reloading (on receiving SIGHUP), keeping current state of the metrics and last flush time.\n So it's possible to change collectors, flush destinations, logging, etc. on the configuration file while\n the server is running, and then on sending a SIGHUP the server picks the new configuration.\n\n\nReleases\n========\n* Latest released version is *0.3.0* (released on 2017-02-11)\n* Version *0.2.0* was released on 2016-10-10\n\nSee the CHANGELOG for more information about features provided by each release.\n\n\nInstall\n-------\nNavdoon is distributed as a Docker image, and a Python package.\n\nPyPi\n====\nNavdoon can be installed from `pypi `_ using `pip`.\n\n\n.. code-block:: bash\n\n pip install navdoon\n\n\nSource\n======\nYou can install from the source by running the `setup.py` script provided.\n\n\n.. code-block:: bash\n\n python setup.py install\n\n\n.. note:: If you're installing Navdoon to a system path, you might need to\n run the installation with `sudo` or under a privileged user.\n\n\nRequirements\n------------\nNavdoon is written in Python, so running from source or installing it as a package,\nrequires a Python runtime (version 2.7+, latest versions of Python 3 is recommended).\n\nThe `statsdmetrics `_ Python module\nis the only dependency to run Navdoon.\nHowever these Python modules are recommended on development/test environment:\n\n* `distutilazy `_ (>=0.4.2): helpful commands added to `setup.py` to run tests and clean temp files\n* `typing `_ (>=3.5.0): standard type annotations for Python\n* `coverage `_: create test coverage reports\n\n\nDocker\n------\nDifferent Docker image tags are available, providing different runtimes.\n\nThe default tag is based on CPython alpine images\n(trying to use latest versions of Python, currently 3.6)\nso the image size should be minimum.\n\n.. code-block:: bash\n\n docker pull farzadghanei/navdoon\n # or a specific version like farzadghanei/navdoon:0.3.0\n\nAnother tag is available to run Navdoon on `PyPy `_ (currently version 2).\n\n.. code-block:: bash\n\n docker pull farzadghanei/navdoon:0.3.0-pypy2\n\n\n\nRunning from source\n-------------------\nBefore running from source, a few dependencies should be installed. Using a virtual\nenvironment is suggested. (In this example we create a virtual environment\nin the project source path, but you may chose a custom path like\n~/.venvs/navdoon-py3)\n\n\n.. code-block:: bash\n\n git clone https://github.com/farzadghanei/navdoon.git && cd navdoon\n python3 -m venv .navdoon-venv-py3 && source ./.navdoon-venv-py3/bin/activate\n pip install -r requirements.txt && python3 bin/navdoon_src\n\n\n.. note:: Python 3.3+ standard library comes with `venv` module.\n For older versions you can use\n `virtualenv `_.\n\n\nOr you may skip installing and sourcing the virtual environment and install the (few)\ndependencies on your system.\n\n\nLicense\n-------\n\nNavdoon is released under the terms of the\n`Apache 2.0 license `_.", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/farzadghanei/navdoon", "keywords": "statsd monitoring", "license": "Apache License, Version 2.0", "maintainer": "", "maintainer_email": "", "name": "navdoon", "package_url": "https://pypi.org/project/navdoon/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/navdoon/", "project_urls": { "Homepage": "https://github.com/farzadghanei/navdoon" }, "release_url": "https://pypi.org/project/navdoon/0.3.0/", "requires_dist": [ "statsdmetrics (>=0.3)", "coverage; extra == 'dev'", "distutilazy (>=0.4.2); extra == 'dev'", "typing (>=3.5.0.1); extra == 'dev'" ], "requires_python": "", "summary": "Powerful Statsd server, made easy", "version": "0.3.0" }, "last_serial": 2635524, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "3fe5039b402af2ba0b271c095e770b3a", "sha256": "c63a9e19a528ebe9f13622fc63eb9bc41ae20f92b2cb6eda1909829dd92a15ae" }, "downloads": -1, "filename": "navdoon-0.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3fe5039b402af2ba0b271c095e770b3a", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 21426, "upload_time": "2016-05-28T15:42:04", "url": "https://files.pythonhosted.org/packages/14/87/e2a022b54820af45c681a2f1998920207519023bf13fb358b93a072b3718/navdoon-0.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4af523f32494bdf4c7e89dec550a9c58", "sha256": "f7995c57fae973f104a0ee14e536bf6b0ebe0990e0e13bf01228e1f36df90d15" }, "downloads": -1, "filename": "navdoon-0.1.0.tar.gz", "has_sig": false, "md5_digest": "4af523f32494bdf4c7e89dec550a9c58", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16575, "upload_time": "2016-05-28T15:42:20", "url": "https://files.pythonhosted.org/packages/07/3a/51c0266f6250ed17f9658bf19d06d92763c360aa5d5825b0d8f1edf9f756/navdoon-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "b16fc222f6addbd022a1e4ac045b9fba", "sha256": "a168e1180d81375a50934216a60130ff2fdab1916015639f11fdedc2cb3ce27e" }, "downloads": -1, "filename": "navdoon-0.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "b16fc222f6addbd022a1e4ac045b9fba", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 21436, "upload_time": "2016-06-15T08:37:52", "url": "https://files.pythonhosted.org/packages/e6/a5/bbbd00c5a235b7db9618d09a8cbf3b868e1a61ea3c47767ca098709fbaa6/navdoon-0.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4d7c7683d6b817e6f22162ad86482038", "sha256": "b7fc3bbb897551ee687addb0b1bbc1bad58f5abf3e6cdd00f66b3ada2a857b81" }, "downloads": -1, "filename": "navdoon-0.1.1.tar.gz", "has_sig": false, "md5_digest": "4d7c7683d6b817e6f22162ad86482038", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16175, "upload_time": "2016-06-15T08:39:03", "url": "https://files.pythonhosted.org/packages/be/c3/368cb64387a1a4efac0e79186a3d21e5d3b711baa522b1db9f667b785f08/navdoon-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "0e8c15fa9faef656b3b6e565a2208c68", "sha256": "e1ff51544cc142c6d5f1215dd786465a2804c2fe18bdf8fa0c567cdec0f0d56d" }, "downloads": -1, "filename": "navdoon-0.2.0-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "0e8c15fa9faef656b3b6e565a2208c68", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 25365, "upload_time": "2016-10-10T19:13:16", "url": "https://files.pythonhosted.org/packages/51/24/4ced9c7a0444329dc985fbc5cd38ea98b04aa79801f5b3acb8db50b429ed/navdoon-0.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0e2c374e49ce62f4a9a2cca3bb2e2609", "sha256": "7cf4ad3108562297e6a827f35c0fac275821c8342cbe0c116e239ea1da2ec74b" }, "downloads": -1, "filename": "navdoon-0.2.0.tar.gz", "has_sig": true, "md5_digest": "0e2c374e49ce62f4a9a2cca3bb2e2609", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19447, "upload_time": "2016-10-10T19:13:35", "url": "https://files.pythonhosted.org/packages/64/d4/c3df8449d13f758b5d523ea01abbd6875d5fd51927d8f05bf5c83d337a26/navdoon-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "c5889137cc82e5d26b85f6d4a372c232", "sha256": "fdb92accb7db11dd028358d822910c909d9ed8ddc2ad11d6a3cada54127689d6" }, "downloads": -1, "filename": "navdoon-0.3.0-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "c5889137cc82e5d26b85f6d4a372c232", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 42532, "upload_time": "2017-02-11T16:46:24", "url": "https://files.pythonhosted.org/packages/d0/84/70c8d0da769e922d1e633c8466a68eb38d48182339cd088c4e3401bf14c4/navdoon-0.3.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "20e11aa0ef5117d02e6c2d77e3d38fac", "sha256": "5b949b33783abbea3b521e9d4abb05c96b990850f6c96144600c4b5502275059" }, "downloads": -1, "filename": "navdoon-0.3.0.tar.gz", "has_sig": true, "md5_digest": "20e11aa0ef5117d02e6c2d77e3d38fac", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 36117, "upload_time": "2017-02-11T16:46:37", "url": "https://files.pythonhosted.org/packages/78/44/62ba05f266f193e7ffea684a592f419365b256949baf40a0a382f16cd33c/navdoon-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c5889137cc82e5d26b85f6d4a372c232", "sha256": "fdb92accb7db11dd028358d822910c909d9ed8ddc2ad11d6a3cada54127689d6" }, "downloads": -1, "filename": "navdoon-0.3.0-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "c5889137cc82e5d26b85f6d4a372c232", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 42532, "upload_time": "2017-02-11T16:46:24", "url": "https://files.pythonhosted.org/packages/d0/84/70c8d0da769e922d1e633c8466a68eb38d48182339cd088c4e3401bf14c4/navdoon-0.3.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "20e11aa0ef5117d02e6c2d77e3d38fac", "sha256": "5b949b33783abbea3b521e9d4abb05c96b990850f6c96144600c4b5502275059" }, "downloads": -1, "filename": "navdoon-0.3.0.tar.gz", "has_sig": true, "md5_digest": "20e11aa0ef5117d02e6c2d77e3d38fac", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 36117, "upload_time": "2017-02-11T16:46:37", "url": "https://files.pythonhosted.org/packages/78/44/62ba05f266f193e7ffea684a592f419365b256949baf40a0a382f16cd33c/navdoon-0.3.0.tar.gz" } ] }