Record performance metrics about your application
Project description
Adjust counter and timer metrics in InfluxDB or Graphite using the same API.
from sprockets.mixins import mediatype, metrics
from tornado import gen, web
import queries
class MyHandler(metrics.StatsdMixin, mediatype.ContentMixin,
web.RequestHandler):
def initialize(self):
super(MyHandler, self).initialize()
self.db = queries.TornadoSession(os.environ['MY_PGSQL_DSN'])
@gen.coroutine
def get(self, obj_id):
with self.execution_timer('dbquery', 'get'):
result = yield self.db.query('SELECT * FROM foo WHERE id=%s',
obj_id)
self.send_response(result)
This simple handler will emit a timer metric that identifies each call to the get method as well as a separate metric for the database query. Switching from using statsd to InfluxDB is simply a matter of switch from the metrics.StatsdMixin to the metrics.InfluxDBMixin.
The mix-in is configured through the tornado.web.Application settings property using a key defined by the specific mix-in. The following snippet configures the StatsD mix-in from common environment variables:
import os
from sprockets.mixins import metrics
from tornado import web
def make_application():
settings = {
metrics.StatsdMixin.SETTINGS_KEY: {
'namespace': 'my-application',
'host': os.environ.get('STATSD_HOST', '127.0.0.1'),
'port': os.environ.get('STATSD_PORT', '8125'),
}
}
return web.Application([
# insert handlers here
], **settings)
Development Quickstart
$ python3.4 -mvenv env
$ env/bin/pip install -r requires/development.txt
$ . ./env/bin/activate
(env)$ nosetests
test_that_cached_socket_is_used (tests.StatsdMethodTimingTests) ... ok
test_that_counter_accepts_increment_value (tests.StatsdMethodTimingTests) ... ok
test_that_counter_increment_defaults_to_one (tests.StatsdMethodTimingTests) ... ok
test_that_default_prefix_is_stored (tests.StatsdMethodTimingTests) ... ok
test_that_execution_timer_records_time_spent (tests.StatsdMethodTimingTests) ... ok
test_that_http_method_call_is_recorded (tests.StatsdMethodTimingTests) ... ok
----------------------------------------------------------------------
Ran 6 tests in 1.089s
OK
(env)$ ./setup.py build_sphinx -q
running build_sphinx
(env)$ open build/sphinx/html/index.html
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for sprockets.mixins.metrics-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 04f07663cd4a7d3ef9426a222a846f8916e708dad8c4758b11a8976e827c85dd |
|
MD5 | f35fcb43df4fbd310a619d043e4ec4bc |
|
BLAKE2b-256 | 8965eda5f9c6fc560c3a3535cfb4d60ce892285092a49f37bb9f7ced21c0e757 |