django-app-metrics A reusable Django application for tracking and emailing application metrics
Download

django-app-metrics Ranking & Summary

django-app-metrics Tags

Django application metrics Django metrics

django-app-metrics Description

django-app-metrics is a Django app that allows you to capture and report on various events in your applications. You simply define various named metrics and record when they happen. These might be certain events that may be immediatey useful, for example 'New User Signups', 'Downloads', etc.Or they might not prove useful until some point in the future. But if you begin recording them now you'll have great data later on if you do need it.For example 'Total Items Sold' isn't an exciting number when you're just launching when you only care about revenue, but being able to do a contest for the 1 millionth sold item in the future you'll be glad you were tracking it.You then group these individual metrics into a MetricSet, where you define how often you want an email report being sent, and to which User(s) it should be sent.Usagefrom app_metrics.utils import create_metric, metric# Create a new metric to trackmy_metric = create_metric(name='New User Metric', slug='new_user_signup')# Create a MetricSet which ties a metric to an email schedule and sets# who should receive itmy_metric_set = create_metric_set(name='My Set', metrics=, email_recipients=)# Increment the metric by onemetric('new_user_signup')# Increment the metric by some other numbermetric('new_user_signup', 4)# Aggregate metric items into daily, weekly, monthly, and yearly totals# It's fairly smart about it, so you're safe to run this as often as you# likemanage.py metrics_aggregate# Send email reports to usersmanage.py metrics_send_mailBackendsapp_metrics.backends.db (Default) - This backend stores all metrics and aggregations in your database. NOTE: Every call to metric() generates a database write, which may decrease your overall performance is you go nuts with them or have a heavily traffic site.app_metrics.backends.mixpanel - This backend allows you to pipe all of your calls to metric() to Mixpanel. See the Mixpanel documentation for more information on their API.app_metrics.backends.statsd - This backend allows you to pipe all of your calls to metric() to a statsd server. See statsd for more information on their API.SettingsAPP_METRICS_BACKEND - Defaults to 'app_metrics.backends.db' if not defined.APP_METRICS_SEND_ZERO_ACTIVITY - Prevent e-mails being sent when there's been no activity today (i.e. during testing). Defaults to True.Mixpanel SettingsSet APP_METRICS_BACKEND == 'app_metrics.backends.mixpanel'.APP_METRICS_MIXPANEL_TOKEN - Your Mixpanel.com API tokenAPP_METRICS_MIXPANEL_URL - Allow overriding of the API URL end pointStatsd SettingsSet APP_METRICS_BACKEND == 'app_metrics.backends.statsd'.APP_METRICS_STATSD_HOST - Hostname of statsd server, defaults to 'localhost'APP_METRICS_STATSD_PORT - statsd port, defaults to '8125'APP_METRICS_STATSD_SAMPLE_RATE - statds sample rate, defaults to 1Product's homepage

django-app-metrics Related Software