Popularity
3.6
Stable
Activity
2.2
-
265
14
15

Description

Rin captures HTTP requests to ASP.NET Core app and provides viewer for captured data. It's useful tool to debug your Web application (e.g. Web sites, API apps).

Programming language: C#
License: MIT License
Tags: Performance     Profiler     AspNetCore    
Latest version: v2.5.1

Rin alternatives and similar packages

Based on the "Profiler" category.
Alternatively, view Rin alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Rin or a related project?

Add another 'Profiler' Package

README

Rin

Request/response Inspector middleware for ASP.NET Core. like Glimpse.

Build-Release Build-Development NuGet version

Rin captures HTTP requests to ASP.NET Core app and provides viewer for captured data. It's useful tool to debug your Web application (e.g. Web sites, API apps).

[](docs/images/Demo-01.gif)

โœ… Features

Capture requests and responses

Rin captures HTTP traffics between the ASP.NET Core app and any clients.

  • Headers + Body
  • Traces (Microsoft.Extensions.Logging.ILogger, log4net, ...)
  • Unhandled Exception

Inspect from Web browser in realtime

View events timeline

Rin inspector displays events that occurred while processing a request.

[](docs/images/Screenshot-02.png)

Preview a request/response body

Rin inspector can display request and response body with a preview. (e.g. JSON, Image, HTML, JavaScript ...)

[](docs/images/Screenshot-03.png)

View related trace logs

Rin captures a request and response. Also, it captures logs while processing a request.

  • Built-in Microsoft.Extensions.Logging.ILogger integration
  • log4net Appender

Save and export request/response

You can replay a request easily using cURL and LINQPad.

  • Save request/response body
  • Copy request as cURL and C#

Integrate with ASP.NET Core MVC

  • Record timings of view rendering and action execution
  • In-View Inspector (like MiniProfiler)

[](docs/images/Screenshot-04.png)

๐Ÿ“ Requirements

  • .NET Core 3.1+
  • ASP.NET Core 3.1+
  • Modern browser (e.g. Microsoft Edge, Google Chrome, Firefox, Safari...)
    • WebSocket connectivity

โšก QuickStart

Install NuGet Package

Using Visual Studio

Dependencies -> Manage NuGet Packages... -> Search and install Rin and Rin.Mvc (if your project is built with ASP.NET Core MVC) package.

Using dotnet command

dotnet add package Rin
dotnet add package Rin.Mvc

Using Package Manager

Install-Package Rin
Install-Package Rin.Mvc

Setup and configure Rin

Program.cs

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .ConfigureLogging(configure =>
        {
            // Add: Enable Rin Logger
            configure.AddRinLogger();
        })
        .UseStartup<Startup>();

Startup.cs

public class Startup
{
    ...
    public void ConfigureServices(IServiceCollection services)
    {
        ...
        services.AddControllersWithViews()
            // Add(option): Enable ASP.NET Core MVC support if the project built with ASP.NET Core MVC
            .AddRinMvcSupport();        

        // Add: Register Rin services
        services.AddRin();
    }
    ...
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        if (env.IsDevelopment())
        {
            // Add: Enable request/response recording and serve a inspector frontend.
            // Important: `UseRin` (Middlewares) must be top of the HTTP pipeline.
            app.UseRin();

            // Add(option): Enable ASP.NET Core MVC support if the project built with ASP.NET Core MVC
            app.UseRinMvcSupport();

            app.UseDeveloperExceptionPage();

            // Add: Enable Exception recorder. this handler must be after `UseDeveloperExceptionPage`.
            app.UseRinDiagnosticsHandler();
        }
        ...
    }
}

_Layout.cshtml (for ASP.NET Core MVC)

@inject Rin.Mvc.View.RinHelperService RinHelper
...
    <environment include="Development">
        <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" />
        <link rel="stylesheet" href="~/css/site.css" />
        @* Add: Enable In-View Inspector for ASP.NET Core MVC *@
        @RinHelper.RenderInViewInspector()
    </environment>
...

Start the application and open Inspector on the web

Launch the app, then open http://[Host:Port]/rin/ in the browser, you can see Rin Inspector now.

๐Ÿ”จ Develop and build Rin Inspector (client side)

Rin Inspector (client side) codes is separated from Rin core C# project. If you want to develop Rin (C#) or launch a sample project, you need to build and deploy the artifacts.

[Rin.Frontend, Rin.Mvc.Frontend] Setup and start the development server

  • yarn
  • yarn start

[Rin.Frontend] Build Rin/Resources.zip

  • yarn build
  • yarn pack

[Rin.Mvc.Frontend] Build Rin.Mvc/EmbeddedResources

  • yarn build
  • copy .\dist\static\main.js* ..\Rin.Mvc\EmbeddedResources\

License

[MIT License](LICENSE)


*Note that all licence references and agreements mentioned in the Rin README section above are relevant to that project's source code only.