Diagnostica in Kestrel

Di Sourabh Shirhatti

Questo articolo fornisce indicazioni per raccogliere la diagnostica da Kestrel per risolvere i problemi. Gli argomenti trattati includono:

• Registrazione: log strutturati scritti nella registrazione di .NET Core. ILogger viene usato dai framework dell'app per scrivere i log e dagli utenti per la propria registrazione in un'app.
• Metriche: rappresentazione delle misure dei dati in intervalli di tempo, ad esempio richieste al secondo. Le metriche vengono generate usando EventCounter e possono essere osservate usando lo strumento da riga di comando dotnet-counters o con Application Insights.
• DiagnosticSource: DiagnosticSource è un meccanismo per la registrazione in fase di produzione con payload di dati avanzati per l'utilizzo all'interno del processo. A differenza della registrazione, che presuppone che i dati lascino il processo e si aspettano dati serializzabili, DiagnosticSource funzionano bene con dati complessi.

Registrazione

Analogamente alla maggior parte dei componenti in ASP.NET Core, Kestrel usa Microsoft.Extensions.Logging per generare informazioni di log. Kestrel utilizza l'uso di più categorie che consente di essere selettivi in base ai log a cui si è in ascolto.

Registrazione delle connessioni

Kestrel supporta anche la possibilità di generare Debug log di livello per la comunicazione a livello di byte e può essere abilitato per ogni endpoint. Per abilitare la registrazione delle connessioni, vedere Configurare gli endpoint per Kestrel

Metrica

Le metriche sono una rappresentazione delle misure dei dati in intervalli di tempo, ad esempio le richieste al secondo. I dati delle metriche consentono di osservare lo stato di un'app a livello generale. Kestrel le metriche vengono generate usando EventCounter.

DiagnosticSource

Kestrel genera un DiagnosticSource evento per le richieste HTTP rifiutate a livello di server, ad esempio le richieste non valide e le violazioni dei protocolli. Di conseguenza, queste richieste non lo effettuano mai nel livello di hosting di ASP.NET Core.

Kestrel genera questi eventi con il nome dell'evento Microsoft.AspNetCore.Server.Kestrel.BadRequest e un IFeatureCollection oggetto come payload dell'oggetto. L'eccezione sottostante può essere recuperata accedendo a IBadRequestExceptionFeature nella raccolta di funzionalità.

La risoluzione di questi eventi è un processo in due passaggi. È necessario creare un osservatore per DiagnosticListener :

class BadRequestEventListener : IObserver<KeyValuePair<string, object>>, IDisposable
{
    private readonly IDisposable _subscription;
    private readonly Action<IBadRequestExceptionFeature> _callback;

    public BadRequestEventListener(DiagnosticListener diagnosticListener, Action<IBadRequestExceptionFeature> callback)
    {
        _subscription = diagnosticListener.Subscribe(this!, IsEnabled);
        _callback = callback;
    }
    private static readonly Predicate<string> IsEnabled = (provider) => provider switch
    {
        "Microsoft.AspNetCore.Server.Kestrel.BadRequest" => true,
        _ => false
    };
    public void OnNext(KeyValuePair<string, object> pair)
    {
        if (pair.Value is IFeatureCollection featureCollection)
        {
            var badRequestFeature = featureCollection.Get<IBadRequestExceptionFeature>();

            if (badRequestFeature is not null)
            {
                _callback(badRequestFeature);
            }
        }
    }
    public void OnError(Exception error) { }
    public void OnCompleted() { }
    public virtual void Dispose() => _subscription.Dispose();
}

Sottoscrivere ASP.NET Core DiagnosticListener con l'osservatore. In questo esempio viene creato un callback che registra l'eccezione sottostante.

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
var diagnosticSource = app.Services.GetRequiredService<DiagnosticListener>();
using var badRequestListener = new BadRequestEventListener(diagnosticSource, (badRequestExceptionFeature) =>
{
    app.Logger.LogError(badRequestExceptionFeature.Error, "Bad request received");
});
app.MapGet("/", () => "Hello world");
app.Run();

Comportamento con debugger collegato

Alcuni timeout e limiti di frequenza non vengono applicati quando un debugger è collegato a un Kestrel processo. Per altre informazioni, vedere Comportamento con debugger collegato.