CM.Logger 1.0.2

CM.Logger

CM.Logger es una biblioteca base para registrar logs, excepciones y eventos de aplicación en SQL Server, pensada para ser reutilizable en distintos tipos de proyectos .NET.

Está diseñada para funcionar como núcleo común y puede extenderse mediante paquetes específicos para:

• ASP.NET clásico (CM.Logger.AspNet)
• ASP.NET Core (CM.Logger.AspNetCore)

Características

• Registro centralizado en SQL Server
• Soporte para:
  • Info
  • Warning
  • Error
  • Debug
  • Fatal
  • Excepciones
• Integración con Stored Procedure
• Compatible con .NET Standard 2.0
• Reutilizable en:
  • aplicaciones ASP.NET clásicas
  • ASP.NET Core
  • apps de consola
  • servicios Windows
• Posibilidad de enriquecer logs con contexto adicional

Paquetes relacionados

• CM.Logger → núcleo
• CM.Logger.AspNet → integración con ASP.NET clásico / WebForms / MVC 5
• CM.Logger.AspNetCore → integración con ASP.NET Core

Instalación

Package Manager

Install-Package CM.Logger
.NET CLI
dotnet add package CM.Logger
Configuración básica
using System;
using CM.Logger.Models;
using CM.Logger.Static;

AppLogger.Configure(new LoggingOptions
{
    ConnectionString = "Server=.;Database=CM_LOGS;Trusted_Connection=True;Encrypt=True;TrustServerCertificate=True;",
    ApplicationName = "MiAplicacion",
    EnvironmentName = "DEV",
    ServerName = Environment.MachineName,
    VersionApp = "1.0.0",
    DefaultOrigen = "APP",
    CaptureMachineName = true,
    CaptureEnvironmentUserName = true,
    ThrowExceptions = false
});
Ejemplos de uso
Log informativo
AppLogger.LogInfo("Aplicación iniciada", "Program", "Main");
Warning
AppLogger.LogWarning("El folio llegó vacío", "Cotizaciones", "Validar");
Error
AppLogger.LogError("Ocurrió un error al guardar", "Cotizaciones", "Guardar");
Debug
AppLogger.LogDebug("Entró al método de cálculo", "Servicios", "Calcular");
Fatal
AppLogger.LogFatal("Fallo crítico en inicialización", "Global", "Application_Start");
Excepción
try
{
    int x = 0;
    int y = 10 / x;
}
catch (Exception ex)
{
    AppLogger.LogException(ex, "Error matemático", "Pruebas", "Division");
}
Log manual con LogEntry
using CM.Logger.Models;
using CM.Logger.Static;

AppLogger.Log(new LogEntry
{
    Nivel = "ERROR",
    TipoLog = "EXCEPCION",
    Mensaje = "Error al procesar solicitud",
    Detalle = "Se intentó procesar un registro inválido",
    Entidad = "Cotizacion",
    EntidadId = "12345",
    Modulo = "Cotizaciones",
    Metodo = "Procesar"
});
Estructura sugerida en SQL Server
Tabla AppLog
CREATE TABLE dbo.AppLog
(
    IdLog               BIGINT IDENTITY(1,1) NOT NULL PRIMARY KEY,
    FechaRegistro       DATETIME2(0) NOT NULL CONSTRAINT DF_AppLog_FechaRegistro DEFAULT (SYSDATETIME()),

    Nivel               VARCHAR(20) NOT NULL,
    TipoLog             VARCHAR(30) NULL,

    Aplicacion          VARCHAR(150) NOT NULL,
    Ambiente            VARCHAR(50) NULL,
    Servidor            VARCHAR(100) NULL,
    Maquina             VARCHAR(100) NULL,
    VersionApp          VARCHAR(50) NULL,

    Modulo              VARCHAR(150) NULL,
    Clase               VARCHAR(200) NULL,
    Metodo              VARCHAR(200) NULL,
    Origen              VARCHAR(50) NULL,

    Usuario             VARCHAR(100) NULL,
    SessionId           VARCHAR(100) NULL,
    CorrelationId       VARCHAR(100) NULL,

    Mensaje             VARCHAR(1000) NOT NULL,
    Detalle             VARCHAR(MAX) NULL,
    Excepcion           VARCHAR(MAX) NULL,
    StackTrace          VARCHAR(MAX) NULL,

    Url                 VARCHAR(1000) NULL,
    HttpMethod          VARCHAR(20) NULL,
    IpAddress           VARCHAR(50) NULL,
    UserAgent           VARCHAR(1000) NULL,

    RequestData         VARCHAR(MAX) NULL,
    ResponseData        VARCHAR(MAX) NULL,
    DatosExtraJson      VARCHAR(MAX) NULL,

    Entidad             VARCHAR(100) NULL,
    EntidadId           VARCHAR(100) NULL,
    CodigoError         VARCHAR(50) NULL,

    EsRevisado          BIT NOT NULL CONSTRAINT DF_AppLog_EsRevisado DEFAULT (0),
    FechaRevision       DATETIME2(0) NULL,
    UsuarioRevision     VARCHAR(100) NULL
);
GO
Índices sugeridos
CREATE NONCLUSTERED INDEX IX_AppLog_FechaRegistro
ON dbo.AppLog (FechaRegistro DESC);
GO

