1. Navigate to Digital Experience > Add an Application.
2. Select .NET MAUI as the application type and enter an application name to generate a unique Datadog application ID and client token.
3. To disable automatic user data collection for either client IP or geolocation data, uncheck the boxes for those settings. For more information, see RUM .NET MAUI Data Collected.

To ensure the safety of your data, you must use a client token. If you use only Datadog API keys to configure the Datadog SDK, they are exposed client-side in the .NET MAUI application's compiled assemblies.

For more information about setting up a client token, see the Client Token documentation.

The SDK exposes two initialization patterns. Choose the pattern that matches your app's hosting style. See TrackingConsent to add GDPR compliance for your EU users, and other configuration options to initialize the library.

Pattern 1: Builder extensions (recommended)

Chain the UseDatadog* extensions onto your MauiAppBuilder in MauiProgram.CreateMauiApp:

using Datadog.Maui;
using Datadog.Maui.Configuration;
using Datadog.Maui.Hosting;

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .UseDatadog(new DdSdkConfiguration
        {
            ClientToken = "<CLIENT_TOKEN>",
            Environment = "<ENV_NAME>",
            TrackingConsent = TrackingConsent.Granted,
            Service = "<SERVICE_NAME>",34d12712-b3b0-404a-9448-486d995323ee
            NativeCrashReportEnabled = true,
            FirstPartyHosts = new List<FirstPartyHost>
            {
                new() { Match = "api.example.com", HeaderTypes = new List<TracingHeaderType> { TracingHeaderType.Datadog, TracingHeaderType.TraceContext } }
            },
        })
        .UseDatadogLogs()
        .UseDatadogTrace()
        .UseDatadogRum(new DdRumConfiguration
        {
            ApplicationId = "<APPLICATION_ID>",
            SessionSampleRate = 100.0,
        });

    return builder.Build();
}

Pattern 2: Standalone calls

For apps that already have a custom host pipeline, or that want to enable features lazily, call the static APIs directly. Call DdRum.Enable from a page constructor (or any time after Application.Current is set) so its automatic page and action trackers can subscribe to MAUI's Application events.

using Datadog.Maui;
using Datadog.Maui.Configuration;

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder.UseMauiApp<App>();

    DdSdk.Initialize(new DdSdkConfiguration
    {
        ClientToken = "<CLIENT_TOKEN>",
        Environment = "<ENV_NAME>",
        TrackingConsent = TrackingConsent.Granted,
        // ...
    });

    return builder.Build();
}

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();

        DdLogs.Enable();
        DdTrace.Enable();
        DdRum.Enable(new DdRumConfiguration { ApplicationId = "<APPLICATION_ID>" });
    }
}

File-based configuration

You can also load the SDK configuration from a JSON file at runtime:

{
  "ClientToken": "<CLIENT_TOKEN>",
  "Environment": "<ENV_NAME>",
  "Site": "Us1",
  "Service": "<SERVICE_NAME>",
  "TrackingConsent": "Granted",
  "FirstPartyHosts": [
    { "Match": "api.example.com", "HeaderTypes": ["Datadog", "TraceContext"] }
  ]
}

string json = File.ReadAllText("appsettings.json");
var config = FileBasedConfiguration.ParseJsonConfig(json);
DdSdk.Initialize(config);

To control the data your application sends to Datadog RUM, you can specify a sample rate for RUM sessions during initialization. The rate is a percentage between 0 and 100. By default, SessionSampleRate is set to 100.0 (keep all sessions).

.UseDatadogRum(new DdRumConfiguration
{
    ApplicationId = "<APPLICATION_ID>",
    // Send 75% of RUM sessions to Datadog
    SessionSampleRate = 75.0,
})

By default, the SDK automatically tracks views, actions, and resources:

• Views: MAUI page navigations via Application.PageAppearing (one app-level event covering Shell route changes, Navigation.PushAsync, and modals).
• Actions: User interactions with buttons, switches, checkboxes, pickers, and gesture recognizers.
• Resources: HTTP requests via DiagnosticListener (all HttpClient requests, including third-party libraries).

To customize or disable automatic tracking, see Advanced Configuration.

When RUM is enabled, C# error tracking is automatically started. Unhandled exceptions (AppDomain.UnhandledException) and unobserved task exceptions (TaskScheduler.UnobservedTaskException) are captured and reported as RUM errors. You can also manually report errors with DdRum.AddError.

Set tracking consent (GDPR compliance)

To be compliant with GDPR, the SDK requires the tracking consent value at initialization. Tracking consent can be one of the following values:

• TrackingConsent.Pending: The SDK starts collecting and batching the data, but does not send it to the collection endpoint. The SDK waits for the new tracking consent value to decide what to do with the batched data.
• TrackingConsent.Granted: The SDK starts collecting the data and sends it to the data collection endpoint.
• TrackingConsent.NotGranted: The SDK does not collect any data. You are not able to manually send any logs, traces, or RUM events.

To update the tracking consent after the SDK is initialized, call DdSdk.SetTrackingConsent(<NEW_CONSENT>). The SDK changes its behavior according to the new consent. For example, if the current tracking consent is TrackingConsent.Pending and you update it to:

• TrackingConsent.Granted: The SDK sends all current batched data and future data directly to the data collection endpoint.
• TrackingConsent.NotGranted: The SDK wipes all batched data and does not collect any future data.

// For example, after the user accepts a consent dialog:
DdSdk.SetTrackingConsent(TrackingConsent.Granted);