【庫】用Rin透視Web請求

Rin 可以捕獲對 ASP.NET Core 應用程式的 HTTP 請求，並為捕獲的數據提供檢視器。它是偵錯 Web 應用程式（例如，網站、API 套用）的有用工具。

先看如下程式碼：

var builder = WebApplication.CreateBuilder(args);builder.Logging.AddRinLogger();builder.Services.AddRin();builder.Services.AddHttpClient();var app = builder.Build();app.UseRin();app.UseRinDiagnosticsHandler();var summaries = new[]{"Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"};app.MapGet("/weatherforecast", () =>{var forecast = Enumerable.Range(1, 5).Select(index =>new WeatherForecast ( DateOnly.FromDateTime(DateTime.Now.AddDays(index)), Random.Shared.Next(-20, 55), summaries[Random.Shared.Next(summaries.Length)] )) .ToArray();return forecast;});app.MapPost("/weatherforecast", (WeatherForecast weather) =>{return weather;});app.MapPut("/weatherforecast", (WeatherForecast weather) =>{return weather;});app.MapDelete("/weatherforecast", (int id) =>{returntrue;});app.MapGet("/weather", async (IHttpClientFactory clientFactory) =>{var lat = "35.71459525981295";var lon = "139.7989249730396";var apiKey = "6d43c019aa2aeb0e7dd5ce070f174248";var client = clientFactory.CreateClient();var url = $"https://api.openweathermap.org/data/2.5/forecast?lat={lat}&lon={lon}&appid={apiKey}"; Console.WriteLine(url);var response = await client.GetAsync(url);return response.Content.ReadAsStringAsync();});app.Run();internal record WeatherForecast(DateOnly Date, int TemperatureC, string? Summary){public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);}

Rin是內建的，執行起程式後，只需要換成/rin，就可以存取具體請求資訊，這點非常方便，輕巧。如下圖，是get請求的相關資訊。

Request基本資訊：

Response基本資訊：

Timleline：這是區分了Processing和Transferring兩個事件。

上面是get請求的三個Tab資訊。post，put，delete等其他型別請求類似，下圖是post的請求，增加了請求body資訊。

可能你覺得，如果只有這麽簡單，那直接用Postman等客戶端工具也是可以的。當然，是可以的，但Rin不僅如此，還可以對Web內部對第三方的請求也給記錄下來。

下圖是在Timeline，在Proccessing和Transferring增加Trace，來清晰地表示客戶端一個請求，後端的呼叫鏈路。

具體的Trace可以參看Trace的Tab，這裏清晰地說明了4個Trace分別對應的Start processing HTTP Request，Sending HTTP request，Received HTTP response，End procession HTTP request。

Rin很輕量，建議在偵錯時用，在生產環境上，有專業的日誌，監控和鏈路跟蹤系統，並不需要。雖然Rin已有兩年沒有更新，但它的輕量，容用，基本能滿足我們的需求了。