Application Insights Azue DevOps Release Annotations Implementation Update

Published Jun 01 2021 02:14 PM 1,273 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
Occasional Visitor

What about all of us who use any other deployment method (ARM deployments, PowerApps, multi-cloud deployments,.... you-name-it)?

 

I woke up this morning to find all my deployment dashboards fully red because, without warning, you deprecated the App Insights release task, and suddenly every pipeline is raising warnings.

 

Don't get me wrong, I like the feature... it's just the roll-out that I consider 'sub-par', to say the least...

%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
Co-Authors
Version history
Last update:
‎Jun 01 2021 02:18 PM
Updated by: