appinsights-usage/README.md

Javascript module to track usage with Application Insights

# appinsights-usage

### Javascript module to track usage with [Application Insights](https://github.com/Microsoft/ApplicationInsights-JS/blob/master/API-reference.md).

Current version supports tracking sessions only. 
We measure session by tracking user activity in web application per browser. Session is closed if user is not active for 30 minutes or he closes all browser tabs with application.

## Installation

With npm:
```bash
npm install appinsights-usage -save
```

## Usage

Include following lines to index.js:

```javascript
  var AppInsightsUsage = require('appinsights-usage');
  AppInsightsUsage.init({instrumentationKey:'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx'});
```

See [How to get instrumentation key for Applicaton Insights](https://azure.microsoft.com/en-us/documentation/articles/app-insights-nodejs/) for more details.

To see this metric in Azure portal you need to navigate to Application Insights resource, select Metrics Explorer from the top menu and configure one of the empty charts to display Custom metrics "Session Duration (seconds)" . It can take up to 10 minutes for new custom metric to appear in Azure Portal.

<img width="600" src="https://cloud.githubusercontent.com/assets/3801171/18802082/a3f91296-819b-11e6-90bb-61e5a0cfbe0c.png"/>