BigLog 1.1.0

BigLog – Overview

BigLog is a flexible logging library for C#. It supports output to console and file, with configurable prefixes, timestamps, log levels, and optional colors.

ℹ️ Colors are only applied to console output. When logging to a file or using the cache, colored output is disabled. If cache logging is flushed to the terminal, Color_fallback is used.

ℹ️ By default, all log levels are enabled. You can set minimum log levels for both terminal and file outputs to filter messages.

ℹ️ Logging to services like Azure Application Insights or Seq is not supported in this version but it is under development.

Quick Start

using BigLog;

class Program
{
    static void Main()
    {
        Logger logger = new Logger()
        {
            LogToFile = true,
            UseShortPrefix = true
        };

        logger.Inf("Program started");
        logger.Suc("Operation successful");
        logger.War("Low memory warning");
        logger.Err("Failed to open file");
        logger.Ctm("Custom log message");
    }
}

Log Levels

All methods accept either a string or an Exception.

Example:

try
{
    throw new Exception("File read error");
}
catch (Exception ex)
{
    logger.Err(ex);
}

Settings

General

ℹ️ Log levels in increasing order are: Trace < Debug < Info < Success < Warning < Error < Critical < Fatal < Custom

ℹ️ Changing MinLogLevel sets both MinLogLevelTerminal and MinLogLevelFile to the same value.

Timestamp and Formatting

Prefixes

Example:

logger.PrefixInf = "[INFO] ";
logger.PrefixErr = "[ERROR] ";

Colors

Default colors per level (console only):

Note: Colors cannot be used when logging to a file or when messages are cached. When cached messages are flushed to the terminal, Color_fallback is applied.

Example:

logger.ColorWar = ConsoleColor.Magenta;
logger.ColorErr = ConsoleColor.DarkRed;

Cache

If AutoFlush = false, messages are cached instead of being written immediately.

Logger logger = new Logger()
{
    AutoFlush = false,
    LogToFile = true
};

logger.Inf("Batch started...");
logger.War("Minor warning...");
logger.flushCache(); // writes all cached logs and clears cache afterwards

Additional cache commands:

logger.ClearCache(); // clears the cache without writing

Common Configurations

Console output with colors

Logger logger = new Logger()
{
    LogToFile = false,
    ColorAll = true
};

File logging

Logger logger = new Logger()
{
    LogToTerminal = false,
    LogToFile = true,
};

Minimal output

Logger logger = new Logger()
{
    PrintTimeStamp = false,
    UseShortPrefix = true
};

License

This project is licensed under the GNU Affero General Public License (AGPL). See LICENSE for details.

Copyright Notice

Copyright © 2025 by Carl Öttinger

Contact

You can contact me via email at carl@oettinger.cloud or visit my website at bigvault.cloud.

Contributing

Contributions are welcome! Please open issues or pull requests on the GitHub repository.