ArkaSoftware.Extensions.Logger.Abstractions 2.0.0

ArkaSoftware.Extensions.Logger.Abstractions

ArkaSoftware.Extensions.Logger.Abstractions provides a clean and extensible structure for defining logging metadata in .NET applications. It supports both host-level and request-level logging scopes and includes centralized event ID constants for consistent and traceable logging.

🔧 Components

🧱 ArkaSoftwareEventId

Defines a list of common event IDs for various categories of application-level logging.

public class ArkaSoftwareEventId
{
    public const int PerformanceMeasurement = 1001;
    public const int DomainValidationException = 1010;
    public const int CommandValidation = 1011;
    public const int QueryValidation = 1012;
    public const int EventValidation = 1013;
}

✅ Use these constants for structured and centralized event logging across your application.

🧱 IScopeInformation

Represents information to be included in log scopes, including machine-specific or request-specific data.

public interface IScopeInformation
{
    Dictionary<string, string> HostScopeInfo { get; }
    Dictionary<string, string> RequestScopeInfo { get; }
}

🧱 ScopeInformation

(Default Implementation)

Default implementation of IScopeInformation that auto-populates useful information such as:

• ✅ Machine name
• 🧠 Entry point assembly
• 🔁 Unique Request ID

public class ScopeInformation : IScopeInformation
{
    public ScopeInformation()
    {
        HostScopeInfo = new Dictionary<string, string>
        {
            {"MachineName", Environment.MachineName},
            {"EntryPoint", Assembly.GetEntryAssembly()!.GetName().Name! }
        };

        RequestScopeInfo = new Dictionary<string, string>
        {
            {"RequestId", Guid.NewGuid().ToString()}
        };
    }

    public Dictionary<string, string> HostScopeInfo { get; }
    public Dictionary<string, string> RequestScopeInfo { get; }
}

✨ Usage Example

You can inject IScopeInformation into your logging pipeline or middleware:

public class LoggingMiddleware
{
    private readonly IScopeInformation _scopeInfo;

    public LoggingMiddleware(IScopeInformation scopeInfo)
    {
        _scopeInfo = scopeInfo;
    }

    public void LogRequest()
    {
        foreach (var pair in _scopeInfo.RequestScopeInfo)
        {
            Console.WriteLine($"{pair.Key}: {pair.Value}");
        }
    }
}

✅ Benefits

• Promotes structured, contextual logging

• Enables centralized EventId management

• Helps in traceability and diagnostic logging

• Decoupled and reusable in any ASP.NET Core or .NET application

🏢 Maintained by

ArkaSoftware
📧 Email Us
🌐 Web Site Visit