CREATE NONCLUSTERED INDEX IX_AppLog_Nivel_Fecha
ON dbo.AppLog (Nivel, FechaRegistro DESC);
GO

CREATE NONCLUSTERED INDEX IX_AppLog_Aplicacion_Fecha
ON dbo.AppLog (Aplicacion, FechaRegistro DESC);
GO

CREATE NONCLUSTERED INDEX IX_AppLog_CorrelationId
ON dbo.AppLog (CorrelationId);
GO
Restricción sugerida de nivel
ALTER TABLE dbo.AppLog
ADD CONSTRAINT CK_AppLog_Nivel
CHECK (Nivel IN ('TRACE', 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'FATAL'));
GO
Stored Procedure sugerido
CREATE PROCEDURE dbo.sp_AppLog_Insert
    @Nivel             VARCHAR(20),
    @TipoLog           VARCHAR(30) = NULL,

    @Aplicacion        VARCHAR(150),
    @Ambiente          VARCHAR(50) = NULL,
    @Servidor          VARCHAR(100) = NULL,
    @Maquina           VARCHAR(100) = NULL,
    @VersionApp        VARCHAR(50) = NULL,

    @Modulo            VARCHAR(150) = NULL,
    @Clase             VARCHAR(200) = NULL,
    @Metodo            VARCHAR(200) = NULL,
    @Origen            VARCHAR(50) = NULL,

    @Usuario           VARCHAR(100) = NULL,
    @SessionId         VARCHAR(100) = NULL,
    @CorrelationId     VARCHAR(100) = NULL,

    @Mensaje           VARCHAR(1000),
    @Detalle           VARCHAR(MAX) = NULL,
    @Excepcion         VARCHAR(MAX) = NULL,
    @StackTrace        VARCHAR(MAX) = NULL,

    @Url               VARCHAR(1000) = NULL,
    @HttpMethod        VARCHAR(20) = NULL,
    @IpAddress         VARCHAR(50) = NULL,
    @UserAgent         VARCHAR(1000) = NULL,

    @RequestData       VARCHAR(MAX) = NULL,
    @ResponseData      VARCHAR(MAX) = NULL,
    @DatosExtraJson    VARCHAR(MAX) = NULL,

    @Entidad           VARCHAR(100) = NULL,
    @EntidadId         VARCHAR(100) = NULL,
    @CodigoError       VARCHAR(50) = NULL
AS
BEGIN
    SET NOCOUNT ON;

    BEGIN TRY
        INSERT INTO dbo.AppLog
        (
            FechaRegistro,
            Nivel,
            TipoLog,
            Aplicacion,
            Ambiente,
            Servidor,
            Maquina,
            VersionApp,
            Modulo,
            Clase,
            Metodo,
            Origen,
            Usuario,
            SessionId,
            CorrelationId,
            Mensaje,
            Detalle,
            Excepcion,
            StackTrace,
            Url,
            HttpMethod,
            IpAddress,
            UserAgent,
            RequestData,
            ResponseData,
            DatosExtraJson,
            Entidad,
            EntidadId,
            CodigoError
        )
        VALUES
        (
            SYSDATETIME(),
            @Nivel,
            @TipoLog,
            @Aplicacion,
            @Ambiente,
            @Servidor,
            @Maquina,
            @VersionApp,
            @Modulo,
            @Clase,
            @Metodo,
            @Origen,
            @Usuario,
            @SessionId,
            @CorrelationId,
            @Mensaje,
            @Detalle,
            @Excepcion,
            @StackTrace,
            @Url,
            @HttpMethod,
            @IpAddress,
            @UserAgent,
            @RequestData,
            @ResponseData,
            @DatosExtraJson,
            @Entidad,
            @EntidadId,
            @CodigoError
        );

        SELECT CAST(SCOPE_IDENTITY() AS BIGINT) AS IdLog;
    END TRY
    BEGIN CATCH
        DECLARE @ErrorMessage VARCHAR(4000) = ERROR_MESSAGE();
        DECLARE @ErrorSeverity INT = ERROR_SEVERITY();
        DECLARE @ErrorState INT = ERROR_STATE();

        RAISERROR(@ErrorMessage, @ErrorSeverity, @ErrorState);
    END CATCH
END
GO
Recomendaciones

En ambientes de desarrollo, usar:

Encrypt=True;TrustServerCertificate=True

En producción, usar certificado válido

No registrar contraseñas, tokens o datos sensibles sin sanitizar

Mantener el SP y la tabla como parte del script de instalación del sistema

Arquitectura interna
CM.Logger
│
├── Abstractions
├── Constants
├── Models
├── Infrastructure
│   ├── Sql
│   └── Context
├── Services
└── Static
Casos de uso recomendados

Registro de errores de negocio

Registro de excepciones no controladas

Auditoría básica

Monitoreo centralizado desde visor MVC o dashboard interno

Licencia

MIT