Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Reorganize Release Notes per Language #12

Draft
wants to merge 5 commits into
base: main
Choose a base branch
from
Draft

Reorganize Release Notes per Language #12

Changes from 4 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fa07b6d
Proposed organization of the release notes for the app service docs
JacksonWeber Sep 28, 2024
0553b62
Update per Yutang suggestions
JacksonWeber Sep 30, 2024
4414222
Update to use new tabbed version of the page
JacksonWeber Oct 8, 2024
fe6b677
Update azure-web-apps.md
JacksonWeber Oct 8, 2024
bc12eec
Update articles/azure-monitor/app/azure-web-apps.md
JacksonWeber Dec 4, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
109 changes: 27 additions & 82 deletions articles/azure-monitor/app/azure-web-apps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,102 +43,47 @@ 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 the latest release for runtime instrumentations with Application Insights.

To find which version of the extension you're currently using, go to `https://<yoursitename>.scm.azurewebsites.net/ApplicationInsights`.

### Release notes
### Latest Version (default) - Linux

#### 2.8.44
#### [ASP.NET Core](#tab/asp.net)
insert ASAP.NET Core agent version information and link to releases here
JacksonWeber marked this conversation as resolved.
Show resolved Hide resolved

- .NET/.NET Core: Upgraded to [ApplicationInsights .NET SDK to 2.20.1](https://github.com/microsoft/ApplicationInsights-dotnet/tree/autoinstrumentation/2.20.1).
#### [.NET](#tab/.net)
insert .NET agent version information and link to releases here

#### 2.8.43
#### [Java](#tab/java)
insert Java agent version information and link to releases here

- Separate .NET/.NET Core, Java and Node.js package into different App Service Windows Site Extension.
#### [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)

#### 2.8.42
#### [Python (Preview)](#tab/python)
insert Python agent version information and link to releases here

- 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).
### Latest Version (default) - Windows

#### 2.8.41
#### [ASP.NET Core](#tab/asp.net)
insert ASAP.NET Core agent version information and link to releases here

- 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.
#### [.NET](#tab/.net)
insert .NET agent version information and link to releases here

#### 2.8.40
#### [Java](#tab/java)
insert Java agent version information and link to releases here

- 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.
#### [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)

#### 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\<AiHostingStartup\>.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.
#### [Python (Preview)](#tab/python)
insert Python agent version information and link to releases here

## Frequently asked questions

Expand Down