EasyLoggerBG 1.0.3
dotnet add package EasyLoggerBG --version 1.0.3
NuGet\Install-Package EasyLoggerBG -Version 1.0.3
<PackageReference Include="EasyLoggerBG" Version="1.0.3" />
<PackageVersion Include="EasyLoggerBG" Version="1.0.3" />
<PackageReference Include="EasyLoggerBG" />
paket add EasyLoggerBG --version 1.0.3
#r "nuget: EasyLoggerBG, 1.0.3"
#:package EasyLoggerBG@1.0.3
#addin nuget:?package=EasyLoggerBG&version=1.0.3
#tool nuget:?package=EasyLoggerBG&version=1.0.3
Documentación de Uso - Librería de Logging
Instalación
Para utilizar esta librería de logging en tu proyecto, necesitas:
- Instalar el paquete NuGet de la librería (por ejemplo:
MyCompany.Logging
) - Configurar los settings en tu archivo de configuración (opcional para Elasticsearch)
- Inicializar el logger en tu aplicación
Modos de Uso
1. Solo Logging en Archivos
Si solo necesitas logging en archivos locales:
builder.Host.AddCustomLogging();
2. Con Elasticsearch (Configuración Básica)
Para usar Elasticsearch sin autenticación:
var config = new ElasticConfiguration
{
Url = "http://elasticsearch:9200",
IndexPrefix = "mi-app-logs",
ApplicationName = "MiAplicacion"
};
builder.Host.AddCustomLogging(config);
3. Con Elasticsearch (Configuración Completa)
Para usar todas las características con configuración en appsettings.json:
var config = builder.Configuration
.GetSection(LoggingConstants.ElasticConfig)
.Get<ElasticConfiguration>();
builder.Host.AddCustomLogging(config);
Nota: builder.Host..AddCustomLogging(captureConsoleOutput: true), para tambien capturar la salida de consola. captureConsoleOutput: true
Configuración en appsettings.json
{
"ElasticConfig": {
"Url": "http://elasticsearch:9200",
"Username": "elastic", // Opcional
"Password": "password", // Opcional
"IndexPrefix": "mi-app-logs",
"ApplicationName": "MiAplicacion",
"NumberOfReplicas": 1,
"NumberOfShards": 2
}
}
Descripción de los Parámetros
Url
: URL del servidor ElasticsearchUsername
: (Opcional) Usuario para autenticaciónPassword
: (Opcional) Contraseña para autenticaciónIndexPrefix
: Prefijo para los índices de ElasticsearchApplicationName
: Nombre de tu aplicaciónNumberOfReplicas
: Número de réplicas en ElasticsearchNumberOfShards
: Número de shards en Elasticsearch
Características del Logging
Logs en Archivos (Siempre activo)
- Archivos separados por nivel:
logs/info-log-.txt
logs/warning-log-.txt
logs/error-log-.txt
Elasticsearch (Cuando está configurado)
- Índices mensuales automáticos
- Buffer local para fallos
- Autenticación opcional
- Manejo de fallos automático
Enriquecimiento de Logs
Siempre incluye:
- Nombre del ambiente
- Nombre de la máquina
- ID del thread
Con Elasticsearch configurado añade:
- Nombre de la aplicación
Rotación de Archivos
- Rotación diaria automática
- Retención de 30 días
- Límite de 10MB por archivo
Manejo de Errores y Resiliencia
La librería incluye las siguientes características de resiliencia:
Si Elasticsearch no está disponible:
- Los logs se guardan en archivos locales
- Los fallos se registran en
logs/elastic-failures.txt
Si la configuración de Elasticsearch es inválida o nula:
- El componente de Elasticsearch se omite automáticamente
- El logging continúa funcionando con archivos locales
Si las credenciales están vacías:
- La autenticación se omite
- Se intenta conexión sin autenticación
Ejemplo de Uso en Código
public class MiServicio
{
private readonly ILogger<MiServicio> _logger;
public MiServicio(ILogger<MiServicio> logger)
{
_logger = logger;
}
public void MiMetodo()
{
_logger.LogInformation("Mensaje de información");
_logger.LogWarning("Mensaje de advertencia");
_logger.LogError("Mensaje de error");
}
}
Notas Importantes
- La carpeta
logs
se crea automáticamente - Verifica permisos de escritura en la carpeta de logs
- La configuración de Elasticsearch es completamente opcional
- Los logs nunca se pierden, incluso si Elasticsearch falla
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. 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 was computed. 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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Serilog.AspNetCore (>= 9.0.0)
- Serilog.Enrichers.Environment (>= 3.0.1)
- Serilog.Enrichers.Thread (>= 4.0.0)
- Serilog.Sinks.Elasticsearch (>= 10.0.0)
- Serilog.Sinks.OpenSearch (>= 1.3.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.