C Logger es una biblioteca de registro sencilla y eficiente para el lenguaje C. Permite escribir mensajes de registro en un archivo o en la consola, con distintos niveles de detalle y control. En este artículo, veremos las características de C Logger, cómo instalarlo y cómo usarlo en sus proyectos en C.
Las características del obturador
C logger es una biblioteca ligera, compuesta por tan solo 500 líneas de código fuente. Es compatible con el estándar C89 y es segura para subprocesos. Ofrece dos tipos de registro:
- Registro de consola, que muestra mensajes de registro en la salida estándar o en la salida de error.
- Registro en un archivo, que escribe mensajes de registro en un archivo de texto, con rotación automática según el tamaño del archivo.
c logger también permite la personalización del registro con un archivo de configuración, en el que se puede definir el formato del mensaje, el nivel de detalle, el nombre del archivo de registro, el tamaño máximo del archivo, etc.
¿Cómo instalo Clogger?
Para instalar C Logger, simplemente descargue el código fuente del repositorio de GitHub y compílelo con su compilador de C preferido. Por ejemplo, con gcc:
$ git clone https://github.com/yksz/c-logger.git $ cd c-logger $ gcc -c -o logger.o logger.c $ ar rcs libclogger.a logger.o
Esto creará un archivo estático libclogger.a que puedes vincular a tu programa C. También necesitarás incluir el archivo de encabezado logger.h en tus archivos fuente.
¿Cómo uso el clogger?
Para usar C Logger, primero debe inicializar la biblioteca con la `logger_init` , pasándole el nombre del archivo de configuración o `NULL` si desea usar la configuración predeterminada. Después, puede usar la `logger` para escribir mensajes de registro, pasándole una etiqueta, un nivel y un mensaje. Por ejemplo:
#include "logger.h" int main(void) { /* Inicializar la biblioteca con el archivo config.ini */ if (logger_init("config.ini") != 0) { fprintf(stderr, "Error al inicializar c logger\n"); return 1; } /* Escribir un mensaje de nivel INFO con la etiqueta "main" */ logger("main", LOG_INFO, "Programa iniciado"); /* Escribir un mensaje de nivel ERROR con la etiqueta "main" */ logger("main", LOG_ERROR, "Error fatal"); /* Terminar la biblioteca */ logger_end(); return 0; }
El formato de los mensajes de registro depende del archivo de configuración utilizado. Por defecto, tiene el siguiente formato:
mensaje de nivel de etiqueta de fecha y hora
Por ejemplo :
2023-06-13 02:37:16 main INFO Inicio del programa 2023-06-13 02:37:16 main ERROR Error fatal
El formato se puede modificar utilizando las siguientes variables en el archivo de configuración:
- %d: la fecha en formato AAAA-MM-DD
- %t: la hora en formato HH:MM:SS
- %c: la etiqueta del mensaje
- %l: el nivel del mensaje
- %m: el mensaje
- %n: un salto de línea
Por ejemplo, si queremos un formato más corto, podemos utilizar:
[formatos] simple = "%t %c %l %m%n"
¿Qué niveles de detalle están disponibles?
c logger ofrece cinco niveles de detalle para los mensajes de registro:
- LOG_DEBUG: para depurar mensajes, útil para desarrolladores.
- LOG_INFO: para mensajes informativos, útiles para los usuarios.
- LOG_WARN: para mensajes de advertencia, útil para informar situaciones anormales pero no críticas.
- LOG_ERROR: para mensajes de error, útil para señalar situaciones críticas que impiden que el programa funcione correctamente.
- LOG_FATAL: para mensajes fatales, útil para señalar situaciones irrecuperables que requieren detener el programa.
El nivel de detalle de los mensajes de registro se puede controlar mediante la `log_level` del archivo de configuración. Por ejemplo, si solo desea mostrar los mensajes de ERROR y FATAL, puede usar:
[general] nivel_de_registro = 3
Los niveles están numerados del 0 al 4, del más detallado al menos detallado. Por defecto, el nivel es 0, que muestra todos los mensajes.
¿Cómo controlar el tamaño del archivo de registro?
c logger permite limitar el tamaño del archivo de registro mediante la `max_file_size` del archivo de configuración. Por ejemplo, si desea que el archivo de registro no supere 1 MB, puede usar:
[general] tamaño máximo de archivo = 1048576
El tamaño se expresa en bytes. Por defecto, no hay límite de tamaño.
Cuando el archivo de registro alcanza su tamaño máximo, c logger crea un nuevo archivo con un sufijo numérico. Por ejemplo, si el nombre del archivo de registro es log.txt , el primer archivo creado será log.txt.1 , luego log.txt.2 , y así sucesivamente. El número máximo de archivos creados se controla mediante la max_file_count del archivo de configuración. Por ejemplo, si desea mantener un máximo de 10 archivos de registro, puede usar:
[general] número máximo de archivos = 10
De forma predeterminada, no hay límite en la cantidad de archivos.
Preguntas frecuentes
¿Cuál es la diferencia entre c logger y otras bibliotecas de registro como log4c o nglogc?
C logger destaca por su simplicidad y diseño ligero. Si bien no ofrece tantas funciones como bibliotecas más completas, cubre las necesidades esenciales del registro. Además, es compatible con el estándar C89 y es seguro para subprocesos.
¿Cómo puedo mostrar mensajes de registro en un formato distinto al texto?
El registrador C solo admite el formato de texto para los mensajes de registro. Si desea usar otro formato, como JSON o XML, deberá crear su propia función de formato e invocarla dentro de la del registrador .
¿Cómo puedo filtrar los mensajes de registro según la etiqueta o el nivel?
c logger no ofrece filtrado avanzado de mensajes de registro. Solo se puede controlar el nivel general de los mensajes mediante la `log_level` en el archivo de configuración. Si desea filtrar los mensajes según la etiqueta o el nivel, deberá crear su propia función de filtrado e invocarla dentro de la `logger` .
¿Cómo puedo enviar mensajes de registro a un destino que no sea la consola o un archivo?
El registrador de C solo admite la consola y los archivos como destinos para los mensajes de registro. Si desea enviar mensajes a otro destino, como una base de datos o un servicio web, deberá crear su propia función de envío e invocarla dentro de la registrador .
¿Cómo depuro C-logger si hay un problema?
función `logger_debug` que muestra información sobre el estado interno de la biblioteca. Puede llamarla en cualquier momento para comprobar si el registrador de C funciona correctamente.
Conclusión
Clogger es una biblioteca de registro sencilla y eficiente para el lenguaje C. Permite escribir mensajes de registro en un archivo o en la consola, con distintos niveles de detalle y control. Es fácil de instalar y usar, y ofrece personalización mediante un archivo de configuración. Clogger se basa en mejores-memoria-ram-a-objetos-/" target="_blank">principios de programación orientada a objetos , lo que permite crear objetos de registro con propiedades y métodos específicos. Clogger es una solución ideal para desarrolladores que desean añadir funcionalidad de registro a sus proyectos en C sin complicaciones.
