Skip to content
This repository has been archived by the owner on Jun 19, 2020. It is now read-only.

Sample application insights client used with Visual Studio Team Services extensions

License

Notifications You must be signed in to change notification settings

ALM-Rangers/telemetryclient-vsts-extension

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

telemetryclient-vsts-extension

VSTS | NPM

Get insights in the usage of your extension by leveraging Microsoft Application Insights. Data will only be tracked for extensions running in Visual Studio Team Services (VSTS). If your extension is installed in TFS On-Premise, the calls to Application Insights will be skipped.

See How to integrate Application Insights monitoring in your Team Services extension, which demonstrates how to integrate Application Insights telemetry in your extension by using this package.

Getting Started

  1. Install the package through npm: npm install telemetryclient-team-services-extension

  2. In TypeScript, import the component:

    import * as tc from "TelemetryClient";
    
  3. Create a configuration object for the telemetryclient. It should contain two values, like this:

    var settings: tc.TelemetryClientSettings = {
        key: "your-key-here",
        extensioncontext: "your-extension-context-here",
        disableTelemetry : "true" or "false",
        disableAjaxTracking  : "true" or "false",
        enableDebug  : "true" or "false"
    };
    
    • The key is your Application Insights instrumentation key.
    • The extensioncontext is the context for your extension. You can use it to differentiate between multiple extensions in the same Application Insights resource.
    • The disableTelemetry for enabled or disabled telemetry
    • The disableAjaxTracking for enabled or disabled dependencies Ajax disableAjaxTracking
    • The enableDebug for enabled or disabled debuging

    You can see an sample on our extension

    More info on API configuration

  4. Then you can track usage by calling the various methods:

     tc.TelemetryClient.getClient(settings).trackPageView()
     tc.TelemetryClient.getClient(settings).trackEvent()
     tc.TelemetryClient.getClient(settings).trackException()
     tc.TelemetryClient.getClient(settings).trackMetric()
     tc.TelemetryClient.getClient(settings).trackTrace()
    

Prerequisites

  • Visual Studio Team Services
  • Application Insights resource in Azure

Contributions

Team

We thank the following contributor(s): Kees Verhaar and Mikael Krief

Contributions are welcome

Here is how you can contribute to this project:

  • Submit bugs and help us verify fixes
  • Submit pull requests for bug fixes and features and discuss existing proposals

Please refer to Contribution guidelines and the Code of Conduct for more details.

Notices

Building this solution will download other software, subject to the third party license terms that are between you and the third party.

And npm dependencies list are :

About

Sample application insights client used with Visual Studio Team Services extensions

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published