Mobile applications: Issues with Dynatrace .NET MAUI NuGet package

maliborskaya — Mon, 09 Feb 2026 15:09:37 GMT

Summary

Having issues connecting your .NET MAUI mobile app to Dynatrace? This guide covers typical configuration errors, verification steps, startup instrumentation requirements, and platform‑specific fixes for the Dynatrace .NET MAUI NuGet package.

Failed build

If your build fails, make sure you've added the dynatrace.config.json file to the Assets (Android) or Resources (iOS) directory and that the file includes at least the beacon URL and the application ID properties. For details, see Configuration file.

If you use the manual startup, don't include the beacon URL and the application ID properties in the configuration file. If you do that, you'll encounter an exception.

Turn off Visual Studio Debugger for Android

If you notice that Dynatrace doesn't report crashes for Android applications to your environment, make sure that you're not using the debug option in Visual Studio.

Right-click your Android project, and select Properties.
Go to Android Options, and clear Enable developer instrumentation (debugging and profiling).
Disable developer instrumentation

Keep in mind that clearing Enable developer instrumentation disables debugging. Use this option only to verify that crashes are sent. Optionally, you can create a release build that is detached from Visual Studio.

What's Next

If you can't resolve a problem with the Dynatrace .NET MAUI NuGet package for your mobile applications, please contact a Dynatrace product expert via live chat within your Dynatrace environment. Have the following details available:

OneAgent debug logs
Your dynatrace.config.json file

📖 Instrument mobile apps with Dynatrace .NET MAUI NuGet package

📖 The start method for OneAgent is not valid in MAUI

article Mobile applications: Issues with Dynatrace .NET MAUI NuGet package in Troubleshooting

Mobile applications: Issues with Dynatrace .NET MAUI NuGet package

Summary

Failed build

Turn off Visual Studio Debugger for Android

What's Next

Related articles