https://github.com/microsoft/ApplicationInsights-dotnet
ApplicationInsights-dotnet
https://github.com/microsoft/ApplicationInsights-dotnet
application-insights azure distributed-tracing logging monitoring observability sdk telemetry
Last synced: 21 days ago
JSON representation
ApplicationInsights-dotnet
- Host: GitHub
- URL: https://github.com/microsoft/ApplicationInsights-dotnet
- Owner: microsoft
- License: mit
- Created: 2015-06-11T20:34:21.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2025-03-18T20:11:57.000Z (about 1 month ago)
- Last Synced: 2025-04-06T19:01:34.015Z (26 days ago)
- Topics: application-insights, azure, distributed-tracing, logging, monitoring, observability, sdk, telemetry
- Language: C#
- Homepage:
- Size: 20.8 MB
- Stars: 572
- Watchers: 118
- Forks: 295
- Open Issues: 150
-
Metadata Files:
- Readme: Readme.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Application Insights for .NET Apps
[](https://github.com/microsoft/ApplicationInsights-dotnet/actions/workflows/build-and-test-BASE.yml)
[](https://github.com/microsoft/ApplicationInsights-dotnet/actions/workflows/build-and-test-WEB.yml)
[](https://github.com/microsoft/ApplicationInsights-dotnet/actions/workflows/build-and-test-NETCORE.yml)
[](https://github.com/microsoft/ApplicationInsights-dotnet/actions/workflows/build-and-test-LOGGING.yml)
[](https://github.com/microsoft/ApplicationInsights-dotnet/actions/workflows/redfield-sanity-check.yml)
[](https://github.com/microsoft/ApplicationInsights-dotnet/actions/workflows/sanity.yml)
[](https://github.com/microsoft/ApplicationInsights-dotnet/actions/workflows/nightly.yml)This is the .NET SDK for sending data to [Azure Monitor](https://docs.microsoft.com/azure/azure-monitor/overview) & [Application Insights](https://docs.microsoft.com/azure/azure-monitor/app/app-insights-overview).
## Getting Started
Please review our How-to guides to review which packages are appropriate for your project:
* [Console App](https://docs.microsoft.com/azure/azure-monitor/app/console)
* [ASP.NET](https://docs.microsoft.com/azure/azure-monitor/app/asp-net)
* [ASP.NET Core](https://docs.microsoft.com/azure/azure-monitor/app/asp-net-core)
* [ILogger](https://docs.microsoft.com/azure/azure-monitor/app/ilogger)
* [WorkerService](https://docs.microsoft.com/azure/azure-monitor/app/worker-service)### Understanding our SDK
We've gathered a list of concepts, code examples, and links to full guides [here](docs/concepts.md).
## Contributing
We strongly welcome and encourage contributions to this project.
Please review our [Contributing guide](.github/CONTRIBUTING.md).## Branches
- [main](https://github.com/Microsoft/ApplicationInsights-dotnet/tree/master) is the default branch for all development and releases.
## Releases
- Refer to our [Milestones](https://github.com/microsoft/ApplicationInsights-dotnet/milestones) for progress on our next releases.
- [Releases](https://github.com/microsoft/ApplicationInsights-dotnet/releases)
- [Tags](https://github.com/microsoft/ApplicationInsights-dotnet/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](https://www.nuget.org/packages/Microsoft.ApplicationInsights/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights/) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights/) |
| - [Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel](https://www.nuget.org/packages/Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel/) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel/) |
| **Auto Collectors (Generic)** | | | |
| - [Microsoft.ApplicationInsights.DependencyCollector](https://www.nuget.org/packages/Microsoft.ApplicationInsights.DependencyCollector/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.DependencyCollector) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.DependencyCollector) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.DependencyCollector) |
| - [Microsoft.ApplicationInsights.EventCounterCollector](https://www.nuget.org/packages/Microsoft.ApplicationInsights.EventCounterCollector) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.EventCounterCollector) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.EventCounterCollector) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.EventCounterCollector) |
| - [Microsoft.ApplicationInsights.PerfCounterCollector](https://www.nuget.org/packages/Microsoft.ApplicationInsights.PerfCounterCollector/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.PerfCounterCollector) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.PerfCounterCollector) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.PerfCounterCollector) |
| - [Microsoft.ApplicationInsights.WindowsServer](https://www.nuget.org/packages/Microsoft.ApplicationInsights.WindowsServer/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.WindowsServer) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.WindowsServer) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.WindowsServer) |
| **Auto Collectors (ASP.NET)** | | | |
| - [Microsoft.ApplicationInsights.Web](https://www.nuget.org/packages/Microsoft.ApplicationInsights.Web/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.Web) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.Web) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.Web) |
| **Auto Collectors (ASP.NET Core)** | | | |
| - [Microsoft.ApplicationInsights.AspNetCore](https://www.nuget.org/packages/Microsoft.ApplicationInsights.AspNetCore/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.AspNetCore) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.AspNetCore) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.AspNetCore) |
| **Auto Collectors (WorkerService, Console Application, etc.)** | | | |
| - [Microsoft.ApplicationInsights.WorkerService](https://www.nuget.org/packages/Microsoft.ApplicationInsights.WorkerService/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.WorkerService) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.WorkerService) | [](https://nuget.org/packages/Microsoft.ApplicationInsights.WorkerService) |
| **Logging Adapters** | | | |
| - For `ILogger`: [Microsoft.Extensions.Logging.ApplicationInsights](https://www.nuget.org/packages/Microsoft.Extensions.Logging.ApplicationInsights/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.Extensions.Logging.ApplicationInsights) | [](https://www.nuget.org/packages/Microsoft.Extensions.Logging.ApplicationInsights/) | [](https://www.nuget.org/packages/Microsoft.Extensions.Logging.ApplicationInsights/) |
| - For `NLog`: [Microsoft.ApplicationInsights.NLogTarget](http://www.nuget.org/packages/Microsoft.ApplicationInsights.NLogTarget/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.NLogTarget) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.NLogTarget/) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.NLogTarget/) |
| - For `Log4Net`: [Microsoft.ApplicationInsights.Log4NetAppender](http://www.nuget.org/packages/Microsoft.ApplicationInsights.Log4NetAppender/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.Log4NetAppender) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.Log4NetAppender/) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.Log4NetAppender/) |
| - For `System.Diagnostics`: [Microsoft.ApplicationInsights.TraceListener](http://www.nuget.org/packages/Microsoft.ApplicationInsights.TraceListener/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.TraceListener) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.TraceListener/) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.TraceListener/) |
| - [Microsoft.ApplicationInsights.DiagnosticSourceListener](http://www.nuget.org/packages/Microsoft.ApplicationInsights.DiagnosticSourceListener/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.DiagnosticSourceListener) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.DiagnosticSourceListener/) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.DiagnosticSourceListener/) |
| - [Microsoft.ApplicationInsights.EtwCollector](http://www.nuget.org/packages/Microsoft.ApplicationInsights.EtwCollector/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.EtwCollector) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.EtwCollector/) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.EtwCollector/) |
| - [Microsoft.ApplicationInsights.EventSourceListener](http://www.nuget.org/packages/Microsoft.ApplicationInsights.EventSourceListener/) | [](https://www.myget.org/feed/applicationinsights-dotnet-nightly/package/nuget/Microsoft.ApplicationInsights.EventSourceListener) | [](https://www.nuget.org/packages/Microsoft.ApplicationInsights.EventSourceListener/) | [](https://www.nuget.org/packages/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](https://azure.github.io/azure-sdk/policies_support.html).
(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](troubleshooting).
For immediate support relating to the Application Insights .NET SDK we encourage you to file an [Azure Support Request](https://docs.microsoft.com/azure/azure-portal/supportability/how-to-create-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](https://portal.azure.com/) 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](https://azure.microsoft.com/support/plans/). For step-by-step guidance for the Azure portal, see [How to create an Azure support request](https://docs.microsoft.com/azure/azure-portal/supportability/how-to-create-azure-support-request). Alternatively, you can create and manage your support tickets programmatically using the [Azure Support ticket REST API](https://docs.microsoft.com/rest/api/support/).