Microsoft Visual Studio Team Services / Azure DevOps Integration Guide

Microsoft Azure DevOps (formerly Microsoft Visual Studio Team Services (VSTS)) is a cloud service for collaborating on code development. It provides an integrated set of features that you access through your web browser or IDE client.

Choose VSTS when you want quick setup, maintenance-free operations, easy collaboration across domains, elastic scale, and rock solid security. You’ll also have access to cloud load testing, cloud build servers, and application insights.

This integration is in the early access stage for customers on all current pricing plans. Please reach out to support@pagerduty.com to enable this extension on your account.

In Microsoft VSTS

1. Add the PagerDuty Extension via the Marketplace.
2. Select Get it free.
3. Select your Account.
   
4. Once installed, go to your Account.
   
5. Next, you need to get a Personal Access Token (PAT). From Your Account, click Security.
   
6. Click Add to generate a new PAT.
7. Select the Expiration for 1 Year in the future, Custom defined as the scope, and the following custom-defined scopes:
   • Extension Data: Read & Write
   • Extensions: Read & Manage
   • Project and Team: Read & write
   • Security: Manage
   • Work Items: Read, write & manage

   

In PagerDuty

Go to the Configuration menu and select Extensions.

1. Once you are on the Extensions page, go to the section for Service Extensions.
2. Under the Service Extensions section, click + New Extension and in the Select an Extension field, search for and select “Microsoft Visual Studio Team Services”
3. Add your Microsoft VSTS PAT Key.
   
4. Link your PagerDuty instance to VSTS (pause between selecting the Domains, Accounts and Project for the API to complete).
   
5. Create a Test incident in the Service with the VSTS Extension.
   
6. Refresh the Incident page to get the context link directly into VSTS.
   

In Microsoft VSTS

1. 1. In order to Test, Create a Work Item, Save, then Reopen and Trigger an incident.
   2. You can validate that the Extension is installed by adding the new Widgets to your main dashboard.
      
   3. To complete the integration, go to Settings, then Account Settings.
      
   4. On the PagerDuty Configuration tab, add a PagerDuty REST API key.
   5. Optional: Enter a valid email address for a user on your PagerDuty account. This will be used if the integration cannot identify a PagerDuty account for the Microsoft VSTS user performing the action.
      

• You can also view all the open PagerDuty incidents directly in VSTS without the need for a PagerDuty login.