上一篇博文中說(shuō)到Prometheus有四種指標(biāo)類型：Counter（計(jì)數(shù)器）、Gauge（儀表盤）、Histogram（直方圖）、Summary（摘要），并且我們做了一個(gè)Counter的Demo，接下來(lái)看看Histogram。

3、Histogram：直方圖

直方圖，維基百科的定義：是一種對(duì)數(shù)據(jù)分布情況的圖形表示，是一種二維統(tǒng)計(jì)圖表，它的兩個(gè)坐標(biāo)分別是統(tǒng)計(jì)樣本和該樣本對(duì)應(yīng)的某個(gè)屬性的度量，以長(zhǎng)條圖（bar）的形式具體表現(xiàn)。因?yàn)橹狈綀D的長(zhǎng)度及寬度很適合用來(lái)表現(xiàn)數(shù)量上的變化，所以較容易解讀差異小的數(shù)值。

還是拿上一篇的Sample來(lái)說(shuō)明，假如每個(gè)訂單都有一個(gè)金額，在order時(shí)在返回值{result=true,data=1000}的data屬性中返回，這里，我們就可以用直方圖來(lái)收集這個(gè)金額，由于訂單的金額不一樣，我們就可以用直方圖來(lái)展示一定范圍金額內(nèi)訂單的數(shù)據(jù)，監(jiān)控出一定金額范圍內(nèi)的訂單比例了。就是說(shuō)在一定數(shù)量的訂單里，少于1000元的有多少個(gè)訂單，少于2000元有多少個(gè)訂單，少于3000元的有多少個(gè)訂單……

首先，我們得修改BusinessController中Order Action的業(yè)務(wù)邏輯，把訂單金額作為返回值：

