EonaCat.Web.Tracer 2.0.2

EonaCat.Web.Tracer

EonaCat Web Tracer is a middleware to log every Http request/response to a database for tracing.

Make sure to set the username and the password for the dashboard:

WebTracerMiddleware.DashboardUsername = "admin";
WebTracerMiddleware.DashboardPassword = "traces";

To add the Middleware use the following code:

Configure method in the Startup.cs file:

app.UseWebTracer();

Add Razor View Locations in Startup.cs (or Program.cs for .NET 6+): You need to tell the framework to look for Razor Pages in the library. This can be done by adding the following in the ConfigureServices method of Startup.cs or Program.cs:

services.AddRazorPages()
        .AddApplicationPart(typeof(DashboardController).Assembly);

Ensure Razor Pages are Available in the Application: In the Configure method of your Startup.cs (or Program.cs), make sure that you enable Razor Pages routing:

app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages(); // To map Razor Pages from the library
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Index}/{action=Index}/{id?}");
});

ConfigureServices method in the Startup.cs file:

services.AddWebTracer();

As a default the database is located at the current directory of the executable in the folder named 'EonaCat.Web.Tracer'

The following eventhandlers are available:

OnException OnSuspiciousActivityDetected OnHighResponseLatency OnRateLimited

To use the eventhandlers you need to add the following code:

WebTracerMiddleware.OnException += (sender, args) =>
{
    // Your code here
};

WebTracerMiddleware.OnSuspiciousActivityDetected += (sender, args) =>
{
    // Your code here
};

WebTracerMiddleware.OnHighResponseLatency += (sender, args) =>
{
    // Your code here
};

WebTracerMiddleware.OnRateLimited += (sender, args) =>
{
    // Your code here
};

You also have syslog support so you can send the logs to a syslog server.

You can add a syslog server by adding the following code:

WebtracerMiddleware.AddSyslogServer(new SyslogServerConfig 
{ 
    Host = "localhost",         // optional (default: "localhost"))
    Port = 514,                 // optional (default: 514))
    IsEnabled = true,           // optional (default: false))
    Facility = "user",          // optional (default: "user"))
    IsTcp = true,               // optional (default: false))
    MaxUdpPacketSize = 1400,    // optional (default: 1400)))
});

You could also send to a syslog server by adding the following code:

WebtracerMiddleware.SyslogServers = new List<SyslogServerConfig>
{
    new SyslogServerConfig("localhost", 514, isEnabled: true)
};

To remove a syslog server you can use the following code:

WebtracerMiddleware.RemoveSyslogServer("localhost", 514);