CSharpEssentials.LoggerHelper
4.0.0
dotnet add package CSharpEssentials.LoggerHelper --version 4.0.0
NuGet\Install-Package CSharpEssentials.LoggerHelper -Version 4.0.0
<PackageReference Include="CSharpEssentials.LoggerHelper" Version="4.0.0" />
<PackageVersion Include="CSharpEssentials.LoggerHelper" Version="4.0.0" />
<PackageReference Include="CSharpEssentials.LoggerHelper" />
paket add CSharpEssentials.LoggerHelper --version 4.0.0
#r "nuget: CSharpEssentials.LoggerHelper, 4.0.0"
#:package CSharpEssentials.LoggerHelper@4.0.0
#addin nuget:?package=CSharpEssentials.LoggerHelper&version=4.0.0
#tool nuget:?package=CSharpEssentials.LoggerHelper&version=4.0.0
📦 CSharpEssentials.LoggerHelper
The ultimate Serilog sink hub — extensible, modular, centralized.
💡 Why CSharpEssentials.LoggerHelper?
CSharpEssentials.LoggerHelper is not just another logging library — it’s a smart hub for Serilog sinks.
Thanks to its modular architecture, you can plug in only the sinks you need.
Key strengths include:
Centralized & flexible configuration – Choose which sinks receive which log levels using
appsettings.LoggerHelper.json
. For example, send onlyError
messages to Email while routing all logs to ElasticSearch. No code changes required.*- Unified observability & dashboard – The
Sink.Telemetry
package integrates logs, metrics and traces via OpenTelemetry. Each log entry carries atrace_id
so you can correlate distributed requests. An interactive dashboard lets you visualize traces, sink errors and telemetry, and configure alerts.Structured properties & enrichment – Standard fields like
IdTransaction
,ApplicationName
,MachineName
andAction
are included by default. You can add custom properties (e.g., username, IP) with enricher functions, and they'll appear across all sinks.Modular architecture & error inspection – Each sink (Console, File, MSSQL, PostgreSQL, ElasticSearch, Email, Telegram, xUnit, Telemetry) is a separate NuGet package. Install only what you need; the core loads them dynamically. It also exposes
CurrentError
and an in-memoryErrors
queue to help debug initialization failures.
🧠 Error Insight Built-In:
When something goes wrong, you can inspect:
CurrentError
: the last exception messageErrors
: the complete in-memory queue of failures
Perfect for debugging deployment or configuration issues.
🆕 What’s New in 3.1.5?
✨ Added Sink: xUnit
When running tests in environments like DevOps pipelines, DBs and external endpoints may not always be accessible.
No worries — with the xUnit sink, you get a full trace of failed tests directly inside your test output.
Just install the package and define your desired levels (Information
, Warning
, Error
, etc.).
Perfect for debugging flaky tests or disconnected environments.
🔌 Available Sink Packages
- Console:
CSharpEssentials.LoggerHelper.Sink.Console
- File:
CSharpEssentials.LoggerHelper.Sink.File
- MSSqlServer:
CSharpEssentials.LoggerHelper.Sink.MSSqlServer
- PostgreSQL:
CSharpEssentials.LoggerHelper.Sink.PostgreSql
- ElasticSearch:
CSharpEssentials.LoggerHelper.Sink.Elasticsearch
- Telegram:
CSharpEssentials.LoggerHelper.Sink.Telegram
Used viaHttpClient
- Email:
CSharpEssentials.LoggerHelper.Sink.Email
Used viaSystem.Net.Mail
- xUnit:
CSharpEssentials.LoggerHelper.Sink.xUnit
✅ ( new from 3.1.5 ) -
- "Telemetry":
CSharpEssentials.LoggerHelper.Sink.Telemetry
–CSharpEssentials.LoggerHelper.Sink.Telemetry
collects logs, metrics and traces using OpenTelemetry.
- "Telemetry":
👉 Check out how to use the package in the documentation
📖 View the usage guide here!
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. 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. |
-
net6.0
- Microsoft.Extensions.Configuration (>= 9.0.1)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.1)
- Microsoft.Extensions.Configuration.Json (>= 9.0.1)
- Serilog (>= 4.2.0)
- Serilog.Settings.Configuration (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 9.0.4)
-
net8.0
- Microsoft.Extensions.Configuration (>= 9.0.1)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.1)
- Microsoft.Extensions.Configuration.Json (>= 9.0.1)
- Serilog (>= 4.2.0)
- Serilog.Settings.Configuration (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 9.0.4)
-
net9.0
- Microsoft.Extensions.Configuration (>= 9.0.1)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.1)
- Microsoft.Extensions.Configuration.Json (>= 9.0.1)
- Serilog (>= 4.2.0)
- Serilog.Settings.Configuration (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 9.0.4)
NuGet packages (10)
Showing the top 5 NuGet packages that depend on CSharpEssentials.LoggerHelper:
Package | Downloads |
---|---|
CSharpEssentials.LoggerHelper.Sink.Elasticsearch
Sink ElasticSearch for CSharpEssentials.LoggerHelper |
|
CSharpEssentials.LoggerHelper.Sink.MSSqlServer
Package Description |
|
CSharpEssentials.LoggerHelper.Sink.File
Sink File for package LoggerHelper |
|
CSharpEssentials.LoggerHelper.Sink.Postgresql
Package Description |
|
CSharpEssentials.LoggerHelper.Sink.Console
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last Updated |
---|---|---|
4.0.0 | 14 | 8/25/2025 |
3.1.6 | 230 | 8/5/2025 |
3.1.5 | 266 | 6/15/2025 |
3.1.4 | 358 | 6/12/2025 |
3.1.3 | 289 | 6/11/2025 |
3.1.2 | 209 | 6/9/2025 |
3.1.1 | 408 | 6/8/2025 |
3.1.0 | 193 | 6/8/2025 |
3.0.6 | 148 | 6/5/2025 |
3.0.5 | 150 | 6/5/2025 |
3.0.4 | 142 | 6/2/2025 |
3.0.3 | 145 | 6/2/2025 |
3.0.2 | 356 | 6/1/2025 |
3.0.1 | 143 | 5/30/2025 |
3.0.0 | 156 | 5/30/2025 |
2.0.9 | 76 | 5/24/2025 |
2.0.8 | 112 | 5/23/2025 |
2.0.7 | 114 | 5/23/2025 |
2.0.6 | 138 | 5/19/2025 |
2.0.5 | 227 | 5/14/2025 |
2.0.4 | 256 | 5/13/2025 |
2.0.1 | 134 | 5/11/2025 |
2.0.0 | 137 | 5/11/2025 |
1.3.1 | 139 | 5/11/2025 |
1.2.3 | 88 | 5/10/2025 |
1.2.2 | 72 | 5/10/2025 |
1.2.1 | 116 | 5/9/2025 |
1.1.6 | 145 | 5/6/2025 |
1.1.5 | 168 | 5/5/2025 |
1.1.4 | 150 | 5/4/2025 |
1.1.3 | 165 | 5/4/2025 |
1.1.2 | 155 | 5/4/2025 |
1.1.1 | 147 | 5/4/2025 |
1.0.1 | 121 | 2/19/2025 |
1.0.0 | 109 | 2/19/2025 |