Skip to main content

statsd is a client for Etsy's node-js statsd server. A proxy for the Graphite stats collection and graphing server.

Project description

Introduction

statsd is a client for Etsy’s statsd server, a front end/proxy for the Graphite stats collection and graphing server.

Install

To install simply execute python setup.py install. If you want to run the tests first, run python setup.py nosetests

Usage

To get started real quick, just try something like this:

Basic Usage

Timers

>>> import statsd
>>>
>>> timer = statsd.Timer('MyApplication')
>>>
>>> timer.start()
>>> # do something here
>>> timer.stop('SomeTimer')

Counters

>>> import statsd
>>>
>>> counter = statsd.Counter('MyApplication')
>>> # do something here
>>> counter += 1

Advanced Usage

>>> import statsd
>>>
>>> # Open a connection to `server` on port `1234` with a `50%` sample rate
>>> statsd_connection = statsd.Connection(
...     name='server',
...     port=1234,
...     sample_rate=0.5,
... )
>>>
>>> # Create a client for this application
>>> statsd_client = statsd.Client(__name__, statsd_connection)
>>>
>>> class SomeClass(object):
...     def __init__(self):
...         # Create a client specific for this class
...         self.statsd_client = statsd_client.get_client(
...             self.__class__.__name__)
...
...     def do_something(self):
...         # Create a `timer` client
...         timer = self.statsd_client.get_client(class_=statsd.Timer)
...
...         # start the measurement
...         timer.start()
...
...         # do something
...         timer.interval('intermediate_value')
...
...         # do something else
...         timer.stop('total')

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-statsd-1.3.tar.gz (4.5 kB view details)

Uploaded Source

Built Distribution

python_statsd-1.3-py2.5.egg (11.9 kB view details)

Uploaded Source

File details

Details for the file python-statsd-1.3.tar.gz.

File metadata

  • Download URL: python-statsd-1.3.tar.gz
  • Upload date:
  • Size: 4.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for python-statsd-1.3.tar.gz
Algorithm Hash digest
SHA256 d279ac16403f470283da579e047af59b008444837e66d8d5dcd20af5b839814b
MD5 b3655233534770c7630811ce21ff3b68
BLAKE2b-256 0a526c9f0be1f269e0bab368ae6a19cea5bbacea56804fb2b4abdc0ece9e8068

See more details on using hashes here.

File details

Details for the file python_statsd-1.3-py2.5.egg.

File metadata

File hashes

Hashes for python_statsd-1.3-py2.5.egg
Algorithm Hash digest
SHA256 cfae887df5409bf94c6df7521ed694df8fd1fc69f311bd63099710f291073691
MD5 9b1be0e7910a6ba02b4fae8b62b03d45
BLAKE2b-256 9d9362fce7da1cecdfbaedcf15cd1546f216534d816426bc52bbe9b587b56023

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page