RA.Utilities.Logging.Shared 10.0.0-rc.2

Prefix Reserved

This is a prerelease version of RA.Utilities.Logging.Shared.

dotnet add package RA.Utilities.Logging.Shared --version 10.0.0-rc.2

NuGet\Install-Package RA.Utilities.Logging.Shared -Version 10.0.0-rc.2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="RA.Utilities.Logging.Shared" Version="10.0.0-rc.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="RA.Utilities.Logging.Shared" Version="10.0.0-rc.2" />
                    

                            Directory.Packages.props

<PackageReference Include="RA.Utilities.Logging.Shared" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add RA.Utilities.Logging.Shared --version 10.0.0-rc.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: RA.Utilities.Logging.Shared, 10.0.0-rc.2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package RA.Utilities.Logging.Shared@10.0.0-rc.2

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=RA.Utilities.Logging.Shared&version=10.0.0-rc.2&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=RA.Utilities.Logging.Shared&version=10.0.0-rc.2&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

RA.Utilities.Logging.Shared

RA.Utilities.Logging.Shared provides shared components and abstractions for logging HTTP requests and responses within the RA.Utilities ecosystem. This package contains core models and helpers used by other logging libraries, such as RA.Utilities.Api.Middlewares, to ensure a consistent approach to capturing and structuring diagnostic information for HTTP calls.

Purpose

This package is a foundational library and is not intended for direct use in most applications. Its primary role is to provide a common set of data structures (models) that other RA.Utilities packages can rely on for logging HTTP traffic.

By centralizing these models, we ensure that any middleware or service that logs HTTP requests and responses does so in a consistent, structured format.

🛠️ Installation

While you typically won't need to install this package directly, it is available on NuGet. It will be included automatically when you install a dependent package like RA.Utilities.Api.Middlewares.

dotnet add package RA.Utilities.Logging.Shared

Core Components

This package provides the data models used to structure log information for HTTP interactions.

`BaseHttpLogTemplate`

public class BaseHttpLogTemplate

This is the primary model used to capture a complete picture of an HTTP request-response cycle.

Properties

Base containing HTTP request response properties for logging.

Name	Type	Required	Description
RequestId.	`string`	Unique identifier to represent this request in trace logs.
TraceIdentifier	`string`	false	Unique identifier to represent this request in trace logs. Value of `HttpContext.TraceIdentifier`
Path	`string`	false	The URI used by the request message.
RequestedOn	`DateTime`	true	DateTime requested on. Default value `DateTime.UtcNow`
RemoteAddress	`string`	false	The host name requested. This is usually the DNS host name or IP address of the server.

HttpRequestLogTemplate

Model for logging HTTP request.

public class HttpRequestLogTemplate : BaseHttpLogTemplate

HttpRequestLogTemplate inherits from [BaseHttpLogTemplate] so it will have all properties of [BaseHttpLogTemplate] class.

Name	Type	Required	Description
Schema	`string`	false	Scheme string of request Uri used by the request message.
Method	`string`	false	The HTTP method used by the request message.
QueryString	`string`	false	The query string used by the request message.
RequestHeaders	`IDictionary<string, string>`	false	Collection of HTTP request headers used by the request message.
RequestBody	`object`	false	HTTP Request body.

HttpResponseLogTemplate

Model for logging HTTP response.

public class HttpResponseLogTemplate : BaseHttpLogTemplate

HttpResponseLogTemplate inherits from [BaseHttpLogTemplate] so it will have all properties of [BaseHttpLogTemplate] class.

Name	Type	Required	Description
StatusCode	`int`	true	The status code of the HTTP response.
ResponseHeaders	`IDictionary<string, string>`	false	Collection of HTTP response headers.
ResponseBody	`object`	false	HTTP Request body.

Contributing

Contributions are welcome! If you have a suggestion or find a bug, please open an issue to discuss it. Please follow the contribution guidelines outlined in the other RA.Utilities packages.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- No dependencies.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on RA.Utilities.Logging.Shared:

Package	Downloads
RA.Utilities.Api.Middlewares RA.Utilities.Api.Middlewares provides a simple and efficient ASP.NET Core middleware for logging HTTP request and response details. It's designed to be easy to integrate, configurable, and performant, using Microsoft.IO.RecyclableMemoryStream to minimize memory allocations and improve application performance.	69
RA.Utilities.Integrations A utility library to simplify and standardize HTTP client calls in .NET applications. It builds upon `IHttpClientFactory` to provide a structured way to configure and use typed HTTP clients for various integrations.	66

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
10.0.0-rc.2	135	10/30/2025