Microsoft Azure DevOps (VSTS) Integration Guide | PagerDuty

Microsoft Azure DevOps (VSTS) + PagerDuty Benefits

  • Manually or automatically create VSTS work items from a PagerDuty incident.
  • Notify on-call responders for critical VSTS work items.
  • Dashboard widgets display PagerDuty incident information and on-call schedules.

Requirements

To Configure the Integration

In PagerDuty:

  • Admins, Global Admins and Account Owners can configure the integration.

In VSTS:

  • Users must have sufficient permissions to install extensions, create personal access tokens (PATs), and edit organization settings (Extensions).

To Use the Integration

In PagerDuty:

  • Responders, Managers, Admins, Global Admins and Account Owners can create work items from PagerDuty incidents.

In VSTS:

  • Users must have sufficient permissions to manage work items.

How it Works

  • Create VSTS work items within PagerDuty via webhooks.
  • Create PagerDuty incidents in VSTS using a PagerDuty REST API key.
  • View PagerDuty incidents within VSTS without logging in to PagerDuty.

Version

This integration is currently in Early Access for customers on all current pricing plans. Please reach out to Support to enable this extension on your account.

Integration Walkthrough

In Microsoft VSTS

  1. Navigate to PagerDuty in the Visual Studio Marketplace and click Get it free.
26102610

PagerDuty in the Visual Studio Marketplace

  1. With your account selected, click Install.
916916

Install PagerDuty extension

  1. Click Proceed to organization.
10381038

Proceed to organization

  1. Next, you will generate a personal access token (PAT) — go to User settings Personal access tokens.
832832

Personal access tokens

  1. Click New Token and create a token with the following configuration:
    • Name: Enter a name for your personal access token, for example, “PagerDuty Extension”.
    • Expiration: Select Custom defined and enter a date one year in the future.
    • Scopes: Select Custom defined and click Show all scopes.
      • Extension Data: Read & write
      • Extensions: Read & manage
      • Project and Team: Read & write
      • Security: Manage
      • Work Items: Read, write, & manage
  2. Click Create.
  3. In the success pane, copy your PAT to the clipboard; you will use it in the next section.
    • Note: Please store your PAT in a safe place. For security’s sake, Microsoft does not store it, and you will not be able to see it again after closing the success message.
16041604

Personal access token

In PagerDuty

  1. In the web app, go to Integrations Extensions.
  2. With the tab Service Extensions selected, click New Extension.
11831183

Click "New Extension"

  1. From the dropdown, select Azure DevOps (Formerly Microsoft VSTS), and in the modal window click Open.
20742074

Add extension

  1. Enter your personal authorization token (PAT) and click Save token.
22482248

Enter personal access token

  1. Enter the appropriate information for the following fields:
  • Select PagerDuty Services
  • Select a VSTS Account
  • Select a Work Item
  • Sync Work Items
25502550

Configure integration

  1. Click Add to VSTS.

In Microsoft VSTS

  1. To complete the integration, go to Organization settings PagerDuty Configuration.
  2. In the field Default email for incident creation, enter an email address associated with a valid PagerDuty user. In the field API Key, enter a PagerDuty REST API key.
18521852

PagerDuty user email and API key

  1. Click Save.

VSTS User Guide

Create VSTS Tasks in PagerDuty

If you selected Automatically in step 12 above, all PagerDuty incidents on the selected service(s) will open work items in the associated VSTS project. If you selected Manually, you can turn a PagerDuty incident into a VSTS work item in the PagerDuty web app.

  1. In PagerDuty, navigate to an incident that triggered on a service with the VSTS extension configured. Select More Create Work Item.
10001000

Create work item

  1. Refresh the page to view the direct link to the work item in VSTS.
21582158

PagerDuty incident details

Create a PagerDuty Incident in VSTS

  1. In VSTS, go to Boards Work items.
  2. Click New Work Item and select Epic, Issue or Task, depending on the context.
  3. Enter a Title for your work item and click Save.
  4. Refresh the page.
  5. In the section PagerDuty Incident, search for or select a service and click Create Incident.
866866

Create PagerDuty incident in VSTS

Note: If you receive an error message related to the requester’s email address or API key, please validate the information you entered in the final configuration steps.

Add PagerDuty Widgets to a VSTS Dashboard

  1. In VSTS, go to your project select Dashboards click Add a widget or select a dashboard and click Edit.
  2. In the Add Widget pane, search for pagerduty and select PagerDuty Incidents or PagerDuty OnCall.
12821282

PagerDuty widgets

  1. Click Add.
  2. Reorganize the widgets’ layout, if needed, and click Done Editing.

Did this page help you?