App Center bug tracker integration

Overview

App Center has bug tracker integration for the crashes service. Users can be quickly informed about critical App Center events within the tools that you use regularly in your day to day flow for a seamless experience. App Center supports bug trackers like Jira, Azure DevOps (formerly Visual Studio Team Services (VSTS)), and GitHub. Users need to have manager or developer permissions to be able to create and configure the bug tracker.

Getting Started

  1. Navigate to https://appcenter.ms/apps, and select the specific app you would like for bug tracker integration.

  2. In your app, select Settings, Services, and click the edit button.

  3. Select which bug tracker (Jira, VSTS, Azure DevOps, or GitHub) to integrate with. In order to add a bug tracker for a repository, you need admin permissions for it.

    1. For Jira:

      1. Login with your Jira credentials (username, password and base URL) and click Add. Please see here on how to find your base URL.
      2. Select which Jira projects to integrate the bug tracker with and click Next.
      3. Under Add bug tracker, fill in the fields for Number of crashes and click Add:
        • Number of crashes is a threshold you can set for the minimum number of crashes to happen in a crash group before a ticket is created in Jira.

          How to add a bug tracker for Jira

    2. For Azure DevOps (formerly VSTS):

      1. Login with your Azure DevOps credentials and click Accept when prompted on app authorization.
      2. Select which Azure DevOps projects to integrate the bug tracker with and click Next.
      3. Under Add bug tracker, fill in the fields for Number of crashes, Area and Default Payload, and click Add:
        • Number of crashes is a threshold you can set for the minimum number of crashes to happen in a crash group before a ticket is created in Azure DevOps.

        • Default payload is an optional field to fill in for use in work items. For example, {"System.IterationPath": "Area\\Iteration 1", "System.AssignedTo": "Fabrikam"}. Please refer to the work item types API for additional information.

          How to add a bug tracker for Azure DevOps

    3. For GitHub:

      1. Login with your GitHub credentials and click Authorize App Center.
      2. Select which GitHub repository to integrate the bug tracker with and click Next.
      3. Under Add bug tracker, fill in the fields for Number of crashes and click Add:
        • Number of crashes is a threshold you can set for the minimum number of crashes to happen in a crash group before an issue is created in GitHub.

          How to add a bug tracker for GitHub

  4. Done! Your bug tracker is now configured. With this configuration:

    • When a new crash group is created in App Center, it will trigger the creation of a bug in the configured bug tracker
    • The bug will contain a link to the crash group in App Center
    • When you change the state of the crash group in App Center, it changes the state of the bug in the connected bug tracker, and vice versa.
  5. Toggle to the extreme right hand of the bug tracker to Configure or Disconnect it.

    • Configure enables you to change the responses to Auto create ticket, Number of crashes, Area, and Default payload.
    • Disconnect unlinks all the bugs from your crash group.
  6. Bug tracker integration is done at the app level, and only one bug tracker can be configured per app. To change bug trackers:

    1. Go to the Services page.
    2. Toggle to the extreme right hand of the bug tracker to Disconnect it.
    3. Repeat step 3.

Changing the state of a crash group in App Center

  1. Navigate to https://appcenter.ms/apps, and select the specific app that has a bug tracker integration.

  2. In your app, select Diagnostics, Crashes, and click on the crash group that has a connected bug associated with it.

  3. In the top right corner, click on the green drop down box that has either of the states:

    • Open
    • Closed
    • Ignored
  4. Choose the state of the crash group. Once you've changed the state of the crash group in App Center, it will update the state in bug. Similarly, if you change the state of the bug in your connected bug tracker, it will update the state in the crash group as well.