📘 Aquila.SmartLogger

Aquila.SmartLogger is a zero-configuration, developer-friendly logging library for .NET that eliminates repetitive try/catch blocks and enforces clean, consistent, contextual logging across your application.

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

✨ Features

✅ Zero-config startup
🧠 Automatic context (method, file, line, OS, machine)
🧼 Clean Safe() execution wrapper
🎯 Multiple log levels: Debug, Info, Success, Warn, Error, Fatal
📄 Console + File logging targets
⚡ Optional live logging via API key
🧩 Extensible target architecture (Database, Webhooks, Cloud)
📦 Perfect for APIs, services, tools, and desktop apps
🛡 Thread-safe and lightweight

📦 Installation (NuGet)

dotnet add package Aquila.SmartLogger

Install-Package Aquila.SmartLogger

💻 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. Signup at: SmartLogger Signup

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

All logs will be pushed live to your dashboard, so you can monitor apps remotely.

🧪 Full Example

using System;
using Aquila.SmartLogger.Core;

class Program {
    static void Main() {
        AquilaLogger.Init(
            appName: "DemoApp",
            logFilePath: "logs/app.log",
            apiKey: "AQUILA_SECRET_2026_9CC8EF",
            liveOn: true
        );

        AquilaLogger.MinimumLevel = LogLevel.Debug;

        AquilaLogger.Info("Application started");
        AquilaLogger.Debug("Debug message");
        AquilaLogger.Success("Business operation successful");
        AquilaLogger.Warn("Potential issue detected");
        AquilaLogger.Error("Handled exception");
        AquilaLogger.Fatal("Critical failure");

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

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

🎚 Log Levels

Level	Usage
Debug	Development diagnostics
Info	Application flow
Success	Business success events
Warn	Potential issues
Error	Handled exceptions
Fatal	Critical failures

🧠 Why Safe() Is Powerful

// Traditional try/catch
try {
    DoSomething();
} catch(Exception ex) {
    logger.LogError(ex, "Failed");
}

// Aquila Safe wrapper
AquilaLogger.Safe(() => {
    DoSomething();
}, "Failed");

🧩 Extensibility

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

Targets: Database, HTTP API, Webhooks, Cloud logging, Slack, Email, etc.