Application Insights Azue DevOps Release Annotations Implementation Update

Published Jun 01 2021 02:14 PM 4,727 Views
Microsoft

Visualizations & Workbooks are a key component of the App Insights experience. They enable customers to monitor performance / failure trends & debug issues as they occur. 

 

While performance data is critical to understanding the health of your application by itself it lacks the full context to help you understand why performance issues may be happening. Release Annotations are a simple way to add context & quantify the impact of an Azure DevOps release on your metrics. 

 
 

Annotations.png

 

Annotations can be automatically created by the Azure Pipelines build system. You can also create annotations to flag any event you like by creating them from PowerShell.

 

If your subscription has an Application Insights resource linked to it and you use one of the following deployment tasks, then you don't need to configure anything else.

 

Task code Task name Versions
AzureAppServiceSettings Azure App Service Settings Any
AzureRmWebAppDeployment Azure App Service deploy V3 and above
AzureFunctionApp Azure Functions Any
AzureFunctionAppContainer Azure Functions for container Any
AzureWebAppContainer Azure Web App for Containers Any
AzureWebApp Azure Web App Any

 

You can also write custom annotations by using an inline PowerShell script.

 

Release annotations are a feature of the cloud-based Azure Pipelines service of Azure DevOps & only available for Azure DevOps repos today.

 

If you're using the App Insights release task today please delete it & switch to the new implementation.

 

Learn more:

Release Annotations documentation

