Correlate 3.0.0

Correlate requests between microservices using a correlation id.

Install-Package Correlate -Version 3.0.0
dotnet add package Correlate --version 3.0.0
<PackageReference Include="Correlate" Version="3.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Correlate --version 3.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

.NET Core support for correlation ID in ASP.NET Core and HttpClient.

v3.0

  • (breaking) It is no longer a requirement for logging or diagnostics to be enabled, Correlate now just works regardless. This now allows integrations to be less dependent on the log provider (ILoggerFactory/ILogger) and makes unit testing easier (Microsoft.Extensions.Logging.Abstractions.NullLogger{T} can now be used). Note however, that for production environments, ILoggerFactory is still required, in order for the CorrelationId property to be added to each log event.
  • (breaking) Reworked CorrelationManager. It now has synchronous support for codebases that do not support asynchronous code. Also added overloads Func{T} and Func{Task{T}} allowing the return of values. New interfaces ICorrelationManager and IAsyncCorrelationManager are introduced for better separation, DI and unit testing. Reworked OnException delegate to be type safe and allowing a return value to be provided, if needed.
  • Middleware no longer calls internal method in other assembly, but now uses the new and public IAsyncCorrelationManager making it more resilient to version discrepancies.

.NET Core support for correlation ID in ASP.NET Core and HttpClient.

v3.0

  • (breaking) It is no longer a requirement for logging or diagnostics to be enabled, Correlate now just works regardless. This now allows integrations to be less dependent on the log provider (ILoggerFactory/ILogger) and makes unit testing easier (Microsoft.Extensions.Logging.Abstractions.NullLogger{T} can now be used). Note however, that for production environments, ILoggerFactory is still required, in order for the CorrelationId property to be added to each log event.
  • (breaking) Reworked CorrelationManager. It now has synchronous support for codebases that do not support asynchronous code. Also added overloads Func{T} and Func{Task{T}} allowing the return of values. New interfaces ICorrelationManager and IAsyncCorrelationManager are introduced for better separation, DI and unit testing. Reworked OnException delegate to be type safe and allowing a return value to be provided, if needed.
  • Middleware no longer calls internal method in other assembly, but now uses the new and public IAsyncCorrelationManager making it more resilient to version discrepancies.

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
3.0.0 220 7/23/2019
2.4.0 335 7/2/2019
2.3.0 1,910 5/11/2019
2.2.0 113 4/7/2019
2.1.4 2,288 3/15/2019
2.1.3 83 3/15/2019
2.1.1 765 3/15/2019
2.1.0 768 3/15/2019