Sejil 1.0.0-beta3

Sejil

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
• Features and Screenshots
• Building
• License

Getting started

1. Installing Sejil package

   Install-Package -IncludePrerelease Sejil
   

2. Adding code

   For ASP.net Core 1.x.x, add below code to Program.cs:

   public static void Main(string[] args)
   {
       var host = new WebHostBuilder()
           .AddSejil("/sejil", LogLevel.Debug)
           // ...
   }
   

   For ASP.net core 2.x.x, add below code to Program.cs:

   public static IWebHost BuildWebHost(string[] args) =>
       WebHost.CreateDefaultBuilder(args)
           .AddSejil("/sejil", LogLevel.Debug)
           // ...
   

   Add below code to Startup.cs

   using Sejil;
   
   public class Startup
   {    
       public void Configure(IApplicationBuilder app, IHostingEnvironment env)
       {
           app.UseSejil();
           // ...
       }
   }
   

3. Navigate to http://your-app-url/sejil to view your app's logs.

Features and Screenshots

• View your app's logs

  <img src="./assets/001-screenshot-main_opt.jpg" width="800">

• View properties specific to a certain log entry

  <img src="./assets/002-screenshot-properties_opt.jpg" width="800">

• Query your logs

  <img src="./assets/003-screenshot-query_opt.jpg" width="800">

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

  <img src="./assets/004-screenshot-query-and-filter_opt.jpg" width="800">

• Save your queries for later use

  <img src="./assets/005-screenshot-save-query_opt.jpg" width="800">

• Load your saved queries

  <img src="./assets/006-screenshot-load-query_opt.jpg" width="800">

Building

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

git clone https://github.com/alaatm/Sejil.git
cd ./Sejil
./build.ps1  # If running Windows
./build.sh   # If running Linux/OSX

You can run one of the sample apps afterwards, Sample1.0 targets netcoreapp1.1 while Sample2.0 targets netcoreapp2.0:

cd ./sample/Sample2.0
dotnet run

License

Copyright © Alaa Masoud.

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