feat(logs): initial API for Sentry Logs

[Flash0ver]

Info

• Developer Documentation
• See also: Sentry Structured Logging for .NET #4132

TODO

• Complete public API surface area
• XML API docs
• Add Tests

Follow-ups

• Add non object[] but generic <TArg> overloads per Log-Severity method for the most common scenarios
  • to avoid both boxing allocations and array allocations in case options.EnableLogs is false
  • our public IDiagnosticLogger.Log{Level}() extension methods have overloads with up to 3 generic type parameters
  • .NET's String.Format has 1-3 object arguments
    • and 1-3 generic arguments since net8.0 when used with CompositeFormat
• Consider a custom [InterpolatedStringHandler] to support interpolated strings and ensure zero-alloc if options.EnableLogs is false
  • available for TFMs compatible with net6.0
• Batching, via log Envelope Item Payload
  • see https://develop.sentry.dev/sdk/telemetry/logs/#log-envelope-item
• Integrate into Sentry.Extensions.Logging
  • and Sentry.AspNetCore transitively
  • and Sentry.Maui transitively
• Experimental docs

Early feedback appreciated on
- public APIs

see also Question-Comments in the draft

[bruno-garcia]

Exciting first step in our logging story :)

[jamescrosswell]

@Flash0ver can we reference some developer docs and/or an issue in the PR description to help reviewers get an overview of the change before looking at code?

[jamescrosswell]

Looking good so far 👍🏻