@@ -12,13 +12,17 @@ ms.custom: sap:Application Insights portal experiences
1212## Create work item option missing in transaction details
1313
1414** Cause:** Integration not enabled or resource not linked to Azure DevOps/GitHub.
15+
1516** Check:** In Application Insights, go to ** Work Items** and confirm integration settings.
17+
1618** Fix:** Enable integration and ensure you start from ** Create a work item** or a workbook template.
1719
1820## On-premises Azure DevOps URL rejected
1921
2022** Cause:** URL validation fails due to unsupported format.
23+
2124** Check:** Ensure the URL uses HTTPS and matches the regex (regular expressions) in the workbook parameter.
25+
2226** Fix:** Update the workbook's repository URL parameter and validation rule.
2327
2428> [ !NOTE]
@@ -27,12 +31,15 @@ ms.custom: sap:Application Insights portal experiences
2731## Authorization prompt missing or linking fails
2832
2933** Cause:** Popup blockers or stale tokens.
34+
3035** Check:** Disable popup blockers, allow third-party cookies, and clear browser cache.
36+
3137** Fix:** Retry linking. If using OAuth, confirm required scopes are granted.
3238
3339## Work item creation fails with permission errors
3440
3541** Cause:** Insufficient permissions in Azure DevOps or GitHub.
42+
3643** Check:** Verify account roles:
3744
3845* Azure DevOps: Needs * Contribute* permission.
@@ -43,30 +50,39 @@ ms.custom: sap:Application Insights portal experiences
4350## Template fails to load or save
4451
4552** Cause:** Region or RBAC issues.
53+
4654** Check:** Confirm region supports * Microsoft.Insights/workbooks* and resource provider is registered.
55+
4756** Fix:** Assign * Microsoft.Insights/workbooks/write* role or try saving in a supported region.
4857
4958## Contextual data missing from created work items
5059
5160** Cause:** KQL query returns unexpected schema.
61+
5262** Check:** Run the query in ** Logs** and validate output fields.
63+
5364** Fix:** Update bindings or query to match expected schema.
5465
5566## Template not visible to other users
5667
5768** Cause:** Workbook saved as private or RBAC restrictions.
69+
5870** Check:** Ensure template is in a shared resource group and not saved as * My Reports* .
71+
5972** Fix:** Grant at least * Reader* access to the resource.
6073
6174## Template deletion doesn't remove existing links
6275
6376** Cause:** Cached configuration persists.
77+
6478** Fix:** Refresh the ** Work Items** pane or clear browser cache. For persistent links, manually unlink in resource settings.
6579
6680## GitHub issue or DevOps item opens in wrong repository/project
6781
6882** Cause:** Incorrect default parameter or multiple templates.
83+
6984** Check:** Open the workbook and confirm repository/organization URL.
85+
7086** Fix:** Update defaults or remove conflicting templates.
7187
7288[ !INCLUDE [ Azure Help Support] ( ../../../includes/azure-help-support.md )]
0 commit comments