Application Insights for .NET Apps

This is the .NET SDK for sending data to Azure Monitor & Application Insights.

⚠️ Important Guidance

We recommend the Azure Monitor OpenTelemetry Distro for new applications or customers to power Azure Monitor Application Insights. The Azure Monitor OpenTelemetry Distro delivers a similar functionality and experience as the Application Insights SDK. It's possible to migrate from the Application Insights SDK using the migration guide for .NET, but we are still working to add a few more features for backwards compatibility.

Getting Started

Please review our How-to guides to review which packages are appropriate for your project:

• Console App
• ASP.NET
• ASP.NET Core
• ILogger
• WorkerService

Understanding our SDK

We've gathered a list of concepts, code examples, and links to full guides here.

Contributing

We strongly welcome and encourage contributions to this project. Please review our Contributing guide.

Branches

• main is the default branch for all development and releases.

Releases

• Refer to our Milestones for progress on our next releases.
• Releases
• Tags all releases have a matching tag.

NuGet packages

The following packages are published from this repository:

	Nightly Build	Latest Official Release	Latest Official Release (including pre-release)
Base SDKs
- Microsoft.ApplicationInsights
- Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel
Auto Collectors (Generic)
- Microsoft.ApplicationInsights.DependencyCollector
- Microsoft.ApplicationInsights.EventCounterCollector
- Microsoft.ApplicationInsights.PerfCounterCollector
- Microsoft.ApplicationInsights.WindowsServer
Auto Collectors (ASP.NET)
- Microsoft.ApplicationInsights.Web
Auto Collectors (ASP.NET Core)
- Microsoft.ApplicationInsights.AspNetCore
Auto Collectors (WorkerService, Console Application, etc.)
- Microsoft.ApplicationInsights.WorkerService
Logging Adapters
- For ILogger: Microsoft.Extensions.Logging.ApplicationInsights
- For NLog: Microsoft.ApplicationInsights.NLogTarget
- For Log4Net: Microsoft.ApplicationInsights.Log4NetAppender
- For System.Diagnostics: Microsoft.ApplicationInsights.TraceListener
- Microsoft.ApplicationInsights.DiagnosticSourceListener
- Microsoft.ApplicationInsights.EtwCollector
- Microsoft.ApplicationInsights.EventSourceListener

Customers are encouraged to use the latest stable version as that is the version that will get fixes and updates. Beta packages are not recommended for use in production & support is limited. Upon release of the new stable version, the old Beta packages will be unlisted & the old minor version will be marked as deprecated. Application Insights follows the Azure SDK Lifecycle & support policy. (For example: When 2.20.0 is released, 2.20.0-beta1 will be unlisted and 2.19.0 will be deprecated.)

Nightly

Nightly Builds are available on our MyGet feed: https://www.myget.org/F/applicationinsights-dotnet-nightly/api/v3/index.json

These builds come from the main branch. These are not signed and are not intended for production workloads.

Support

A guide on common troubleshooting topics is available here.

For immediate support relating to the Application Insights .NET SDK we encourage you to file an Azure Support Request with Microsoft Azure instead of filing a GitHub Issue in this repository. You can do so by going online to the Azure portal and submitting a support request. Access to subscription management and billing support is included with your Microsoft Azure subscription, and technical support is provided through one of the Azure Support Plans. For step-by-step guidance for the Azure portal, see How to create an Azure support request. Alternatively, you can create and manage your support tickets programmatically using the Azure Support ticket REST API.