CM.Logger 1.0.1

CM.Logging

CM.Logging es una biblioteca ligera y reutilizable para el registro centralizado de logs en SQL Server, diseñada para aplicaciones .NET tanto legacy (ASP.NET) como modernas (ASP.NET Core).

Permite capturar eventos, errores y excepciones de forma estructurada mediante stored procedures, facilitando el monitoreo y diagnóstico en entornos productivos.

🚀 Características

• Registro de logs en SQL Server

• Soporte para:

  • ASP.NET (Framework)
  • ASP.NET Core
  • Consola / Servicios

• Niveles de logging:

  • Info
  • Warning
  • Error
  • Debug
  • Fatal

• Registro de excepciones completo:

  • Mensaje
  • StackTrace
  • Detalle

• Configuración centralizada

• Extensible mediante Context Providers

• Compatible con .NET Standard 2.0

📦 Instalación

Desde NuGet:

Install-Package CM.Logging

o con .NET CLI:

dotnet add package CM.Logging

⚙️ Configuración básica

Antes de usar el logger, debes configurarlo:

using CM.Logging.Models;
using CM.Logging.Static;

AppLogger.Configure(new LoggingOptions
{
    ConnectionString = "Server=.;Database=TuBase;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 = true
});

🧪 Uso básico

Log informativo

AppLogger.LogInfo("Aplicación iniciada", "Program", "Main");

Warning

AppLogger.LogWarning("Advertencia detectada", "ModuloX", "MetodoY");

Error

AppLogger.LogError("Ocurrió un error", "ModuloX", "MetodoY");

Debug

AppLogger.LogDebug("Mensaje de depuración");

Fatal

AppLogger.LogFatal("Error crítico");

❗ Manejo de excepciones

try
{
    // Código que puede fallar
}
catch (Exception ex)
{
    AppLogger.LogException(ex, "Error al procesar la operación", "Servicio", "Metodo");
}

🗄️ Base de datos

El logger utiliza un Stored Procedure para insertar registros.

Ejemplo esperado:

CREATE PROCEDURE SP_INSERT_LOG
(
    @Nivel NVARCHAR(20),
    @Mensaje NVARCHAR(MAX),
    @Detalle NVARCHAR(MAX),
    @Excepcion NVARCHAR(MAX),
    @StackTrace NVARCHAR(MAX),
    @Modulo NVARCHAR(100),
    @Metodo NVARCHAR(100),
    @Clase NVARCHAR(200),
    @Usuario NVARCHAR(100),
    @Fecha DATETIME
)
AS
BEGIN
    INSERT INTO Logs (...)
    VALUES (...)
END

🧠 Contexto automático

El logger soporta enriquecimiento automático mediante ILogContextProvider.

Por defecto incluye:

• Usuario del sistema
• Nombre de la máquina
• Origen de la aplicación

🏗️ Arquitectura

La librería sigue un diseño desacoplado:

CM.Logging
│
├── Models
├── Abstractions
├── Services
├── Infrastructure
│   ├── Sql
│   └── Context
└── Static (AppLogger)

🔒 Seguridad

• No almacena credenciales sensibles automáticamente
• Depende de tu implementación del SP
• Compatible con conexiones cifradas (Encrypt=True)

📄 Licencia

Este proyecto está bajo la licencia MIT.

👨‍💻 Autor

Desarrollado por CM Roger Santos. CodeRS en GitHub.

💡 Recomendaciones

• Usar TrustServerCertificate=True en desarrollo
• Configurar certificados válidos en producción
• Centralizar logs para monitoreo (ej. dashboards futuros)

--

⭐ Contribuciones

Actualmente enfocado a uso interno

📞 Soporte

Para dudas o mejoras, contactar al equipo de desarrollo. ClinicadeMerida RogerSantos