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.0.tar.gz (4.5 kB view details)

Uploaded Source

Built Distribution

python_statsd-1.0-py2.6.egg (11.6 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for python-statsd-1.0.tar.gz
Algorithm Hash digest
SHA256 d423f45cec009a5494bf0f85256add6c2bc02ac15908512b41e168050aec4a79
MD5 9ac93c53a1fe1a63e0e1c852cccdae66
BLAKE2b-256 6efaa8102440fabc080b5a4737f88707fd614a9f12fccddd252ab69484f777ab

See more details on using hashes here.

File details

Details for the file python_statsd-1.0-py2.6.egg.

File metadata

File hashes

Hashes for python_statsd-1.0-py2.6.egg
Algorithm Hash digest
SHA256 7ad5990d71a00423b44b0be890ec1b739d41610199c75a4eb9839e18a067e43e
MD5 3f468bd868eb4731c3442b623809c2c5
BLAKE2b-256 8172a1bb8a818c6828c34c3ebfee267613967e6547562b444e77d1af649a2b76

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