=========================================================
A Python statsd client with DogTag-compatible tag support
=========================================================
statsd_ is a friendly front-end to Graphite_. This is a Python client
for the statsd daemon. More specifically, this is a fork of jsocol's
pystatsd client, with the addition of support for DogTag-compatible
tags.
:Code: https://github.com/toddjames/statsd-tags
:License: MIT; see LICENSE file
:Issues: https://github.com/toddjames/statsd-tags/issues
:Documentation: https://statsd-tags.readthedocs.io/
Quickly, to use:
.. code-block:: python
>>> import statsd
>>> c = statsd.StatsClient('localhost', 8125)
>>> c.incr('foo') # Increment the 'foo' counter.
>>> c.timing('stats.timed', 320) # Record a 320ms 'stats.timed'.
You can also add a prefix to all your stats:
.. code-block:: python
>>> import statsd
>>> c = statsd.StatsClient('localhost', 8125, prefix='foo')
>>> c.incr('bar') # Will be 'foo.bar' in statsd/graphite.
DogTag-compatible tags are supported, as well:
.. code-block:: python
>>> import statsd
>>> c = statsd.StatsClient('localhost', 8125)
>>> c.gauge('baz', 42, tags=['production', 'fqdn': 'example.org'])
Installing
==========
The easiest way to install statsd is with pip!
You can install from PyPI::
$ pip install statsd-tags
Or GitHub::
$ pip install -e git+https://github.com/toddjames/statsd-tags#egg=statsd
Or from source::
$ git clone https://github.com/toddjames/statsd-tags
$ cd statsd-tags
$ python setup.py install
Docs
====
There are lots of docs in the ``docs/`` directory and on ReadTheDocs_.
.. _statsd: https://github.com/etsy/statsd
.. _Graphite: https://graphite.readthedocs.io/
.. _ReadTheDocs: https://statsd-tags.readthedocs.io/en/latest/index.html
Raw data
{
"_id": null,
"home_page": "https://github.com/toddjames/statsd-tags",
"name": "statsd-tags",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Todd James",
"author_email": "todd@toddjames.io",
"download_url": "https://files.pythonhosted.org/packages/e7/c1/6b99a6802ada68bd2bae64fbda29849e6ac92535d271f9e4f76c07235de6/statsd-tags-3.2.1.post1.tar.gz",
"platform": "",
"description": "=========================================================\nA Python statsd client with DogTag-compatible tag support\n=========================================================\n\nstatsd_ is a friendly front-end to Graphite_. This is a Python client\nfor the statsd daemon. More specifically, this is a fork of jsocol's\npystatsd client, with the addition of support for DogTag-compatible\ntags.\n\n:Code: https://github.com/toddjames/statsd-tags\n:License: MIT; see LICENSE file\n:Issues: https://github.com/toddjames/statsd-tags/issues\n:Documentation: https://statsd-tags.readthedocs.io/\n\nQuickly, to use:\n\n.. code-block:: python\n\n >>> import statsd\n >>> c = statsd.StatsClient('localhost', 8125)\n >>> c.incr('foo') # Increment the 'foo' counter.\n >>> c.timing('stats.timed', 320) # Record a 320ms 'stats.timed'.\n\nYou can also add a prefix to all your stats:\n\n.. code-block:: python\n\n >>> import statsd\n >>> c = statsd.StatsClient('localhost', 8125, prefix='foo')\n >>> c.incr('bar') # Will be 'foo.bar' in statsd/graphite.\n\nDogTag-compatible tags are supported, as well:\n\n.. code-block:: python\n\n >>> import statsd\n >>> c = statsd.StatsClient('localhost', 8125)\n >>> c.gauge('baz', 42, tags=['production', 'fqdn': 'example.org'])\n\n\nInstalling\n==========\n\nThe easiest way to install statsd is with pip!\n\nYou can install from PyPI::\n\n $ pip install statsd-tags\n\nOr GitHub::\n\n $ pip install -e git+https://github.com/toddjames/statsd-tags#egg=statsd\n\nOr from source::\n\n $ git clone https://github.com/toddjames/statsd-tags\n $ cd statsd-tags\n $ python setup.py install\n\n\nDocs\n====\n\nThere are lots of docs in the ``docs/`` directory and on ReadTheDocs_.\n\n\n.. _statsd: https://github.com/etsy/statsd\n.. _Graphite: https://graphite.readthedocs.io/\n.. _ReadTheDocs: https://statsd-tags.readthedocs.io/en/latest/index.html\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple statsd client with DogTag-compatible tag support.",
"version": "3.2.1.post1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "5dfc326448a0e57d966bb401f5f5cf20",
"sha256": "d887177205eb220eab258cad3789bf24334894c8b4193cf23c33737671a61135"
},
"downloads": -1,
"filename": "statsd_tags-3.2.1.post1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "5dfc326448a0e57d966bb401f5f5cf20",
"packagetype": "bdist_wheel",
"python_version": "2.7",
"requires_python": null,
"size": 11732,
"upload_time": "2016-12-24T06:27:03",
"upload_time_iso_8601": "2016-12-24T06:27:03.205718Z",
"url": "https://files.pythonhosted.org/packages/34/b3/fe15ccde54f49f41558ef61dca825a63e55d586d04aa4d3b87442bde1fca/statsd_tags-3.2.1.post1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "8170e09bb5198c2ab1bbf5ed5eac0026",
"sha256": "acd7e07a300f32984b5fa17115296309e1253b911736962f72383d66707aea71"
},
"downloads": -1,
"filename": "statsd-tags-3.2.1.post1.tar.gz",
"has_sig": false,
"md5_digest": "8170e09bb5198c2ab1bbf5ed5eac0026",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 24606,
"upload_time": "2016-12-24T06:27:01",
"upload_time_iso_8601": "2016-12-24T06:27:01.490209Z",
"url": "https://files.pythonhosted.org/packages/e7/c1/6b99a6802ada68bd2bae64fbda29849e6ac92535d271f9e4f76c07235de6/statsd-tags-3.2.1.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2016-12-24 06:27:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "toddjames",
"github_project": "statsd-tags",
"lcname": "statsd-tags"
}
JSON
