Work Item Integration
Work item integration functionality allows you to easily create work items in GitHub or Azure DevOps that have relevant Application Insights data embedded in them.
The new work item integration offers the following features over classic:
- Advanced fields like assignee, projects, or milestones.
- Repo icons so you can differentiate between GitHub & Azure DevOps workbooks.
- Multiple configurations for any number of repositories or work items.
- Deployment through Azure Resource Manager templates.
- Pre-built & customizable Keyword Query Language (KQL) queries to add Application Insights data to your work items.
- Customizable workbook templates.
Create and configure a work item template
To create a work item template, go to your Application Insights resource and on the left under Configure select Work Items then at the top select Create a new template
You can also create a work item template from the end-to-end transaction details tab, if no template currently exists. Select an event and on the right select Create a work item, then Start with a workbook template.
After you select create a new template, you can choose your tracking systems, name your workbook, link to your selected tracking system, and choose a region to storage the template (the default is the region your Application Insights resource is located in). The URL parameters are the default URL for your repository, for example,
You can set specific work item properties directly from the template itself. This includes the assignee, iteration path, projects, & more depending on your version control provider.
Create a work item
You can access your new template from any End-to-end transaction details that you can access from Performance, Failures, Availability, or other tabs.
To create a work item go to End-to-end transaction details, select an event then select Create work item and choose your work item template.
A new tab in your browser will open up to your select tracking system. In Azure DevOps you can create a bug or task, and in GitHub you can create a new issue in your repository. A new work item is automatically create with contextual information provided by Application Insights.
Edit a template
To edit your template, go to the Work Items tab under Configure and select the pencil icon next to the workbook you would like to update.
Select edit at the top to begin editing the template. Work Item templates are based on Azure Monitor Workbooks. The work item information is generated using the keyword query language. You can modify the queries to add more context essential to your team. When you are done editing, save the workbook by selecting the save icon in the top toolbar.
You can create more than one work item configuration and have a custom workbook to meet each scenario. The workbooks can also be deployed by Azure Resource Manager ensuring standard implementations across your environments.
Classic work item integration
In your Application Insights resource under Configure select Work Items.
Select Switch to Classic, fill out the fields with your information, and authorize.
Create a work item by going to the end-to-end transaction details, select an event then select Create work item (Classic).
Migrate to new work item integration
To migrate, delete your classic work item configuration then create and configure a work item template to recreate your integration.
To delete, go to in your Application Insights resource under Configure select Work Items then select Switch to Classic and *Delete at the top.