🚀 Structured Logs – Feedback wanted!

[Flash0ver]

Hi everyone,

We introduced experimental support for Structured Logs (currently in Beta) with the version 5.14.0 of the Sentry SDK for .NET.

This includes both SentryStructuredLogger APIs, accessible via SentrySdk,
as well as an integration for Microsoft.Extensions.Logging through the ILogger<TCategoryName> interface.

🚦 Prerequisites

You can enable Structured Logs, both the SentrySdk.Experimental.Logger APIs and the ILogger<TCategoryName> integration, through the options:

options =>
{
    options.Experimental.EnableLogs = true;
}

You can filter and/or configure logs via the callback:

options =>
{
    options.Experimental.SetBeforeSendLog(static log =>
    {
        if (log.Level is SentryLogLevel.Info)
        {
            return null;
        }

        log.SetAttribute("my.attribute", "value");
        return log;
    });
}

Please find more details in the documentation.
Keep in mind that the related APIs are still marked [Experimental].

📖 Documentation

• Logs in Sentry
• Set Up Logs for .NET
  • Set Up Logs for ASP.NET Core
  • Set Up Logs for .NET MAUI
  • Set Up Logs for Microsoft.Extensions.Logging

🔍 Feedback

We value all your feedback about scenarios that work well for you, and improvements for upcoming versions.

Feedback may include, but is definitely not limited to:
✅ Ease of use – Is the API intuitive?
✅ Configurability – Do you need more flexibility in capturing and sending logs?
✅ Performance impact – Have you noticed any overhead when enabling Structured Logs?
✅ Compatibility – Have you encountered issues on specific runtimes or configurations?

Related Issues

• Exceptions for Structured Logs #4440

🧐 Let Us Know Your Thoughts!

We want to ensure this feature works smoothly across different scenarios before stabilizing the API and behavior, so your input is extremely valuable! 🙌

Thanks for helping us improve the Sentry SDK for .NET! 🚀🐞

[Mike-E-angelo]

Hey there, looking into this now, and all your documentation links listed above currently result in 404's, FWIW. Thank you again for all your efforts out there. 👍