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

Uploaded Source

Built Distribution

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

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for python-statsd-1.2.tar.gz
Algorithm Hash digest
SHA256 11f998c1e29793b31456dc9c3c4b02a4ff057bfa6038b047eef6fe1055298cbb
MD5 0783837af57672222edd927172ada760
BLAKE2b-256 89f148c7633b18c9354a7a91786854a8ec70468e4fb2beafd97ef7555f76e354

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for python_statsd-1.2-py2.5.egg
Algorithm Hash digest
SHA256 4f953ee9b645d47ebeee6117694d972f4ee1dac875691156e8ea9adc66e25e60
MD5 7823502aac96f5f9f9383af0576337dd
BLAKE2b-256 476c29532067fd685a42448ceb024f86f6e8993fbc46531853e9b7986d6e41c5

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