[HttpGet("/order")]public IActionResult Order(string orderno){try{_logger.LogInformation("下單");//返回訂單金額var random = new Random();return new JsonResult(new { Result = true, data = random.Next(1, 8000) });}catch (Exception exc){_logger.LogCritical(exc, exc.Message);return new JsonResult(new{Result = false,Message = exc.Message});}}

這里的金額為了方便demo，是隨機(jī)生成一個(gè)1到8000的隨機(jī)數(shù)。

需要在MetricsHub.cs中添加Histogram類型的指標(biāo)收集集合：

using Prometheus; using System.Collections.Generic;namespace PrometheusSample.Middlewares {public class MetricsHub{private static Dictionary<string, Counter> _counterDictionary = new Dictionary<string, Counter>();private?static?Dictionary<string,?Dictionary<string,?Gauge>>?_gaugeDictionary?=?new?Dictionary<string,?Dictionary<string,?Gauge>>();private?static?Dictionary<string,?Histogram>?_histogramDictionary?=?new?Dictionary<string,?Histogram>();public Counter GetCounter(string key){if (_counterDictionary.ContainsKey(key)){return _counterDictionary[key];}else{return null;}}public Dictionary<string, Gauge> GetGauge(string key){if (_gaugeDictionary.ContainsKey(key)){return _gaugeDictionary[key];}else{return null;}}public Histogram GetHistogram(string key){if (_histogramDictionary.ContainsKey(key)){return _histogramDictionary[key];}else{return null;}}public void AddCounter(string key, Counter counter){_counterDictionary.Add(key, counter);}public void AddGauge(string key, Dictionary<string, Gauge> gauges){_gaugeDictionary.Add(key, gauges);}???public void AddHistogram(string key, Histogram histogram){_histogramDictionary.Add(key, histogram);}} }

接下來(lái)就要在BusinessMetricsMiddleware的中間件中添加處理Histogram指標(biāo)的代碼了：

using Microsoft.AspNetCore.Http; using PrometheusSample.Models; using System.IO; using System.Threading.Tasks;namespace PrometheusSample.Middlewares {/// <summary>/// 請(qǐng)求記錄中間件/// </summary>public class BusinessMetricsMiddleware{private readonly RequestDelegate _next;public BusinessMetricsMiddleware(RequestDelegate next){_next = next;}public async Task InvokeAsync(HttpContext context, MetricsHub metricsHub){var originalBody = context.Response.Body;try{using (var memStream = new MemoryStream()){//從管理返回的Response中取出返回?cái)?shù)據(jù)，根據(jù)返回值進(jìn)行監(jiān)控指標(biāo)計(jì)數(shù)context.Response.Body = memStream;await _next(context);memStream.Position = 0;string responseBody = new StreamReader(memStream).ReadToEnd();memStream.Position = 0;await memStream.CopyToAsync(originalBody);if (metricsHub.GetCounter(context.Request.Path) != null || metricsHub.GetGauge(context.Request.Path) != null){//這里約定所有action返回值是一個(gè)APIResult類型var result = System.Text.Json.JsonSerializer.Deserialize<APIResult>(responseBody, new System.Text.Json.JsonSerializerOptions { PropertyNameCaseInsensitive = true });if (result != null && result.Result){//獲取到Countervar counter = metricsHub.GetCounter(context.Request.Path);if (counter != null){//計(jì)數(shù)counter.Inc();}var gauges = metricsHub.GetGauge(context.Request.Path);if (gauges != null){//存在增加指標(biāo)+就Incif (gauges.ContainsKey("+")){gauges["+"].Inc();} //存在減少指標(biāo)-就Decif (gauges.ContainsKey("-")){gauges["-"].Dec();}}var histogram = metricsHub.GetHistogram(context.Request.Path);if (histogram != null){var parseResult = int.TryParse(result.Data.ToString(), out int i);if (parseResult){histogram.Observe(i);}}}}}}finally{context.Response.Body = originalBody;}}} }

再就是在Starsup中配置對(duì)應(yīng)url的Histogram參數(shù)了：

using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using Microsoft.OpenApi.Models; using Prometheus; using PrometheusSample.Middlewares; using PrometheusSample.Services;using System.Collections.Generic;namespace PrometheusSample {public class Startup{public Startup(IConfiguration configuration){Configuration = configuration;}public IConfiguration Configuration { get; }public void ConfigureServices(IServiceCollection services){MetricsHandle(services);services.AddScoped<IOrderService, OrderService>();services.AddControllers();services.AddSwaggerGen(c =>{c.SwaggerDoc("v1", new OpenApiInfo { Title = "PrometheusSample", Version = "v1" });});}public void Configure(IApplicationBuilder app, IWebHostEnvironment env){if (env.IsDevelopment()){app.UseDeveloperExceptionPage();app.UseSwagger();app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "PrometheusSample v1"));}app.UseRouting();//http請(qǐng)求的中間件app.UseHttpMetrics();app.UseAuthorization();//自定義業(yè)務(wù)跟蹤app.UseBusinessMetrics();app.UseEndpoints(endpoints =>{//映射監(jiān)控地址為 /metricsendpoints.MapMetrics();endpoints.MapControllers();});}/// <summary>/// 處理監(jiān)控事項(xiàng)/// </summary>/// <param name="services"></param>void MetricsHandle(IServiceCollection services){var metricsHub = new MetricsHub();//countermetricsHub.AddCounter("/register", Metrics.CreateCounter("business_register_user", "注冊(cè)用戶數(shù)。"));metricsHub.AddCounter("/order", Metrics.CreateCounter("business_order_total", "下單總數(shù)。"));metricsHub.AddCounter("/pay", Metrics.CreateCounter("business_pay_total", "支付總數(shù)。"));metricsHub.AddCounter("/ship", Metrics.CreateCounter("business_ship_total", "發(fā)貨總數(shù)。"));//gaugevar orderGauge = Metrics.CreateGauge("business_order_count", "當(dāng)前下單數(shù)量。");var payGauge = Metrics.CreateGauge("business_pay_count", "當(dāng)前支付數(shù)量。");var shipGauge = Metrics.CreateGauge("business_ship_count", "當(dāng)前發(fā)貨數(shù)據(jù)。");metricsHub.AddGauge("/order", new Dictionary<string, Gauge> {{ "+", orderGauge}});metricsHub.AddGauge("/pay", new Dictionary<string, Gauge> {{"-",orderGauge},{"+",payGauge}});metricsHub.AddGauge("/ship", new Dictionary<string, Gauge> {{"+",shipGauge},{"-",payGauge}});?????????//histogram???????????var orderHistogram = Metrics.CreateHistogram("business_order_histogram", "訂單直方圖。",new HistogramConfiguration{Buckets = Histogram.LinearBuckets(start: 1000, width: 1000, count: 5)});metricsHub.AddHistogram("/order",?orderHistogram);services.AddSingleton(metricsHub);}} }

Histogram.LinearBuckets(start: 1000, width: 1000, count: 5)是金額從1000開始，每1000為一個(gè)臺(tái)階，一共6個(gè)臺(tái)階：0~1000，1001~2000，2001~3000，3001~4000，4001~5000，還有一個(gè)是大于5000的。

最后一步，就是打開Grafana來(lái)配置展示圖表了。

訂單金額分布圖

訂單比例分布圖

圖中histogram_quantile(0.80, sum(rate(business_order_histogram_bucket[5m])) by (le))的意思是“80%的訂單金額小于等于這個(gè)值”5分鐘內(nèi)的值。

最終展示結(jié)果：

聰明的你一定發(fā)現(xiàn)，這篇博文與上一篇如出一轍，是的，只是監(jiān)控指標(biāo)展示類型不同而以。

總結(jié)

以上是生活随笔為你收集整理的asp.net core监控—引入Prometheus（四）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。