# Bug Tracking Configuration

Connect with bug tracking applications to track bugs you encounter while testing your application. Test Studio has integration with the TFS and Jira bug trackers and will log bugs directly into the configured defect tracking system. The bug tracking integration is pluggable and you also can <a href="/features/integration/bug-tracking/custom-plugin" target="_blank">build a plug-in</a> for your custom-made, in-house system.

* <a href="/features/integration/bug-tracking/configuration#team-foundation-server-and-azure-devops">TFS</a>
* <a href="/features/integration/bug-tracking/configuration#jira-server">Jira Server</a>
* <a href="/features/integration/bug-tracking/configuration#jira-cloud">Jira Cloud</a>

## Team Foundation Server and Azure DevOps

1. Click the Bug Tracking button under the *Extensions* section in the *Project* ribbon.

   ![Bug Tracking](https://www.telerik.com/teststudio/documentation/assets/deca78c8d756900a4f37856d29b02f0f/bug-report-icon-navigate.png)

2. The **Manage Bug Tracking** dialog appears, where the integrated systems are listed. Select the desired application and click the pencil ![Pencil](https://www.telerik.com/teststudio/documentation/assets/897a8e1a3f11ab3f14e9194a78a8474d/fig2.png) to **Configure Selected**.

   ![Manage Bug Tracking](https://www.telerik.com/teststudio/documentation/assets/e430726b540c4173f2df93688d04719e/bug-report-propt.png)

3. From the first dropdown select the tracker you will configure - on-premise TFS server or the online service currently named Azure DevOps.

   ![Bug Tracking Setup select TFS on-premise or online](https://www.telerik.com/teststudio/documentation/assets/88301fe1f2860881a66ed305e4a3046a/fig4.png)

4. Enter the Server URL and click the **Connect** button.

<table id="no-table" style="border:none;">
	<tr style="text-align: center; background-color: transparent; border:none;">
		<td>

<img src="/teststudio/documentation/assets/8b6aebb4c8bbf9ac3f9ca5f8dd0c76c0/fig5.png" alt="TFS service Online" /> <br><br>Azure DevOps (Online TFS Service)</td>

<td>

<img src="/teststudio/documentation/assets/7cbf766c428f4a5ec452a188ca639d39/fig6.png" alt="TFS server on premise" /> <br><br>TFS Server on-premise</td>

</tr>
</table>

Enter valid credentials when prompted. The below example requires username and password for the Azure DevOps service.

![TFS Login](https://www.telerik.com/teststudio/documentation/assets/4540ad931202a886e456df4202414fe1/fig7.png)

5. Once the connection to the server is successfully established, select the **Team Project** for Azure DevOps, and the **Team Project Collection** and **Team Project** for on-premise server, then click **Save**.

<table id="no-table" style="border:none;">
	<tr style="text-align: center; background-color: transparent; border:none;">
		<td>

<img src="/teststudio/documentation/assets/bb61ae1cd0a6d27d5f09738313292ef5/fig8.png" alt="TFS service Online" /> <br><br>Azure DevOps (Online TFS Service)</td>

<td>

<img src="/teststudio/documentation/assets/98fd44bf0aded11c3d02bba46b000e5f/fig9.png" alt="TFS server on premise" /> <br><br>TFS Server on-premise</td>

</tr>
</table>

## Jira Server

1. Click the Bug Tracking button under the *Extensions* section in the *Project* ribbon.

   ![Bug Tracking](https://www.telerik.com/teststudio/documentation/assets/deca78c8d756900a4f37856d29b02f0f/bug-report-icon-navigate.png)

2. The **Manage Bug Tracking** dialog appears, where the integrated systems are listed. Select the desired application and click the pencil ![Pencil](https://www.telerik.com/teststudio/documentation/assets/897a8e1a3f11ab3f14e9194a78a8474d/fig2.png) to **Configure Selected**.

   ![Manage Bug Tracking](https://www.telerik.com/teststudio/documentation/assets/d98deda257b0a76bff2e59fdf60b7c63/bug-report-icon-navigate-jira.png)

3. Enter the Server URL, username and password and click the **Connect** button.

> The format of the server URL requires [http://jiraserver.com](http://jiraserver.com/) (dashboard or other links that end on \*.jspa are not accepted).

![Login to JIRA](https://www.telerik.com/teststudio/documentation/assets/5279af11560902e0ae4d80893dc52e97/fig10.png)

4. Select your project and click **Save**.

   ![Login to JIRA Tracker](https://www.telerik.com/teststudio/documentation/assets/634e97a9feb53e3735a5635c43019bae/fig11.png)

> The JIRA project schema should have a Bug item. The default schema of a new project does not contain such item and Test Studio would fail to submit a bug in that case.

> Please note that using **xxxx.jira.com** for connecting bug tracking to Test Studio requires HTTPS.

## Jira Cloud

1. Add the issue type **Bug** as an available issue type in your Jira Cloud administration panel.

   ![Issue Types](https://www.telerik.com/teststudio/documentation/assets/156c6fa66b085b1381f476419172c32e/fig13.jpg)

2. Your user must be a member of the “**jira-users**” group to  have permission to connect to Jira Cloud from Test Studio. You could also use the “admin” account.

   ![Group Membership](https://www.telerik.com/teststudio/documentation/assets/1880a97209341b1543d3b690b076cda8/fig14.jpg)

3. Use the correct URL to connect to your Jira Cloud server.

   ![Bug tracking settings](https://www.telerik.com/teststudio/documentation/assets/bf61d151454a1723fdf4ea2335355d5e/fig15.png)

4. Enter your Jira username and for a password use a <a href="https://id.atlassian.com/manage/api-tokens" target="_blank">Jira Token</a> generated for your account - that way Test Studio integration will successfully comply with the two-factor authentication for the Jira cloud server.

   ![Jira Login](https://www.telerik.com/teststudio/documentation/assets/96eb6fae7cb30576f2fdf7206f257bad/fig16.jpg)

## Set Default Configured Bug Tracker

The Bug Tracking applications are now properly configured. Select one to be the default and click **Save**.

![Manage Bug Tracking](https://www.telerik.com/teststudio/documentation/assets/cb4bb0d140f75db69eb59ff9af556828/fig12.png)

## Advanced Settings

Click **Advanced Settings** ![Advanced settings button](https://www.telerik.com/teststudio/documentation/assets/dd35318b008cb574595d75bed3022503/advanced-settings.png) to set whether to attach failure details and/or auto-submit.

* **Attach failure details** - Test Studio will include the bug information as an attachment. For example you will see the bug details as a File Attachment in TFS.

* **Auto-submit** - Everytime a test or step fails within a test list, Test Studio will automatically submit a bug for you. Please make sure that you've set up a default bug tracking tool.<br>

> **Note:** This is Test Studio **test list** execution feature only! It works for local and remote test list execution from Test Studio. It works also when test list is run through <a href="/features/test-runners/artoftest-runner" target="_blank">ArtOfTest.Runner</a> or through the scheduling command line client <a href="/features/scheduling-test-runs/tts-command-line-client" target="_blank">Telerik.TestStudio.CommandLineClient</a>.

![Bug Tracking Settings](https://www.telerik.com/teststudio/documentation/assets/b6bb1be5fd2fdfe9c8a906f3fe1c8480/choose-advanced-settings.png)
