HTTP: wystąpienia httpclient utworzone przez kody stanu liczby całkowitej dziennika IHttpClientFactory
HttpClient wystąpienia utworzone przez IHttpClientFactory kody stanu HTTP dziennika jako liczby całkowite zamiast z nazwami kodów stanu.
Wprowadzona wersja
5.0 (wersja zapoznawcza 1)
Stare zachowanie
Rejestrowanie używa tekstowych opisów kodów stanu HTTP. Rozważ następujące komunikaty dziennika:
Received HTTP response after 56.0044ms - OK
End processing HTTP request after 70.0862ms - OK
Nowe zachowanie
Rejestrowanie używa wartości całkowitych kodów stanu HTTP. Rozważ następujące komunikaty dziennika:
Received HTTP response after 56.0044ms - 200
End processing HTTP request after 70.0862ms - 200
Przyczyna wprowadzenia zmiany
Oryginalne zachowanie tego rejestrowania jest niezgodne z innymi częściami ASP.NET Core, które zawsze używały wartości całkowitych. Niespójność sprawia, że dzienniki są trudne do wykonywania zapytań za pośrednictwem systemów rejestrowania strukturalnego, takich jak Elasticsearch. Aby uzyskać więcej informacji na temat kontekstu, zobacz dotnet/extensions#1549.
Użycie wartości całkowitych jest bardziej elastyczne niż tekst, ponieważ umożliwia wykonywanie zapytań dotyczących zakresów wartości.
Rozważono dodanie innej wartości dziennika w celu przechwycenia kodu stanu liczby całkowitej. Niestety, w ten sposób wprowadzonoby kolejną niespójność z resztą ASP.NET Core. Rejestrowanie httpClient i rejestrowanie serwera HTTP/hostingu używają już tej samej StatusCode
nazwy klucza.
Zalecana akcja
Najlepszą opcją jest zaktualizowanie zapytań rejestrowania w celu użycia wartości całkowitych kodów stanu. Ta opcja może spowodować trudności z pisaniem zapytań w wielu wersjach ASP.NET Core. Jednak użycie liczb całkowitych w tym celu jest znacznie bardziej elastyczne w przypadku wykonywania zapytań dotyczących dzienników.
Jeśli musisz wymusić zgodność ze starym zachowaniem i użyć kodów stanu tekstowego, zastąp IHttpClientFactory
rejestrowanie własnym:
Skopiuj do projektu wersje platformy .NET Core 3.1 z następujących klas:
Zmień nazwy klas, aby uniknąć konfliktów z typami publicznymi w pakiecie NuGet Microsoft.Extensions.Http .
Zastąp wbudowaną implementację
LoggingHttpMessageHandlerBuilderFilter
własnymi metodami projektuStartup.ConfigureServices
. Na przykład:public void ConfigureServices(IServiceCollection services) { // Other service registrations go first. Code omitted for brevity. // Place the following after all AddHttpClient registrations. services.RemoveAll<IHttpMessageHandlerBuilderFilter>(); services.AddSingleton<IHttpMessageHandlerBuilderFilter, MyLoggingHttpMessageHandlerBuilderFilter>(); }