AzureFunctions.Better.ApplicationInsights
3.1.0
dotnet add package AzureFunctions.Better.ApplicationInsights --version 3.1.0
NuGet\Install-Package AzureFunctions.Better.ApplicationInsights -Version 3.1.0
<PackageReference Include="AzureFunctions.Better.ApplicationInsights" Version="3.1.0" />
paket add AzureFunctions.Better.ApplicationInsights --version 3.1.0
#r "nuget: AzureFunctions.Better.ApplicationInsights, 3.1.0"
// Install AzureFunctions.Better.ApplicationInsights as a Cake Addin #addin nuget:?package=AzureFunctions.Better.ApplicationInsights&version=3.1.0 // Install AzureFunctions.Better.ApplicationInsights as a Cake Tool #tool nuget:?package=AzureFunctions.Better.ApplicationInsights&version=3.1.0
Better Azure Functions Application Insights integration
🚨 The customisation supports in-process Functions only. Isolated Functions are not supported.
Beginning 10 November 2026, the in-process model for .NET apps in Azure Functions will no longer be supported. Migrate to the isolated worked model.
Automatically discards redundant telemetry items such as Functions execution traces and duplicate exceptions. Allows you to register your own telemetry processor(s) that will be invoked on every telemetry item type.
More detailed documentation is available on GitHub.
Usage
In your Startup
class
add the below snippet:
var appInsightsOptions = new CustomApplicationInsightsOptionsBuilder(
"{ApplicationName}",
{TypeFromEntryAssembly})
.Build();
builder.Services
.AddCustomApplicationInsights(appInsightsOptions);
Where
{ApplicationName}
used to set Application Insights' Cloud role name (optional). When not provided, the default behaviour is preserved (the Cloud role name will be set to the Function App's name){TypeFromEntryAssembly}
typically would betypeof(Startup)
. When{ApplicationName}
is provided, I read the Assembly Informational Version of the entry assembly to set Application Insights' Application version (I use unknown as a fallback). When{ApplicationName}
is not provided, Application version will not be present on the telemetry items
Additionally you can discard health requests and Service Bus trigger traces using application settings:
{
"Values": {
"AzureWebJobsStorage": "UseDevelopmentStorage=true",
"FUNCTIONS_WORKER_RUNTIME": "dotnet",
"ApplicationInsights:DiscardServiceBusTrigger": true,
"ApplicationInsights:HealthCheckFunctionName": "HealthFunction" // The name of the Function, not the route
}
}
You can also add telemetry initializers and telemetry processors:
public override void Configure(IFunctionsHostBuilder builder)
{
var appInsightsOptions = new CustomApplicationInsightsOptionsBuilder(
"customv4inprocess", // Will be used as Cloud role name
typeof(Startup)) // Assembly Informational Version will be used as Application version
.Build();
builder.Services
// Telemetry processors are supported on all telemetry item types
.AddApplicationInsightsTelemetryProcessor<CustomHttpDependencyFilter>()
.AddSingleton<ITelemetryInitializer, TelemetryCounterInitializer>()
/*
* When adding an instance of a telemetry initializer, you need to provide the service Type otherwise
* your initializer will not be used.
*
* <code>
* // Do not use:
* .AddSingleton(new TelemetryCounterInstanceInitializer("NiceValue"))
* </code>
*/
.AddSingleton<ITelemetryInitializer>(new TelemetryCounterInstanceInitializer("NiceValue"))
.AddCustomApplicationInsights(appInsightsOptions);
}
Limitations
Setting the cloud role name breaks the Function's Monitor blade.
Migration guides
Release notes
Release notes can be found on GitHub.
Feedback
Leave feedback by opening an issue on GitHub.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.Azure.WebJobs.Logging.ApplicationInsights (>= 3.0.41)
- Microsoft.Extensions.Logging.Console (>= 3.1.32)
-
net6.0
- Microsoft.Azure.WebJobs.Logging.ApplicationInsights (>= 3.0.41)
- Microsoft.Extensions.Logging.Console (>= 6.0.0)
-
net8.0
- Microsoft.Azure.WebJobs.Logging.ApplicationInsights (>= 3.0.41)
- Microsoft.Extensions.Logging.Console (>= 8.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
3.1.0 | 35 | 11/23/2024 |
3.0.0 | 1,026 | 5/26/2024 |
2.0.2 | 372 | 3/31/2024 |
2.0.1 | 8,956 | 8/25/2023 |
2.0.1-alpha.0.10 | 80 | 8/22/2023 |
2.0.1-alpha.0.9 | 102 | 8/19/2023 |
2.0.0 | 1,228 | 7/26/2023 |
2.0.0-preview.0.5 | 106 | 7/17/2023 |
2.0.0-preview.0.4 | 95 | 7/16/2023 |
1.0.1 | 4,134 | 3/3/2023 |
1.0.0 | 247 | 2/26/2023 |
0.1.1 | 7,471 | 8/8/2022 |
0.1.0 | 544 | 7/29/2022 |