Levge.AuditLog 1.0.19

Levge.AuditLog

🇹🇷 Türkçe açıklama için tıklayın.

Levge.AuditLog is a powerful and flexible audit logging system for Entity Framework Core. It automatically tracks and logs all changes (Create, Update, Delete) to your entities, including user information, timestamps, and field-level changes. The package also supports HTTP request logging, soft delete, per-user tracking, and scheduled cleanup of old logs.

Features

• ✅ Entity Change Tracking
  • Tracks Insert, Update, Delete operations automatically
  • Logs user ID, timestamp, and changed fields
  • Stores both old and new values (except for Added)
  • Integrates with ICurrentUser<TKey> from Levge.Identity
• ✅ HTTP Request Logging
  • Logs incoming HTTP requests and responses
  • Captures headers, body, and response details
• ✅ Cleanup Jobs
  • Scheduled cleanup of old audit and request logs
  • Configurable retention policies

Installation

Install the package via NuGet: Install-Package Levge.AuditLog Or via .NET CLI: dotnet add package Levge.AuditLog

Setup

1. Configure DbContext

   Inherit your DbContext from LevgeAuditDbContext<TKey>: public class MyDbContext : LevgeAuditDbContext<int> { public MyDbContext(DbContextOptions options, ICurrentUser<int> currentUser) : base(options, currentUser) { } }

2. Register Services

   Add the required services in your Startup.cs or Program.cs: services.AddLevgeAuditLog<MyDbContext, int>(options ⇒ { options.EnableCleanupJob = true; options.RetentionDays = 30; });

3. Middleware for Request Logging

   Add the request logging middleware to your pipeline: app.UseMiddleware<RequestLoggingMiddleware<int>>();

4. Enable Cleanup Jobs

   Ensure the cleanup jobs are registered and running: services.AddHostedService<AuditLogCleanupJob<MyDbContext, int>>(); services.AddHostedService<RequestLogCleanupJob<MyDbContext, int>>();

Usage

Entity Change Tracking

All changes to your entities (Insert, Update, Delete) will be automatically logged in the AuditLogs table. You can query the logs as follows: var logs = await dbContext.AuditLogs.ToListAsync();

HTTP Request Logging

Incoming HTTP requests and responses will be logged in the RequestLogs table. You can query the logs as follows: var requestLogs = await dbContext.RequestLogs.ToListAsync();

Configuration Options

AuditLogOptions

• EnableCleanupJob: Enables or disables the cleanup job for old audit logs.
• RetentionDays: Number of days to retain audit logs.
• CleanupTime: Time of day to run the cleanup job.

RequestLoggingOptions

• Enabled: Enables or disables HTTP request logging.
• RetentionDays: Number of days to retain request logs.
• CleanupTime: Time of day to run the cleanup job.

License

This project is licensed under the MIT License. See the LICENSE file for details.