Levge.AuditLog 1.1.48

<img src="icon.png" width="100" height="100" alt="Levge.AuditLog logo" />

Levge.AuditLog

🌐 Read in Turkish languages

Levge.AuditLog is a library that provides easy-to-use audit logging and request logging for ASP.NET Core applications using Entity Framework Core.

Features

• ✔️ Automatic audit logging for Entity Framework Core entity changes (create, update, delete).
• ✔️ Middleware for logging HTTP requests.
• ✔️ Background jobs for automatically cleaning up old logs.
• ✔️ Highly configurable through appsettings.json or delegate configuration.
• ✔️ Generic implementation to support any primary key type.

Installation

.NET CLIdotnet add package Levge.AuditLog### Package ManagerInstall-Package Levge.AuditLog## Setup

1. Inherit from LevgeAuditDbContext<TKey> in your application's DbContext.

public class YourDbContext : LevgeAuditDbContext<int>
{
    public YourDbContext(DbContextOptions<YourDbContext> options, ICurrentUser<int> currentUser) 
        : base(options, currentUser)
    {
        }
    
        // Your DbSets...
    }

2. Add services to Program.cs.

   You can configure the services using IConfiguration (appsettings.json) or by providing an Action.

using Levge.AuditLog.SampleApp.Persistence; // Your DbContext namespace
using Levge.Identity.Providers; // Or your own ICurrentUser provider

var builder = WebApplication.CreateBuilder(args);

// ... other services

// Add Audit Logging
builder.Services.AddLevgeAuditLog<YourDbContext, int>(builder.Configuration);

// Or with action
// builder.Services.AddLevgeAuditLog<YourDbContext, int>(options =>
// {
//     options.EnableCleanupJob = true;
//     options.RetentionDays = 30;
//     options.CleanupTime = new TimeOnly(2, 0, 0);
// });

// Add Request Logging
builder.Services.AddRequestLogging<YourDbContext, int>(builder.Configuration);

// Or with action
// builder.Services.AddRequestLogging<YourDbContext, int>(options =>
// {
//     options.EnableCleanupJob = true;
//     options.RetentionDays = 15;
//     options.CleanupTime = new TimeSpan(2, 0, 0);
// });

var app = builder.Build();

// ...

// 3. Add Request Logging Middleware
app.UseRequestLogging<int>();
    
    // ...
    
    app.Run();

Configuration Options

AuditLogOptions

Configure these in the AuditLog section of your appsettings.json.

RequestLoggingOptions

Configure these in the RequestLogging section of your appsettings.json.

License

MIT License. See LICENSE for details.