HCOLogger 1.2.3

HcoLogs: Biblioteca de Registro Universal

HcoLogs es una biblioteca de registro versátil y universal diseñada para aplicaciones .NET, compatible con una amplia gama de versiones de .NET, desde .NET Framework 4.7.2 hasta .NET 8.0. Permite a los desarrolladores enviar registros a un servicio de registro centralizado de forma fácil y eficiente.

Características

• Compatibilidad Multi-Framework: Funciona con .NET Framework, .NET Core, y las últimas versiones de .NET.
• Registro Asíncrono y Síncrono: Ofrece métodos de registro tanto asíncronos como síncronos para adaptarse a diferentes necesidades de la aplicación.
• Registro Estándar e Histórico: Proporciona dos tipos de registros: un registro de información general (Log) y un registro histórico (LogH) para el seguimiento de eventos importantes y errores con información detallada como StackTrace.
• Configuración Flexible: Permite una configuración sencilla a través de la clase LoggerOptions, donde se puede especificar la URL del punto de conexión, la base de datos, el token de cliente y otros valores predeterminados.
• Manejo de Errores Robusto: Incluye un manejo de errores robusto para las solicitudes HTTP, con excepciones personalizadas para un mejor diagnóstico.

Instalación

Puede instalar HcoLogs a través del administrador de paquetes NuGet.

Install-Package HCOLogger

Cómo Empezar

A continuación, se muestran ejemplos de cómo utilizar la biblioteca HcoLogs en diferentes tipos de aplicaciones .NET.

Ejemplo en .NET 6 (ConsoleApp1)

Este ejemplo muestra cómo utilizar HcoLogs en una aplicación de consola .NET 6.

// Importar el espacio de nombres de HcoLogs
using HcoLogs;

// Configurar las opciones del registrador
var options = new LoggerOptions
{
    Database = "BD",
    ClientToken = "xxxxxx-xxxxxxx",
    DefaultOrigen = "my-dotnet-core-app"
};

// Crear una instancia del registrador
using (var logger = new Logger(options))
{
    // Registrar un mensaje de información de forma asíncrona
    await logger.LogAsync("Aplicación iniciada desde .NET 6", "INFO", "user123");
}

Ejemplo en .NET Framework 4.8 (ConsoleApp2)

Este ejemplo muestra cómo utilizar HcoLogs en una aplicación de consola de .NET Framework 4.8.

// Importar el espacio de nombres de HcoLogs
using HcoLogs;

// Configurar las opciones del registrador
var options = new LoggerOptions
{
    Database = "BD",
    ClientToken = "xxxxxx-xxxxxx",
    DefaultOrigen = "my-legacy-app"
};

// Crear una instancia del registrador
using (var logger = new Logger(options))
{
    // Registrar un mensaje de información de forma síncrona
    logger.Log("Proceso completado desde .NET Framework 4.8", "INFO", "admin");
}

Ejemplo en .NET 8 (ConsoleApp3)

Este ejemplo muestra un uso más avanzado de HcoLogs en una aplicación de consola .NET 8, incluyendo el registro histórico y el uso de múltiples parámetros.

// Importar el espacio de nombres de HcoLogs
using HcoLogs;

// Configurar las opciones del registrador
var options = new LoggerOptions
{
    Database = "BD",
    ClientToken = "xxxxxxx-xxxxxxx",
    DefaultCode = "AAAAAAAAAA"
};

// Crear una instancia del registrador
using (var logger = new Logger(options))
{
    // Registrar un evento histórico con todos los parámetros
    await logger.LogHAsync(
        detalle: "Aplicación iniciada v1.2.3",
        nivel: "INFO",
        usuario: "user123",
        origen: "Metodo a",
        codigoOcurrencia: 200,
        stackTrace: "es un stackTrace de ejemplo",
        versionServicio: "v2",
        parametrosEntradaId: "444",
        correlationId: "100",
        fechaHora: DateTime.Now
    );

    // Registrar un evento histórico con parámetros específicos
    await logger.LogHAsync("Aplicación iniciada", "INFO", versionServicio: "V5");

    // Registrar un evento de información con todos los parámetros
    await logger.LogAsync(
        detalle: "Aplicación iniciada desde .NET 8",
        nivel: "INFO",
        usuario: "user123",
        origen: "Metodo a",
        resultadoEsperado: "1234",
        resultadoReal: "1234",
        versionServicio: "v3",
        parametrosEntradaId: "22",
        correlationId: "101",
        fechaHora: DateTime.Now
    );
}

Opciones de Configuración (LoggerOptions)

La clase LoggerOptions le permite configurar el comportamiento del registrador.

Métodos de Registro

HcoLogs proporciona los siguientes métodos de registro:

Log y LogAsync

Estos métodos se utilizan para registrar entradas de registro estándar.

• Log(...): Realiza una llamada de registro síncrona.
• LogAsync(...): Realiza una llamada de registro asíncrona.

LogH y LogHAsync

Estos métodos se utilizan para registrar entradas de registro históricas, que son ideales para registrar errores y excepciones con información adicional.

• LogH(...): Realiza una llamada de registro histórica síncrona.
• LogHAsync(...): Realiza una llamada de registro histórica asíncrona.

Contribuciones

Las contribuciones son bienvenidas. Si desea contribuir a este proyecto, por favor, bifurque el repositorio y envíe una solicitud de extracción.