Kllmp.Org.RALogger 1.0.1

Kllmp.Org.RALogger

Este proyecto proporciona una solución de logging personalizada para aplicaciones ASP.NET Core, permitiendo registrar información y errores en archivos de texto, con opciones de compresión automática y enriquecimiento de los logs con metadatos relevantes.

Clases principales

RANetLogger

RANetLogger es la implementación principal del logger. Permite registrar información y errores en archivos de log, incluyendo detalles como IP del cliente, nombre del servidor, nombre de la aplicación, y más.

Funcionalidades:

• LogInformation: Registra mensajes informativos, con posibilidad de incluir datos adicionales y detalles personalizados.
• LogError: Registra errores y excepciones, incluyendo el stack trace y metadatos del contexto HTTP.
• Compresión automática: Si el archivo de log supera los 30 MB, se comprime automáticamente en formato .gz y se elimina el archivo original.
• Configuración flexible: Se configura mediante la clase RANetLoggerOptions, permitiendo definir el nombre de la aplicación, ruta y nombre del log, y si el logger está activo.

Métodos principales:

• LogInformation(HttpContext context, string comment, object? data = null, List<string>? detalles = null, ...)
• LogError(HttpContext context, string comment, Exception ex, ...)
• LogInformation(string message, ...)
• LogError(string message, ...)
• LogError(Exception ex, string message, ...)

IRANetLogger

IRANetLogger es la interfaz que define los métodos públicos que debe implementar cualquier logger compatible. Permite registrar información y errores tanto con contexto HTTP como sin él.

Métodos definidos:

• LogInformation(HttpContext context, string comment, object? data = null, List<string>? detalles = null, ...)
• LogError(HttpContext context, string comment, Exception ex, ...)
• LogInformation(string message, ...)
• LogError(string message, ...)
• LogError(Exception ex, string message, ...)

Configuración

Para agregar el logger a tu proyecto, utiliza la extensión:

services.AddRANetLoggerExtension(options => { 
  options.IsActive = true; 
  options.LogName = "miapp"; 
  options.LogPath = @"C:\logs\miapp"; 
  options.NameApp = "MiAplicacion"; 
});

Ejemplo de uso

public HomeController(IRANetLogger logger)
{
    _logger = logger;
}

public IActionResult Index()
{
    _logger.LogInformation(HttpContext, "Acceso a Index", new { User = "admin" });
    return View();
}

Requisitos

• .NET 8 o Superior