Swart.ApplicationInsights.MAUI
1.0.1
dotnet add package Swart.ApplicationInsights.MAUI --version 1.0.1
NuGet\Install-Package Swart.ApplicationInsights.MAUI -Version 1.0.1
<PackageReference Include="Swart.ApplicationInsights.MAUI" Version="1.0.1" />
paket add Swart.ApplicationInsights.MAUI --version 1.0.1
#r "nuget: Swart.ApplicationInsights.MAUI, 1.0.1"
// Install Swart.ApplicationInsights.MAUI as a Cake Addin #addin nuget:?package=Swart.ApplicationInsights.MAUI&version=1.0.1 // Install Swart.ApplicationInsights.MAUI as a Cake Tool #tool nuget:?package=Swart.ApplicationInsights.MAUI&version=1.0.1
Maui Insights
Maui Insights gives you a simple way to add Application Insights telemetry to your .NET Maui app.
To use it, simply call .AddApplicationInsights() with your AI connection string, and optionally call .AddCrashLogging() to also log any uncaught exceptions to Application Insights. See the example below:
using MauiInsights;
public static class MauiProgram
{
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
.AddApplicationInsights("<connection string>")
.AddCrashLogging();
return builder.Build();
}
}
What does it do?
Maui Insights provides the following:
Application Insights sink for ILogger
Similar to default implementations in .NET Web applications.
Automatic page view tracking
Whenever a page is visited, a pageView event is sent to Application Insights
Automatic http dependency tracking
When using HttpClientFactory, any Http calls are automatically tracked as dependency calls. In addition, OpenTelemetry headers are added to the request so calls can be correlated across your applications. This includes libraries like Refit.
When manually constructing HttpClient or HttpMessageHandler instances, the DependencyTrackingHandler class can be used to manually add this functionality.
Crash logging
When using .AddCrashLogging(), any uncaught exceptions are written to the platforms default cache directory. On the next app start, if the device has an internet connection, these crash logs are then sent to Application Insights as exceptions.
Application Insights TelemetryClient in DI Container
An singleton instance of TelemetryClient is registered and available for any manual telemetry
Advanced scenarios
If you want to extend your telemetry, use the .AddApplicationInsights() overload that accepts a MauiInsightsConfiguration. You can either add custom keyvalue pairs which will be added to the additional properties of the telemetry, or you can implement your own instances of ITelemetryInitializer to modify any telemetry that is sent.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-android31.0 is compatible. net6.0-ios was computed. net6.0-ios15.4 is compatible. net6.0-maccatalyst was computed. net6.0-maccatalyst15.4 is compatible. 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 was computed. 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. |
-
net6.0
- Microsoft.ApplicationInsights.AspNetCore (>= 2.20.0)
- Microsoft.Extensions.Http (>= 6.0.0)
- Microsoft.Extensions.Logging (>= 6.0.0)
- Microsoft.Extensions.Logging.ApplicationInsights (>= 2.20.0)
- Microsoft.Maui.Dependencies (>= 6.0.312)
- Microsoft.Maui.Extensions (>= 6.0.312)
-
net6.0-android31.0
- Microsoft.ApplicationInsights.AspNetCore (>= 2.20.0)
- Microsoft.Extensions.Http (>= 6.0.0)
- Microsoft.Extensions.Logging (>= 6.0.0)
- Microsoft.Extensions.Logging.ApplicationInsights (>= 2.20.0)
- Microsoft.Maui.Dependencies (>= 6.0.312)
- Microsoft.Maui.Extensions (>= 6.0.312)
-
net6.0-ios15.4
- Microsoft.ApplicationInsights.AspNetCore (>= 2.20.0)
- Microsoft.Extensions.Http (>= 6.0.0)
- Microsoft.Extensions.Logging (>= 6.0.0)
- Microsoft.Extensions.Logging.ApplicationInsights (>= 2.20.0)
- Microsoft.Maui.Dependencies (>= 6.0.312)
- Microsoft.Maui.Extensions (>= 6.0.312)
- System.Runtime.InteropServices.NFloat.Internal (>= 6.0.1)
-
net6.0-maccatalyst15.4
- Microsoft.ApplicationInsights.AspNetCore (>= 2.20.0)
- Microsoft.Extensions.Http (>= 6.0.0)
- Microsoft.Extensions.Logging (>= 6.0.0)
- Microsoft.Extensions.Logging.ApplicationInsights (>= 2.20.0)
- Microsoft.Maui.Dependencies (>= 6.0.312)
- Microsoft.Maui.Extensions (>= 6.0.312)
- System.Runtime.InteropServices.NFloat.Internal (>= 6.0.1)
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 |
---|---|---|
1.0.1 | 5,849 | 5/24/2022 |
1.0.1-prerelease0 | 122 | 5/14/2022 |
1.0.0-alpha | 111 | 5/3/2022 |
0.0.1-prerelease0 | 110 | 5/14/2022 |