CM.Logging.AspNet 1.0.2

CM.Logger.AspNet

Extensión oficial para integrar CM.Logger en aplicaciones ASP.NET clásico (WebForms / MVC en .NET Framework 4.8).

Permite capturar automáticamente el contexto HTTP (HttpContext.Current) y enriquecer los logs con información relevante del request sin necesidad de código adicional en cada capa.

🚀 Instalación

Install-Package CM.Logger.AspNet

🧱 Requisitos

• .NET Framework 4.8
• Proyecto WebForms o MVC clásico
• Base de datos SQL Server

⚙️ Configuración

1. ConnectionString (web.config)

<connectionStrings>
  <add name="DefaultConnection"
       connectionString="Server=.;Database=CM_LOGS;Trusted_Connection=True;Encrypt=True;TrustServerCertificate=True;"
       providerName="System.Data.SqlClient" />
</connectionStrings>

2. Inicializar Logger (Global.asax.cs)

using System;
using System.Configuration;
using CM.Logger.AspNet.Helpers;
using CM.Logger.Models;

public class Global : System.Web.HttpApplication
{
    protected void Application_Start(object sender, EventArgs e)
    {
        var conn = ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString;

        AppLoggerAspNetConfigurator.Configure(new LoggingOptions
        {
            ConnectionString = conn,
            ApplicationName = "ClinicaCotizador",
            EnvironmentName = "DEV",
            ServerName = Environment.MachineName,
            VersionApp = "1.0.0",
            DefaultOrigen = "WEB",
            CaptureMachineName = true,
            CaptureEnvironmentUserName = false,
            ThrowExceptions = false
        });
    }
}

🧠 Contexto capturado automáticamente

📝 Uso básico

AppLogger.LogInfo("Proceso ejecutado correctamente");
AppLogger.LogWarning("Validación incompleta");
AppLogger.LogError("Error en proceso", ex);

🧪 Ejemplo real (WebForms)

protected void btnGuardar_Click(object sender, EventArgs e)
{
    try
    {
        // lógica de guardado
        AppLogger.LogInfo("Se guardó correctamente la cotización");
    }
    catch (Exception ex)
    {
        AppLogger.LogError("Error al guardar cotización", ex);
        throw;
    }
}

🗄️ Base de datos (ejemplo tabla)

CREATE TABLE CM_LOGS (
    Id BIGINT IDENTITY PRIMARY KEY,
    Fecha DATETIME2 DEFAULT GETDATE(),
    Nivel VARCHAR(20),
    Mensaje NVARCHAR(MAX),
    Excepcion NVARCHAR(MAX),
    Usuario NVARCHAR(100),
    Aplicacion NVARCHAR(100),
    Entorno NVARCHAR(50),
    IP NVARCHAR(50),
    Url NVARCHAR(MAX),
    Metodo NVARCHAR(10),
    CorrelationId NVARCHAR(50)
);

⚙️ SP sugerido

CREATE PROCEDURE SP_INSERT_LOG
    @Nivel VARCHAR(20),
    @Mensaje NVARCHAR(MAX),
    @Excepcion NVARCHAR(MAX),
    @Usuario NVARCHAR(100),
    @Aplicacion NVARCHAR(100),
    @Entorno NVARCHAR(50),
    @IP NVARCHAR(50),
    @Url NVARCHAR(MAX),
    @Metodo NVARCHAR(10),
    @CorrelationId NVARCHAR(50)
AS
BEGIN
    INSERT INTO CM_LOGS
    VALUES (GETDATE(), @Nivel, @Mensaje, @Excepcion, @Usuario, @Aplicacion, @Entorno, @IP, @Url, @Metodo, @CorrelationId)
END

🔐 Buenas prácticas

• ❌ No loguear contraseñas
• ❌ No loguear tokens JWT completos
• ✔ Sanitizar headers sensibles
• ✔ Usar niveles correctamente

🧩 Arquitectura

• CM.Logger (core)
• CM.Logger.AspNet (context provider)
• SQL Server (persistencia)

📦 Dependencias

• CM.Logger

📄 Licencia

MIT

👨‍💻 Autor

CM, RogerSantos , CodeRS