Reo.Core.Logging 8.0.781

There is a newer version of this package available.
See the version list below for details.

dotnet add package Reo.Core.Logging --version 8.0.781

NuGet\Install-Package Reo.Core.Logging -Version 8.0.781

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="Reo.Core.Logging" Version="8.0.781" />

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

<PackageVersion Include="Reo.Core.Logging" Version="8.0.781" />
                    

                            Directory.Packages.props

<PackageReference Include="Reo.Core.Logging" />
                    

                            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 Reo.Core.Logging --version 8.0.781

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

#r "nuget: Reo.Core.Logging, 8.0.781"

#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 Reo.Core.Logging@8.0.781

#: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=Reo.Core.Logging&version=8.0.781
                    

                            Install as a Cake Addin

#tool nuget:?package=Reo.Core.Logging&version=8.0.781
                    

                            Install as a Cake Tool

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

Reo.Core.Logging

Описание пакета

Reo.Core.Logging — это библиотека для настройки и валидации конфигурации логгирования с использованием Serilog. Пакет обеспечивает проверку корректности настроек, таких как Enrich, Using, WriteTo, и других, через FluentValidation. Это позволяет избежать ошибок в конфигурации приложения на этапе запуска, а также упрощает интеграцию с системами логгирования, такими как Graylog, ElasticSearch и консоль.

Решаемые проблемы

Обеспечение обязательного наличия критически важных настроек логгирования.
Валидация структуры конфигурации для предотвращения ошибок в работе логгирования.
Поддержка нескольких целевых систем логгирования (Console, Graylog, ElasticSearch).

Основные компоненты

Serilog Класс, представляющий настройки Serilog. Содержит свойства:
- Using — список используемых пакетов (например, Serilog.Sinks.Console).
- Enrich — список расширений для обогащения логов (например, FromLogContext).
- WriteTo — массив объектов WriteTo, определяющих, куда отправлять логи.
WriteTo Класс, описывающий целевую систему логгирования. Содержит:
- Name — имя цели (например, Console, Graylog, Elastic).
- Args — словарь аргументов для настройки цели (например, hostnameOrAddress, nodeUris).
SerilogSectionValidator Валидатор, проверяющий обязательные поля в Serilog, такие как Enrich, Using, и WriteTo. Генерирует ошибки, если конфигурация не соответствует требованиям.
WriteToSectionValidator Валидатор, проверяющий корректность настроек для каждой цели логгирования. Например, для Elastic проверяет наличие nodeUris, indexFormat, и т.д.
ReoLoggerSectionNotFoundException Исключение, выбрасываемое, если секция Serilog отсутствует в конфигурации.

Требования

.NET версии: 8.0, 9.0
Зависимости:
- Serilog
- FluentValidation

Установка

NuGet Package Manager

Install-Package Reo.Core.Logging

.NET CLI

dotnet add package Reo.Core.Logging

Настройка

Регистрация в DI-контейнере (ASP.NET Core)

Добавьте следующий код в Program.cs или Startup.cs:

var builder = WebApplication.CreateBuilder(args);
builder.Host.UseSerilog((context, configuration) =>
    configuration.ReadFrom.Configuration(context.Configuration));

Конфигурационные параметры

Пример appsettings.json:

{
  "Serilog": {
    "Using": ["Serilog.Sinks.Console", "Serilog.Sinks.Graylog"],
    "Enrich": ["FromLogContext", "WithThreadId"],
    "WriteTo": [
      {
        "Name": "Console",
        "Args": {
          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff} [{Level}] {Message}{NewLine}{Exception}"
        }
      },
      {
        "Name": "Graylog",
        "Args": {
          "serverUri": "http://graylog-server:12201",
          "messageTemplate": "{Message}"
        }
      }
    ]
  }
}

Использование

Пример 1: Настройка логгирования в ASP.NET Core

var app = builder.Build();
app.UseSerilog(); // Используется по умолчанию при использовании UseSerilog в Host

Пример 2: Проверка конфигурации в коде

var configuration = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .Build();

var validator = new SerilogSectionValidator();
var serilogConfig = new Options.Serilog();
configuration.GetSection("Serilog").Bind(serilogConfig);
validator.ValidateAndThrow(serilogConfig);

Лицензия

Данный пакет распространяется под лицензией MIT.

Product	Compatible and additional computed target framework versions.
.NET	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 was computed. 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.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net8.0
- ertelecom.Serilog.Sinks.Graylog (>= 1.1.0)
- FluentValidation (>= 11.11.0)
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.CSharp (>= 4.7.0)
- Microsoft.Extensions.Configuration (>= 10.0.1)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.1)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.1)
- Microsoft.Extensions.DependencyInjection (>= 10.0.1)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.1)
- Microsoft.Extensions.Logging (>= 10.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.1)
- Microsoft.Extensions.Options (>= 10.0.1)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.1)
- Newtonsoft.Json (>= 13.0.4)
- Serilog (>= 4.3.0)
- Serilog.AspNetCore (>= 10.0.0)
- Serilog.Sinks.PeriodicBatching (>= 5.0.0)
- stbychkov.AutoLoggerMessage (>= 1.0.15)
- System.IO.Pipelines (>= 10.0.1)
- System.Text.Encodings.Web (>= 10.0.1)
- System.Text.Json (>= 10.0.1)

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Reo.Core.Logging:

Package	Downloads
Reo.Core.IntegrationTesting Package Description	990.2K
Reo.Core.Queue.MassTransit Package Description	573

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
10.0.31	0	2/13/2026
10.0.30	26	2/12/2026
10.0.29	27	2/12/2026
10.0.28	34	2/11/2026
10.0.27	38	2/11/2026
10.0.26	88	2/9/2026
10.0.25	80	2/9/2026
10.0.24	90	2/9/2026
10.0.23	80	2/9/2026
10.0.22	79	2/9/2026
10.0.21	85	2/9/2026
10.0.20	82	2/9/2026
10.0.15	93	2/6/2026
10.0.14	92	2/6/2026
10.0.13	90	2/4/2026
10.0.12	89	2/3/2026
10.0.11	105	2/2/2026
10.0.10	93	1/29/2026
10.0.9	93	1/29/2026
8.0.781	211	12/23/2025