Example of Ants logging usage

ants.py

from ants.views import log_event

def ant_log(request, eventname, data={}):
  # Sample wrapper using ants.log_event which always includes logged-in users' name and email, for instance...
  if not request.user.is_anonymous():
      data['user'] = '%s %s (%s)' % (request.user.first_name, request.user.last_name, request.user.email)
  log_event(request, eventname, 'mysite', data)

def my_view(request):
  # Your code...
  # Example usage of our new ant_log wrapper to log this view:
  ant_log(request, 'my_view', { 'some_more_data': request.POST['some_more_data'] })
  # Return value, etc...

url.py

urlpatterns = patterns(
  # Your urls...
  (r'/ants/?', 'ants.views.visual', {'group': 'mysite'}),
  (r'/ants/update/?', 'ants.views.ajax', {'group': 'mysite'}),
  # etc...
)

visual.py

# Sample view that serves the timeline
# Uses ants.views.visual with same groupname argument as used in ant_log
# Point a url to this and you've installed Ants

def show_ants(request):
  return visual(request, 'mysite')