statsd_quickstart_counters_timers_gauges_metrics.py

1import statsd
2
3# Create a connection to the statsd server
4# Default host is 'localhost', port is 8125
5c = statsd.StatsClient('localhost', 8125)
6
7# Increment a counter.
8c.incr('foo')
9
10# Timer example using a decorator
11@c.timer('my_function_timer')
12def my_function():
13    """Some function that takes time."""
14    pass
15
16# Timer example using a context manager
17with c.timer('my_context_timer'):
18    # do something...
19    pass
20
21# Manual timer
22c.timing('manual_timer', 500)  # 500ms
23
24# Set a gauge
25c.gauge('my_gauge', 42)