From fa07b6d95a5637e8cfd3bb7e328f1d3a89b9dfc2 Mon Sep 17 00:00:00 2001 From: Jackson Weber <47067795+JacksonWeber@users.noreply.github.com> Date: Fri, 27 Sep 2024 17:00:48 -0700 Subject: [PATCH 1/5] Proposed organization of the release notes for the app service docs --- articles/azure-monitor/app/azure-web-apps.md | 126 ++++++------------- 1 file changed, 35 insertions(+), 91 deletions(-) diff --git a/articles/azure-monitor/app/azure-web-apps.md b/articles/azure-monitor/app/azure-web-apps.md index f83cc5fb7f..3172b7b93b 100644 --- a/articles/azure-monitor/app/azure-web-apps.md +++ b/articles/azure-monitor/app/azure-web-apps.md @@ -43,102 +43,46 @@ If both autoinstrumentation monitoring and manual SDK-based instrumentation are ## Release notes -This section contains the release notes for Azure Web Apps Extension for runtime instrumentation with Application Insights. +This section contains the release notes for Azure Web Apps based on ANT release for runtime instrumentation with Application Insights. To find which version of the extension you're currently using, go to `https://.scm.azurewebsites.net/ApplicationInsights`. ### Release notes -#### 2.8.44 - -- .NET/.NET Core: Upgraded to [ApplicationInsights .NET SDK to 2.20.1](https://github.com/microsoft/ApplicationInsights-dotnet/tree/autoinstrumentation/2.20.1). - -#### 2.8.43 - -- Separate .NET/.NET Core, Java and Node.js package into different App Service Windows Site Extension. - -#### 2.8.42 - -- JAVA extension: Upgraded to [Java Agent 3.2.0](https://github.com/microsoft/ApplicationInsights-Java/releases/tag/3.2.0) from 2.5.1. -- Node.js extension: Updated AI SDK to [2.1.8](https://github.com/microsoft/ApplicationInsights-node.js/releases/tag/2.1.8) from 2.1.7. Added support for User and System assigned Microsoft Entra managed identities. -- .NET Core: Added self-contained deployments and .NET 6.0 support using [.NET Startup Hook](https://github.com/dotnet/runtime/blob/main/docs/design/features/host-startup-hook.md). - -#### 2.8.41 - -- Node.js extension: Updated AI SDK to [2.1.7](https://github.com/microsoft/ApplicationInsights-node.js/releases/tag/2.1.7) from 2.1.3. -- .NET Core: Removed out-of-support version (2.1). Supported versions are 3.1 and 5.0. - -#### 2.8.40 - -- JAVA extension: Upgraded to [Java Agent 3.1.1 (GA)](https://github.com/microsoft/ApplicationInsights-Java/releases/tag/3.1.1) from 3.0.2. -- Node.js extension: Updated AI SDK to [2.1.3](https://github.com/microsoft/ApplicationInsights-node.js/releases/tag/2.1.3) from 1.8.8. - -#### 2.8.39 - -- .NET Core: Added .NET Core 5.0 support. - -#### 2.8.38 - -- JAVA extension: upgraded to [Java Agent 3.0.2 (GA)](https://github.com/microsoft/ApplicationInsights-Java/releases/tag/3.0.2) from 2.5.1. -- Node.js extension: Updated AI SDK to [1.8.8](https://github.com/microsoft/ApplicationInsights-node.js/releases/tag/1.8.8) from 1.8.7. -- .NET Core: Removed out-of-support versions (2.0, 2.2, 3.0). Supported versions are 2.1 and 3.1. - -#### 2.8.37 - -- AppSvc Windows extension: Made .NET Core work with any version of System.Diagnostics.DiagnosticSource.dll. - -#### 2.8.36 - -- AppSvc Windows extension: Enabled Inter-op with AI SDK in .NET Core. - -#### 2.8.35 - -- AppSvc Windows extension: Added .NET Core 3.1 support. - -#### 2.8.33 - -- .NET, .NET core, Java, and Node.js agents and the Windows Extension: Support for sovereign clouds. Connections strings can be used to send data to sovereign clouds. - -#### 2.8.31 - -- The ASP.NET Core agent fixed an issue with the Application Insights SDK. If the runtime loaded the incorrect version of `System.Diagnostics.DiagnosticSource.dll`, the codeless extension doesn't crash the application and backs off. To fix the issue, customers should remove `System.Diagnostics.DiagnosticSource.dll` from the bin folder or use the older version of the extension by setting `ApplicationInsightsAgent_EXTENSIONVERSION=2.8.24`. If they don't, application monitoring isn't enabled. - -#### 2.8.26 - -- ASP.NET Core agent: Fixed issue related to updated Application Insights SDK. The agent doesn't try to load `AiHostingStartup` if the ApplicationInsights.dll is already present in the bin folder. It resolves issues related to reflection via Assembly\.GetTypes(). -- Known issues: Exception `System.IO.FileLoadException: Could not load file or assembly 'System.Diagnostics.DiagnosticSource, Version=4.0.4.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51'` could be thrown if another version of `DiagnosticSource` dll is loaded. It could happen, for example, if `System.Diagnostics.DiagnosticSource.dll` is present in the publish folder. As mitigation, use the previous version of extension by setting app settings in app services: ApplicationInsightsAgent_EXTENSIONVERSION=2.8.24. - -#### 2.8.24 - -- Repackaged version of 2.8.21. - -#### 2.8.23 - -- Added ASP.NET Core 3.0 codeless monitoring support. -- Updated ASP.NET Core SDK to [2.8.0](https://github.com/microsoft/ApplicationInsights-aspnetcore/releases/tag/2.8.0) for runtime versions 2.1, 2.2 and 3.0. Apps targeting .NET Core 2.0 continue to use 2.1.1 of the SDK. - -#### 2.8.14 - -- Updated ASP.NET Core SDK version from 2.3.0 to the latest (2.6.1) for apps targeting .NET Core 2.1, 2.2. Apps targeting .NET Core 2.0 continue to use 2.1.1 of the SDK. - -#### 2.8.12 - -- Support for ASP.NET Core 2.2 apps. -- Fixed a bug in ASP.NET Core extension causing injection of SDK even when the application is already instrumented with the SDK. For 2.1 and 2.2 apps, the presence of ApplicationInsights.dll in the application folder now causes the extension to back off. For 2.0 apps, the extension backs off only if ApplicationInsights is enabled with a `UseApplicationInsights()` call. - -- Permanent fix for incomplete HTML response for ASP.NET Core apps. This fix is now extended to work for .NET Core 2.2 apps. - -- Added support to turn off JavaScript injection for ASP.NET Core apps (`APPINSIGHTS_JAVASCRIPT_ENABLED=false appsetting`). For ASP.NET core, the JavaScript injection is in "Opt-Out" mode by default, unless explicitly turned off. (The default setting is done to retain current behavior.) - -- Fixed ASP.NET Core extension bug that caused injection even if ikey wasn't present. -- Fixed a bug in the SDK version prefix logic that caused an incorrect SDK version in telemetry. - -- Added SDK version prefix for ASP.NET Core apps to identify how telemetry was collected. -- Fixed SCM- ApplicationInsights page to correctly show the version of the pre-installed extension. - -#### 2.8.10 - -- Fix for incomplete HTML response for ASP.NET Core apps. +#### ANT 103 - Linux +
+ .NET/.NET Core + .NET/.NET Core content here +
+
+ Node.js + Released the private preview of the OpenTelemetry agent (insert version)
+ Production agent was updated to use (insert version) of the Node.js Application Insights SDK. +
+
+ Java + Java content here +
+
+ Python + Python content here +
+ +#### ANT 103 - Windows + +
+ .NET/.NET Core + .NET/.NET Core content here +
+
+ Node.js + Released the private preview of the OpenTelemetry agent (insert version)
+ Production agent was updated to use (insert version) of the Node.js Application Insights SDK. +
+
+ Java + Java content here +
## Frequently asked questions From 0553b62a84a28fa135e742475f82137bcd538fe7 Mon Sep 17 00:00:00 2001 From: Jackson Weber <47067795+JacksonWeber@users.noreply.github.com> Date: Mon, 30 Sep 2024 12:07:59 -0700 Subject: [PATCH 2/5] Update per Yutang suggestions --- articles/azure-monitor/app/azure-web-apps.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/azure-monitor/app/azure-web-apps.md b/articles/azure-monitor/app/azure-web-apps.md index 3172b7b93b..a90c62c550 100644 --- a/articles/azure-monitor/app/azure-web-apps.md +++ b/articles/azure-monitor/app/azure-web-apps.md @@ -49,7 +49,7 @@ To find which version of the extension you're currently using, go to `https:// .NET/.NET Core .NET/.NET Core content here @@ -68,7 +68,7 @@ To find which version of the extension you're currently using, go to `https:// -#### ANT 103 - Windows +#### Latest Version (default) - Windows
.NET/.NET Core From 44142227fdeefac47f35705589de26c3a3fb03e1 Mon Sep 17 00:00:00 2001 From: Jackson Weber <47067795+JacksonWeber@users.noreply.github.com> Date: Tue, 8 Oct 2024 16:08:31 -0700 Subject: [PATCH 3/5] Update to use new tabbed version of the page --- articles/azure-monitor/app/azure-web-apps.md | 73 ++++++++++---------- 1 file changed, 37 insertions(+), 36 deletions(-) diff --git a/articles/azure-monitor/app/azure-web-apps.md b/articles/azure-monitor/app/azure-web-apps.md index a90c62c550..d27ead369b 100644 --- a/articles/azure-monitor/app/azure-web-apps.md +++ b/articles/azure-monitor/app/azure-web-apps.md @@ -47,42 +47,43 @@ This section contains the release notes for Azure Web Apps based on ANT release To find which version of the extension you're currently using, go to `https://.scm.azurewebsites.net/ApplicationInsights`. -### Release notes - -#### Latest Version (default) - Linux -
- .NET/.NET Core - .NET/.NET Core content here -
-
- Node.js - Released the private preview of the OpenTelemetry agent (insert version)
- Production agent was updated to use (insert version) of the Node.js Application Insights SDK. -
-
- Java - Java content here -
-
- Python - Python content here -
- -#### Latest Version (default) - Windows - -
- .NET/.NET Core - .NET/.NET Core content here -
-
- Node.js - Released the private preview of the OpenTelemetry agent (insert version)
- Production agent was updated to use (insert version) of the Node.js Application Insights SDK. -
-
- Java - Java content here -
+### Latest Version (default) - Linux + +#### [ASP.NET Core](#tab/asp.net) +insert ASAP.NET Core agent version information and link to releases here + +#### [.NET](#tab/.net) +insert .NET agent version information and link to releases here + +#### [Java](#tab/java) +insert Java agent version information and link to releases here + +#### [Node.js](#tab/nodejs) +Released version 3.x.x of the OpenTelemetry based agent. +Released version 2.x.x of the Application Insights agent. +[Node.js SDK releases](https://github.com/microsoft/ApplicationInsights-node.js/releases) + +#### [Python (Preview)](#tab/python) +insert Python agent version information and link to releases here + +### Latest Version (default) - Windows + +#### [ASP.NET Core](#tab/asp.net) +insert ASAP.NET Core agent version information and link to releases here + +#### [.NET](#tab/.net) +insert .NET agent version information and link to releases here + +#### [Java](#tab/java) +insert Java agent version information and link to releases here + +#### [Node.js](#tab/nodejs) +Released version 3.x.x of the OpenTelemetry based agent. +Released version 2.x.x of the Application Insights agent. +[Node.js SDK releases](https://github.com/microsoft/ApplicationInsights-node.js/releases) + +#### [Python (Preview)](#tab/python) +insert Python agent version information and link to releases here ## Frequently asked questions From fe6b677ef67be63e6b853c05f6ba26cc5d4b37a8 Mon Sep 17 00:00:00 2001 From: Jackson Weber <47067795+JacksonWeber@users.noreply.github.com> Date: Tue, 8 Oct 2024 16:10:15 -0700 Subject: [PATCH 4/5] Update azure-web-apps.md --- articles/azure-monitor/app/azure-web-apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/azure-monitor/app/azure-web-apps.md b/articles/azure-monitor/app/azure-web-apps.md index d27ead369b..8875670c8a 100644 --- a/articles/azure-monitor/app/azure-web-apps.md +++ b/articles/azure-monitor/app/azure-web-apps.md @@ -43,7 +43,7 @@ If both autoinstrumentation monitoring and manual SDK-based instrumentation are ## Release notes -This section contains the release notes for Azure Web Apps based on ANT release for runtime instrumentation with Application Insights. +This section contains the release notes for Azure Web Apps based on the latest release for runtime instrumentations with Application Insights. To find which version of the extension you're currently using, go to `https://.scm.azurewebsites.net/ApplicationInsights`. From bc12eec92d6eb9d2cb280cf15fec935dc1a38b7f Mon Sep 17 00:00:00 2001 From: Jackson Weber <47067795+JacksonWeber@users.noreply.github.com> Date: Wed, 4 Dec 2024 13:19:14 -0800 Subject: [PATCH 5/5] Update articles/azure-monitor/app/azure-web-apps.md Co-authored-by: Cijo Thomas --- articles/azure-monitor/app/azure-web-apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/azure-monitor/app/azure-web-apps.md b/articles/azure-monitor/app/azure-web-apps.md index 8875670c8a..93a9590471 100644 --- a/articles/azure-monitor/app/azure-web-apps.md +++ b/articles/azure-monitor/app/azure-web-apps.md @@ -50,7 +50,7 @@ To find which version of the extension you're currently using, go to `https://