CM.Logging.AspNet 1.0.0

CM.Logger.AspNetCore

Extensión para integrar CM.Logger en aplicaciones ASP.NET Core (.NET 6 / 7 / 8+).

Incluye soporte para DI, middleware HTTP y captura automática del contexto de cada request.

🚀 Instalación

dotnet add package CM.Logger.AspNetCore

🧱 Requisitos

• .NET 6+ / .NET 8 recomendado
• ASP.NET Core (API / MVC / Razor)

⚙️ Configuración

1. appsettings.json

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=.;Database=CM_LOGS;Trusted_Connection=True;Encrypt=True;TrustServerCertificate=True;"
  }
}

2. Configurar en Program.cs

using CM.Logger.AspNetCore.Extensions;

builder.Services.AddCmLogging(options =>
{
    options.ConnectionString = builder.Configuration.GetConnectionString("DefaultConnection");
    options.ApplicationName = "BitacorasEnfermeria";
    options.EnvironmentName = builder.Environment.EnvironmentName;
    options.ServerName = Environment.MachineName;
    options.VersionApp = "1.0.0";
    options.DefaultOrigen = "WEB";
    options.CaptureMachineName = true;
    options.CaptureEnvironmentUserName = false;
    options.ThrowExceptions = false;
});

🧠 Contexto capturado

• Usuario autenticado
• IP
• URL
• Método HTTP
• Headers
• UserAgent
• CorrelationId

📝 Uso

AppLogger.LogInfo("Inicio del proceso");
AppLogger.LogWarning("Dato incompleto");
AppLogger.LogError("Error crítico", ex);

🧪 Ejemplo real (Controller)

[HttpPost]
public IActionResult Guardar()
{
    try
    {
        AppLogger.LogInfo("Guardando registro");
        return Ok();
    }
    catch (Exception ex)
    {
        AppLogger.LogError("Error en Guardar()", ex);
        return StatusCode(500);
    }
}

🚀 Middleware automático (opcional recomendado)

app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (Exception ex)
    {
        AppLogger.LogError("Error global no controlado", ex);
        throw;
    }
});

🗄️ Base de datos

Misma estructura que CM.Logger.AspNet.

🔌 DI Interno

El paquete registra:

• IHttpContextAccessor
• ILogContextProvider

🔐 Buenas prácticas

• Sanitizar Authorization header
• Limitar volumen de logs en producción
• Usar niveles correctamente

📦 Dependencias

• CM.Logger

🧩 Arquitectura

• CM.Logger (core)
• CM.Logger.AspNetCore (extensión)
• SQL Server

📄 Licencia

MIT

👨‍💻 Autor

CM, RogerSantos , CodeRS