NaNTech.MongoDB.ULog 1.1.0.4

ULog Integration

ULog is a library that uses MongoDb to store both HTTP and manual logs in your database. It's straightforward to use and integrate into your .NET project.

Installation

To integrate ULog into your .NET project, add the following line:

builder.Services.AddULogger(connectionString, options, queueCount);

Configuration

The options object is of type ULogOptions and takes the following default values:

public class ULogOptions
{
    public string[] Claims { get; set; } = [ClaimTypes.Name];
    public string ManualLogDbName { get; set; } = "logs";
    public string HttpLogDbName { get; set; } = "httplogs";
    public string ManualCollectionName { get; set; } = DateTime.Now.Date.ToString("yyyy-MM-dd");
    public string HttpCollectionName { get; set; } = DateTime.Now.Date.ToString("yyyy-MM-dd");
}

The queueCount parameter determines how many logs are queued, with a default value of 2000.

It's recommended to specify the Claims section yourself when add IoT.

For Http logging you should add :

[ULog]

attribute above action or controller.

UI Usage

To use the ULog UI, add the following line to your setup:

app.UseULoggerUI();

Navigate to localhost/ULog/index.html to view your logs in a table format.

Example

Here's a simple example to get you started:

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddULogger("your-connection-string", new ULogOptions
{
    Claims = "your-claims-for-user",
    ManualLogDbName = "your-logs-db",
    HttpLogDbName = "your-httplogs-db",
    ManualCollectionName = "your-manual-collection",
    HttpCollectionName = "your-http-collection"
}, 2000);

var app = builder.Build();

app.UseULoggerUI();

app.Run();

Conclusion

ULog provides a simple and efficient way to manage logs in your .NET application using MongoDb. By following the above steps, you can quickly set up and start using ULog in your projects.

Thank you for using ULog! If you encounter any issues or have questions, feel free to reach out.