1 Comment
%3CLINGO-SUB%20id%3D%22lingo-sub-2406008%22%20slang%3D%22en-US%22%3EApplication%20Insights%20Azue%20DevOps%20Release%20Annotations%20Implementation%20Update%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-2406008%22%20slang%3D%22en-US%22%3E%3CP%3EVisualizations%20%26amp%3B%20Workbooks%20are%20a%20key%20component%20of%20the%20App%20Insights%20experience.%20They%20enable%20customers%20to%20monitor%20performance%20%2F%20failure%20trends%20%26amp%3B%20debug%20issues%20as%20they%20occur.%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EWhile%20performance%20data%20is%20critical%20to%20understanding%20the%20health%20of%20your%20application%20by%20itself%20it%20lacks%20the%20full%20context%20to%20help%20you%20understand%20why%20performance%20issues%20may%20be%20happening.%20%3CSTRONG%3ERelease%20Annotations%3C%2FSTRONG%3E%26nbsp%3Bare%20a%20simple%20way%20to%20add%20context%20%26amp%3B%20quantify%20the%20impact%20of%20an%20Azure%20DevOps%20release%20on%20your%20metrics.%26nbsp%3B%3C%2FP%3E%0A%3CDIV%20id%3D%22tinyMceEditorcasocha_0%22%20class%3D%22mceNonEditable%20lia-copypaste-placeholder%22%3E%26nbsp%3B%3C%2FDIV%3E%0A%3CDIV%20id%3D%22tinyMceEditorcasocha_1%22%20class%3D%22mceNonEditable%20lia-copypaste-placeholder%22%3E%26nbsp%3B%3C%2FDIV%3E%0A%3CP%3E%3CSPAN%20class%3D%22lia-inline-image-display-wrapper%20lia-image-align-inline%22%20image-alt%3D%22Annotations.png%22%20style%3D%22width%3A%20999px%3B%22%3E%3CIMG%20src%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fimage%2Fserverpage%2Fimage-id%2F285453i10858976D443E9E8%2Fimage-size%2Flarge%3Fv%3Dv2%26amp%3Bpx%3D999%22%20role%3D%22button%22%20title%3D%22Annotations.png%22%20alt%3D%22Annotations.png%22%20%2F%3E%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSPAN%3EAnnotations%20can%20be%20automatically%20created%20by%20the%26nbsp%3B%3C%2FSPAN%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fazure%2Fdevops%2Fpipelines%2Ftasks%2F%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%20data-linktype%3D%22absolute-path%22%3EAzure%20Pipelines%3C%2FA%3E%3CSPAN%3E%26nbsp%3Bbuild%20system.%20You%20can%20also%20create%20annotations%20to%20flag%20any%20event%20you%20like%20by%20creating%20them%20from%20PowerShell.%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EIf%20your%20subscription%20has%20an%20Application%20Insights%20resource%20linked%20to%20it%20and%20you%20use%20one%20of%20the%20following%20deployment%20tasks%2C%20then%20you%20don't%20need%20to%20configure%20anything%20else.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CDIV%20class%3D%22table-scroll-wrapper%22%3E%0A%3CTABLE%20class%3D%22table%22%3E%0A%3CTHEAD%3E%0A%3CTR%3E%0A%3CTH%3ETask%20code%3C%2FTH%3E%0A%3CTH%3ETask%20name%3C%2FTH%3E%0A%3CTH%3EVersions%3C%2FTH%3E%0A%3C%2FTR%3E%0A%3C%2FTHEAD%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%3EAzureAppServiceSettings%3C%2FTD%3E%0A%3CTD%3EAzure%20App%20Service%20Settings%3C%2FTD%3E%0A%3CTD%3EAny%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%3EAzureRmWebAppDeployment%3C%2FTD%3E%0A%3CTD%3EAzure%20App%20Service%20deploy%3C%2FTD%3E%0A%3CTD%3EV3%20and%20above%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%3EAzureFunctionApp%3C%2FTD%3E%0A%3CTD%3EAzure%20Functions%3C%2FTD%3E%0A%3CTD%3EAny%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%3EAzureFunctionAppContainer%3C%2FTD%3E%0A%3CTD%3EAzure%20Functions%20for%20container%3C%2FTD%3E%0A%3CTD%3EAny%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%3EAzureWebAppContainer%3C%2FTD%3E%0A%3CTD%3EAzure%20Web%20App%20for%20Containers%3C%2FTD%3E%0A%3CTD%3EAny%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%3EAzureWebApp%3C%2FTD%3E%0A%3CTD%3EAzure%20Web%20App%3C%2FTD%3E%0A%3CTD%3EAny%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EYou%20can%20also%20write%20%3CSTRONG%3Ecustom%20annotations%3C%2FSTRONG%3E%20by%20using%20an%20inline%20PowerShell%20script.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3ERelease%20annotations%20are%20a%20feature%20of%20the%20cloud-based%20Azure%20Pipelines%20service%20of%20Azure%20DevOps%20%26amp%3B%20only%20available%20for%20Azure%20DevOps%20repos%20today.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3EIf%20you're%20using%20the%20App%20Insights%20release%20task%20today%20please%20delete%20it%20%26amp%3B%20switch%20to%20the%20new%20implementation.%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3ELearn%20more%3A%3C%2FSTRONG%3E%3C%2FP%3E%0A%3CP%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fazure%2Fazure-monitor%2Fapp%2Fannotations%22%20target%3D%22_self%22%20rel%3D%22noopener%20noreferrer%22%3ERelease%20Annotations%20documentation%3C%2FA%3E%3C%2FP%3E%0A%3C%2FDIV%3E%3C%2FLINGO-BODY%3E%3CLINGO-TEASER%20id%3D%22lingo-teaser-2406008%22%20slang%3D%22en-US%22%3E%3CP%3EThe%20App%20Insights%20team%20has%20updated%20our%20Release%20Annotations%20implementation%20to%20enable%20easy%20access%20when%20using%20Azure%20DevOps%20pipelines.%26nbsp%3B%3C%2FP%3E%3C%2FLINGO-TEASER%3E%3CLINGO-LABS%20id%3D%22lingo-labs-2406008%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3EUpdates%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E%3CLINGO-SUB%20id%3D%22lingo-sub-2430532%22%20slang%3D%22en-US%22%3ERe%3A%20Application%20Insights%20Azue%20DevOps%20Release%20Annotations%20Implementation%20Update%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-2430532%22%20slang%3D%22en-US%22%3E%3CP%3EWhat%20about%20all%20of%20us%20who%20use%20any%20other%20deployment%20method%20(ARM%20deployments%2C%20PowerApps%2C%20multi-cloud%20deployments%2C....%20you-name-it)%3F%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EI%20woke%20up%20this%20morning%20to%20find%20all%20my%20deployment%20dashboards%20fully%20red%20because%2C%20without%20warning%2C%20you%20deprecated%20the%20App%20Insights%20release%20task%2C%20and%20suddenly%20every%20pipeline%20is%20raising%20warnings.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EDon't%20get%20me%20wrong%2C%20I%20like%20the%20feature...%20it's%20just%20the%20roll-out%20that%20I%20consider%20'sub-par'%2C%20to%20say%20the%20least...%3C%2FP%3E%3C%2FLINGO-BODY%3E
Version history
Last update:
‎Apr 08 2022 11:16 AM
Updated by: