Skip to content
/ Sejil Public

Capture, view and filter your ASP.net core log events right from your app

License

Notifications You must be signed in to change notification settings

alaatm/Sejil

Repository files navigation

Sejil

Build NuGet

Sejil is a library that enables you to capture, view and filter your ASP.net core app's log events right from your app. It supports structured logging, querying as well as saving log event queries.

Quick Links

Getting started

  1. Installing Sejil package

    dotnet add package Sejil --version 3.0.4
  2. Adding code

    Add below code to Program.cs:

    public static IWebHost BuildWebHost(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .UseSejil()  // <-- Add this line
            .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>());            

    Add below code to Startup.cs

    using Sejil;
    
    public class Startup
    {    
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            // ...
            app.UseSejil();  // <-- Add this line
            // ...
        }
    }

    (Optional) To require authentication for viewing logs:

        public void ConfigureServices(IServiceCollection services)
        {
            services.ConfigureSejil(options =>
            {
                options.AuthenticationScheme = /* Your authentication scheme */
            });
        }

    (Optional) To change the logs page title (Defaults to Sejil if not set):

        public void ConfigureServices(IServiceCollection services)
        {
            services.ConfigureSejil(options =>
            {
                options.Title = "My title";
            });
        }
  3. Navigate to http://your-app-url/sejil to view your app's logs.

Additional logging configuration

  • If you want to enable loggers registered through the Microsoft.Extensions.Logging API. Specify true to the writeToProviders parameter:

    public static IWebHost BuildWebHost(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .UseSejil(writeToProviders: true)
            .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>());            
  • If you want to enable other Serilog sinks, use the sinks parameter to do that. For exmaple, the following code adds the console Serilog sink:

    public static IWebHost BuildWebHost(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .UseSejil(sinks: sinks =>
            {
                sinks.Console();
            }
            .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>());            
  • You can use Serilog's configuration to specifiy minimum log level overrides for certain namespaces. For example, to limit logging from Microsoft.AspNetCore to Warning:

    {
        "Serilog": {
            "MinimumLevel": {
                "Override": {
                    "Microsoft.AspNetCore": "Warning"
                }
            }
        },
        "AllowedHosts": "*"
    }    

Filtering logs

In addition to filtering logs by level; exceptions only; and date range via the UI, you can also search by text to filter your logs:

  • To filter logs by a specific search term, just type it in the search box and hit enter. If the search term contains spaces or any of the following =, !, (, ) then make sure to enclose it in double quotes.

    Examples:

    AboutController
    "some message"
    "ZGFzZGE="
    
  • To filter logs by a specific property, use the following pattern:

    • property-name [ = | != | like | not like ] search-term

      Examples:

      SourceContext = 'Microsoft.AspNetCore.Hosting.Internal.WebHost'
      SourceContext like '%Hosting%'
      StatusCode = 200
  • You can combine multiple search expressions with and or and use ( ) for precedence.

    Examples:

    StatusCode like '%' and StatusCode != 200   -- Get all logs that contain a 'StatusCode' property and that the property value does not equal 200.    

Features and Screenshots

  • View your app's logs

  • View properties specific to a certain log entry

  • Query your logs

  • Mix multiple filters with your query to further limit the results

  • Save your queries for later use

  • Load your saved queries

Building

To build the project, you just need to clone the repo then run the following commands:

git clone https://github.com/alaatm/Sejil.git
cd ./Sejil
dotnet tool restore
dotnet cake

You can run one of the sample apps afterwards:

cd ./sample/SampleBasic
dotnet run

License

License

Copyright © Alaa Masoud.

This project is provided as-is under the Apache 2.0 license. For more information see the LICENSE file.