{
    "info": {
        "author": "Peter Baumgarter",
        "author_email": "pete@lincolnloop.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "salmon\n======\n\n.. image:: https://secure.travis-ci.org/lincolnloop/salmon.png?branch=master\n   :target: http://travis-ci.org/lincolnloop/salmon\n\n.. image:: https://coveralls.io/repos/lincolnloop/salmon/badge.png?branch=master\n   :target: https://coveralls.io/r/lincolnloop/salmon?branch=master\n\nA simple monitoring system built on top of Django.\n\nThe intent is to serve both as an alerting system like `monit <http://mmonit.com/monit/>`_  and a monitoring system like `munin <http://munin-monitoring.org/>`_ (using `Graphite's whisper database <http://graphite.readthedocs.org/en/latest/whisper.html>`_).\n\nThe original release of Salmon was coupled to `Salt <http://docs.saltstack.com/>`_ and designed to monitor servers (**Sal** t **Mon** itor). As of v0.2.0, the system has been decoupled from Salt and ingests data via a simple HTTP interface.\n\n\n.. image:: http://cl.ly/image/3s340i0W0N06/content.png\n\n.. image:: https://cloudup.com/chXR0xnFtkf+\n\nInstallation\n-------------\n\nTo bootstrap the project::\n\n    virtualenv salmon\n    source salmon/bin/activate\n    pip install salmon\n    salmon init\n    salmon upgrade\n    salmon collectstatic\n\nFire up the web server with::\n\n    salmon start\n\nSending Metrics to Salmon\n-------------------------\n\nMetrics are sent in as JSON over HTTP. The format for a single metric::\n\n    {\n        \"source\": \"test.example.com\",\n        \"name\": \"load\",\n        \"value\": 0.1\n    }\n\nMultiple metrics can be sent as an array::\n\n    [\n        {\"source\": \"test.example.com\", \"name\": \"load\", \"value\": 0.1},\n        {\"source\": \"multi.example.com\", \"name\": \"cpu\", \"value\": 55.5}\n    ]\n\nThe API endpoint is ``/api/v1/metric/``. If your Salmon server lives at http://salmon.example.com, you can ``POST`` to ``http://salmon.example.com/api/v1/metric/``. Pass in your API key as found in ``~/.salmon/conf.py`` for authentication. Using Curl, it would look something like this::\n\n    curl -i --user \"<API_KEY>:\" \\\n         -H \"Content-Type: application/json\" \\\n         -X POST \\\n         -d '{\"source\": \"test.example.com\", \"name\": \"load\", \"value\": 0.1}' \\\n         http://salmon.example.com/api/v1/metric/\n\n\nUsing Salt\n^^^^^^^^^^\n\n1. Setup the `salt-stats <https://github.com/lincolnloop/salt-stats>`_ states on your master or just grab the `salmon returner <https://github.com/lincolnloop/salt-stats/blob/master/salt/_returners/salmon_return.py>`_\n2. Add the path to your Salmon install and API key (found in ``~/.salmon/conf.py``) to your Salt Pillar. (`salmon pillar example <https://github.com/lincolnloop/salt-stats/blob/master/salt/_returners/salmon_return.py#L10-L12>`_)\n3. Add a `schedule` pillar. (`schedule pillar example <https://gist.github.com/ipmb/8009715>`_)\n4. Run ``salt '*' saltutil.sync_all``\n\n*Note:* To use Salt's ``ps`` module, `psutil <https://code.google.com/p/psutil/>`_ must be installed on\nthe minions. Ubuntu provides a ``python-psutil`` package or it can be installed via ``pip install psutil``.",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/lincolnloop/salmon",
        "keywords": null,
        "license": "BSD",
        "maintainer": null,
        "maintainer_email": null,
        "name": "salmon",
        "package_url": "https://pypi.org/project/salmon/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/salmon/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "https://github.com/lincolnloop/salmon"
        },
        "release_url": "https://pypi.org/project/salmon/0.2.0/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "A simple metric collector with alerts.",
        "version": "0.2.0"
    },
    "last_serial": 947098,
    "releases": {
        "0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "69dd092617dd48ce2e6301a4256ce34e",
                    "sha256": "e9021b65b11013e4e230bfe4e2e8c00c7a79449a1dc7e5fd4fc84deb57db7db6"
                },
                "downloads": -1,
                "filename": "salmon-0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "69dd092617dd48ce2e6301a4256ce34e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 57518,
                "upload_time": "2013-04-25T18:53:38",
                "url": "https://files.pythonhosted.org/packages/35/7f/a2db3af85091956c3d01f3abf75da083c2d0d9fe5a2119beb0ca378671fe/salmon-0.1.tar.gz"
            }
        ],
        "0.1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1ccf2882e852714d9fc985cefdef86a1",
                    "sha256": "8f4c37d07f9a986d431ca0639eadb122456b4296281f33611a275b18e7fbaf4e"
                },
                "downloads": -1,
                "filename": "salmon-0.1.1.tar.gz",
                "has_sig": true,
                "md5_digest": "1ccf2882e852714d9fc985cefdef86a1",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 57522,
                "upload_time": "2013-04-25T18:55:19",
                "url": "https://files.pythonhosted.org/packages/1e/3a/87d5ba26f1ea1cbd258c85e4aa0004b6b53235046ea583b9ff754b595520/salmon-0.1.1.tar.gz"
            }
        ],
        "0.1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "40a7c00d6b09264d2c8d206646c4a5ef",
                    "sha256": "7435c99a362d54d6decb52d66478dcfff67ffe6c048587678d7714bd07e77b46"
                },
                "downloads": -1,
                "filename": "salmon-0.1.2.tar.gz",
                "has_sig": true,
                "md5_digest": "40a7c00d6b09264d2c8d206646c4a5ef",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 57821,
                "upload_time": "2013-04-25T21:35:42",
                "url": "https://files.pythonhosted.org/packages/55/f6/e2a501284dafa3203ad72294c512cc137ddf878b7adc4d1698f7ee06005a/salmon-0.1.2.tar.gz"
            }
        ],
        "0.1.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1151ad15d4a082c2494431db5b18dde9",
                    "sha256": "fb59215870d009f90be2ee220d82bed5cf5ea56641f6f22751ddbcb629443d2a"
                },
                "downloads": -1,
                "filename": "salmon-0.1.3.tar.gz",
                "has_sig": true,
                "md5_digest": "1151ad15d4a082c2494431db5b18dde9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 57816,
                "upload_time": "2013-04-25T21:54:28",
                "url": "https://files.pythonhosted.org/packages/83/55/37942d2bf9e357518cf7050578f95d7c8b7c6de6e05f03e9fa70393893f2/salmon-0.1.3.tar.gz"
            }
        ],
        "0.1.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "06acc4cf2cd407a29c9223572a0c2660",
                    "sha256": "cd0af1d3af89fa7a8451ac1c59c3280e5952825dd58e4a60ca6f28fdc258ba34"
                },
                "downloads": -1,
                "filename": "salmon-0.1.4.tar.gz",
                "has_sig": true,
                "md5_digest": "06acc4cf2cd407a29c9223572a0c2660",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 57830,
                "upload_time": "2013-04-25T21:55:46",
                "url": "https://files.pythonhosted.org/packages/8e/3b/37756c71f7b4453521116d6798f89f0e4b00be5c8843f3a8700efed28424/salmon-0.1.4.tar.gz"
            }
        ],
        "0.1.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "42834b6e2f101a6bf9fe398b5ca01ff6",
                    "sha256": "03ecaa08a6db5190c3e5dba37ae9d7f9190eec8fdf2cf7f5d0a5386f2c852fcc"
                },
                "downloads": -1,
                "filename": "salmon-0.1.5.tar.gz",
                "has_sig": true,
                "md5_digest": "42834b6e2f101a6bf9fe398b5ca01ff6",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 89915,
                "upload_time": "2013-04-26T03:18:45",
                "url": "https://files.pythonhosted.org/packages/0e/4c/d3b69692aef0195992a73ff3da964ab9bb3f2083b4c872fb15102599239e/salmon-0.1.5.tar.gz"
            }
        ],
        "0.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "91a48f725a391f6cf3992d510db59769",
                    "sha256": "a05441d1bbadcb8c8fe7a187938ade63f8b734e01407d01e3148540d89daf361"
                },
                "downloads": -1,
                "filename": "salmon-0.2.0-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "91a48f725a391f6cf3992d510db59769",
                "packagetype": "bdist_wheel",
                "python_version": "2.7",
                "requires_python": null,
                "size": 278115,
                "upload_time": "2013-12-17T19:55:33",
                "url": "https://files.pythonhosted.org/packages/bc/da/33ded11ce3f48c2dc8286866b2dd4f8d1fcb218d3fe7570adacddfd1156d/salmon-0.2.0-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "565a206ae872367b75077f1bdfac754b",
                    "sha256": "464556a9d8037233410db70b61967ad63fe1f6134bafbb4c66c32847a08f26bb"
                },
                "downloads": -1,
                "filename": "salmon-0.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "565a206ae872367b75077f1bdfac754b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 248859,
                "upload_time": "2013-12-17T19:55:15",
                "url": "https://files.pythonhosted.org/packages/c0/85/bba15929e886bdaa9eb8fa2b9af3583182c283c0807722cb9faf26898e43/salmon-0.2.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "91a48f725a391f6cf3992d510db59769",
                "sha256": "a05441d1bbadcb8c8fe7a187938ade63f8b734e01407d01e3148540d89daf361"
            },
            "downloads": -1,
            "filename": "salmon-0.2.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "91a48f725a391f6cf3992d510db59769",
            "packagetype": "bdist_wheel",
            "python_version": "2.7",
            "requires_python": null,
            "size": 278115,
            "upload_time": "2013-12-17T19:55:33",
            "url": "https://files.pythonhosted.org/packages/bc/da/33ded11ce3f48c2dc8286866b2dd4f8d1fcb218d3fe7570adacddfd1156d/salmon-0.2.0-py2.py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "565a206ae872367b75077f1bdfac754b",
                "sha256": "464556a9d8037233410db70b61967ad63fe1f6134bafbb4c66c32847a08f26bb"
            },
            "downloads": -1,
            "filename": "salmon-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "565a206ae872367b75077f1bdfac754b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 248859,
            "upload_time": "2013-12-17T19:55:15",
            "url": "https://files.pythonhosted.org/packages/c0/85/bba15929e886bdaa9eb8fa2b9af3583182c283c0807722cb9faf26898e43/salmon-0.2.0.tar.gz"
        }
    ]
}