Alyio.Extensions.Http.Logging is a .NET library that provides deep visibility into the HTTP and HTTPS traffic in applications. It extends HttpClientHandler to provide detailed, raw logging of HTTP requests and responses.
Why Alyio.Extensions.Http.Logging?
In complex systems, understanding the exact data being sent and received over HTTP is crucial for debugging, auditing, and ensuring security. While tools like OpenTelemetry provide excellent high-level telemetry, they often don't capture the full raw payload of HTTP messages.
This library provides the ground-truth of HTTP communication, which is useful for:
Precision Debugging: The exact headers and bodies of requests and responses can be inspected to quickly identify issues.
Auditing and Compliance: A detailed log of all HTTP interactions can be maintained for security and compliance purposes.
Enhancing Existing Telemetry: Existing telemetry solutions can be complemented with low-level details for drilling down into specific requests.
Key Features
Detailed HTTP Logging: Capture and log the full, raw content of HTTP request and response messages, including headers and bodies.
Highly Configurable: Fine-tune logging with options to ignore specific headers or content, and control log levels.
Sensitive Data Redaction: Automatically redact sensitive information from headers (like Authorization tokens) to keep logs secure.
Targeted Logging: Apply logging to all HttpClient instances in an application or target specific named clients for granular control.
Broad .NET Support: Compatible with .NET 6.0, 8.0, 9.0 and 10.0.
Installation
Install the package from NuGet:
dotnet add package Alyio.Extensions.Http.Logging
Usage
To use the HTTP message logging functionality, use the IHttpClientBuilder.AddHttpRawMessageLogging extension method to add the HttpRawMessageLoggingHandler to the HttpClient.
Configure Logging for All HTTP Clients
Logging can be configured for all HTTP clients in an application using ConfigureHttpClientDefaults:
