Aquila.SmartLogger 1.0.6

📘 Aquila.SmartLogger

Aquila.SmartLogger is a lightweight, zero-configuration logging library for .NET designed to eliminate repetitive try/catch blocks while providing rich, structured, and consistent logs automatically.

It focuses on developer experience, clean code, and real-world production needs.

Write business logic.
Aquila handles logging, errors, context, and even live streaming to your dashboard.

Why Aquila.SmartLogger?

Most applications suffer from:

• Repeated try/catch blocks
• Inconsistent logging styles
• Missing runtime context
• Logs that are hard to trace and debug

Aquila.SmartLogger solves this by introducing Safe execution wrappers, automatic context capture, and optional live logging.

Key Features

• Zero-config setup

• Console and File logging support

• Structured JSON logs

• Automatic context capture:

  • Method name
  • Source file
  • Line number
  • Machine name
  • OS details

• Multiple log levels:

  • Debug
  • Info
  • Success
  • Warn
  • Error
  • Fatal

• Clean Safe() execution wrappers

• Generic Safe<T>() support

• Extensible logging targets

• Lightweight and fast

• Optional live logging to dashboard

• No external dependencies

Installation

Install via NuGet:

dotnet add package Aquila.SmartLogger

Or Package Manager:

Install-Package Aquila.SmartLogger

Initialization & Setup

Local / Offline Logging

This mode logs events only to your local logs folder. No live dashboard is used.

AquilaLogger.Init(
    logDirectory: "logs",
    apiKey: "AQUILA_SECRET_2026",
    liveOn: false
);

• ✅ Logs are stored in local files
• ✅ No internet connection required
• ✅ Ideal for testing or offline applications

All logs will be written in logs/<appname>.log as plain text.

Live Logging (Dashboard)

Enable live logs in your dashboard using your unique API key. Sign up at: SmartLogger Signup

AquilaLogger.Init(
    logDirectory: "logs",
    apiKey: "AQUILA_SECRET_2026_XXXXXX",
    liveOn: true
);

• All logs will be pushed live to your dashboard
• Monitor apps remotely in real-time
• Requires a valid API key obtained from signup

Basic Logging

AquilaLogger.Debug("Debug message");
AquilaLogger.Info("Application started");
AquilaLogger.Success("Operation completed successfully");
AquilaLogger.Warn("Potential issue detected");
AquilaLogger.Error(new Exception("Something went wrong"));
AquilaLogger.Fatal("Critical failure");

Safe Execution (Core Feature)

Traditional Approach (Messy)

try
{
    DoSomething();
}
catch (Exception ex)
{
    logger.LogError(ex, "Something failed");
}

Aquila Approach (Clean)

AquilaLogger.Safe(() =>
{
    DoSomething();
}, "Something failed");

Benefits:

• One-line error handling
• Guaranteed logging
• Automatic context capture
• Consistent format across the project

Safe Execution with Return Value

int result = AquilaLogger.Safe(() =>
{
    return 10 / 2;
}, "Division failed");

If an exception occurs, the error is logged and default(T) is returned safely.

Complete Real-World Example

using System;
using Aquila.SmartLogger.Core;

class Program
{
    static void Main()
    {
        // Local mode
        AquilaLogger.Init(
            logDirectory: "logs",
            apiKey: "AQUILA_SECRET_2026",
            liveOn: false
        );

        // OR Live mode
        // AquilaLogger.Init(
        //     logDirectory: "logs",
        //     apiKey: "AQUILA_SECRET_2026_XXXXXX",
        //     liveOn: true
        // );

        AquilaLogger.MinimumLevel = LogLevel.Debug;

        AquilaLogger.Info("Application started");

        AquilaLogger.Safe(() =>
        {
            int result = 10 / 2;
            AquilaLogger.Success($"Division successful: {result}");
        }, "Division failed");

        AquilaLogger.Safe(() =>
        {
            int result = 10 / 0; // throws
            AquilaLogger.Success($"Result: {result}");
        }, "Division failed");

        Console.WriteLine("Logger demo finished");
    }
}

Log Output Format (JSON)

{
  "AppName": "DemoApp",
  "Level": "Error",
  "Message": "Division failed",
  "Exception": "System.DivideByZeroException...",
  "Method": "Safe",
  "File": "Program.cs",
  "Line": 24,
  "Machine": "AQUILAINNOVATIO",
  "OS": "Microsoft Windows NT",
  "Timestamp": "2026-01-26T05:49:44Z"
}

Log Levels

Set minimum log level:

AquilaLogger.MinimumLevel = LogLevel.Warn;

Extending the Logger

You can add new logging targets by implementing:

public interface ILogTarget
{
    void Write(LogEntry entry);
}

Examples:

• Database logging
• API logging
• Cloud logging
• Notification systems

Best Use Cases

• APIs and microservices
• Background workers
• Desktop applications
• CLI tools
• Enterprise applications
• Logging standardization across teams

License

MIT License © 2026 Aquila Innovations

Final Note

Aquila.SmartLogger is designed to reduce boilerplate, enforce consistency, and improve observability without slowing developers down.

Clean code in. Clear insight out.

“Write business logic. Aquila handles logging, context, errors, and live monitoring.”

---

✅ **What’s new in this update:**

1. Added **live logging (`liveOn: true`)** section.  
2. Clarified **local/offline logging (`liveOn: false`)**.  
3. Included **signup link** for users to get their API key.  
4. Maintained all existing examples, safe execution, and JSON logs.  
5. Clear distinction between **offline vs live mode**.

---