Metadata-Version: 2.0
Name: avk-django-datadog
Version: 0.1.0.7
Summary: Simple Django middleware for submitting timings and exceptions to Datadog.
Home-page: https://github.com/conorbranagan/django-datadog
Author: Conor Branagan
Author-email: conor.branagan@gmail.com
License: BSD
Platform: UNKNOWN

# Django Datadog

A simple Django middleware for submitting timings and exceptions to Datadog.

## Installation

Download the code into your project and install it.

```bash
git clone git://github.com/conorbranagan/django-datadog.git
cd django-datadog
python setup.py install
```

Add `datadog` to your list of installed apps.

```python
INSTALLED_APPS += ('datadog')
```

Add the following configuration to your projects' `settings.py` file:

```python
DATADOG_API_KEY = 'YOUR_API_KEY'
DATADOG_APP_KEY = 'YOUR_APP_KEY'
DATADOG_APP_NAME = 'my_app' # Used to namespace metric names
```

The API and app keys can be found at https://app.datadoghq.com/account/settings#api

Add the Datadog request handler to your middleware in `settings.py`.

```python
MIDDLEWARE += ('datadog.middleware.DatadogMiddleware',)
```

## Usage

Once the middlewhere installed, you'll start receiving events in your Datadog
stream in the case of an app exception. Here's an example:

You will also have new timing metrics available:

- `my_app.request_time.{avg,max,min}`
- `my_app.errors`

Metrics are tagged with `path:/path/to/view`

Note: `my_app` will be replaced by whatever value you give for `DATADOG_APP_NAME`.


