Application Insights plugin for Apache Cordova apps
This plugin allows you to add an Application Insights to your Apache Cordova app. Application Insights is a techonogy that sends telemetry from your app to the Azure portal.
More info about Application Insights technology could be found here
To use this plugin you'll need an account in Microsoft Azure. You might already have access to a group account through your organization, or you might want to get a Pay-as-you-go account. (While Application Insights is in Preview, it's free.)
Application Insights API is available through
window.appInsights object. To start using it you don't have to initialize it, just start calling its' methods
// This will send a custom-defined event to your appInsights accountvar eventData = ButtonId: "trackSingleEvent" Timestamp: ;appInsights;// This will send data about how long some action is performedappInsights;// Emulate some long-running action through `setTimeout`;// This will send an exception information to your appInsights accounttry// Do some logic here which maythrow "Sample Error";catch err// Catch an error and send it to appInsightsappInsights;
More information about AppInsights API could be found here
Cordova CLI can be easily installed via NPM package manager:
npm install -g cordova
Additional prerequisites for each target platform can be found at Cordova platforms documentation page.
To build and run sample application
Clone this repository into a directory of your choice
git clone https://github.com/MSOpenTech/cordova-plugin-appinsights.git
Create a cordova project and add the platforms you want to support
cordova create AppInsightsSample --copy-from="cordova-plugin-appinsights/sample"
cordova platform add android
cordova platform add windows
cordova platform add ios
Add the plugin to your project
cordova plugin add ../cordova-plugin-appinsights
Set up intrumentation key for AppInsights API. Modify the following line in
config.xmlfile at the project root
<preference name="instrumentation_key" value="$INSTRUMENTATION_KEY">
$INSTRUMENTATION_KEY with your key.
optional: install battery and network status plugins to track their events to AppInsights as well.
cordova plugin add org.apache.cordova.battery-status org.apache.cordova.network-information
Build and run application:
Copyright (c) Microsoft Open Technologies, Inc. All Rights Reserved. Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.