基于.NetCore开发博客项目 StarBlog - (16) 一些新功能 (监控/统计/配置/初始化)
系列文章
基于.NetCore开发博客项目 StarBlog - (1) 为什么需要自己写一个博客？ 基于.NetCore开发博客项目 StarBlog - (2) 环境准备和创建项目 基于.NetCore开发博客项目 StarBlog - (3) 模型设计 基于.NetCore开发博客项目 StarBlog - (4) markdown博客批量导入 基于.NetCore开发博客项目 StarBlog - (5) 开始搭建Web项目 基于.NetCore开发博客项目 StarBlog - (6) 页面开发之博客文章列表 基于.NetCore开发博客项目 StarBlog - (7) 页面开发之文章详情页面 基于.NetCore开发博客项目 StarBlog - (8) 分类层级结构展示 基于.NetCore开发博客项目 StarBlog - (9) 图片批量导入 基于.NetCore开发博客项目 StarBlog - (10) 图片瀑布流 基于.NetCore开发博客项目 StarBlog - (11) 实现访问统计 基于.NetCore开发博客项目 StarBlog - (12) Razor页面动态编译 基于.NetCore开发博客项目 StarBlog - (13) 加入友情链接功能 基于.NetCore开发博客项目 StarBlog - (14) 实现主题切换功能 基于.NetCore开发博客项目 StarBlog - (15) 生成随机尺寸图片 基于.NetCore开发博客项目 StarBlog - (16) 一些新功能 (监控/统计/配置/初始化)
前言
最近好几天都忙着写代码，没更新文章，近期给博客增加了一些功能，本文一次性介绍~
新增的功能如下：
系统监控：sentry、exceptionless、CLRStats 访问统计 配置管理 初始化
系统监控
PS：其实前面两篇关于日志收集工具介绍的文章也是为了给本文做铺垫
系统监控这块包括日志收集、性能监测和系统状态监测。
日志收集和性能监测我交给了ExceptionLess和Sentry，这俩开源的工具可以很好的完成这些工作，详情可以看我之前写的这俩篇文章：
然后状态监测我是基于GitHub上的一个开源项目来魔改的：CLRStats
这个组件可以实时查看CPU、GC、线程的状态，不过原版的实现是作为一个中间件嵌入AspNetCore项目，并且访问的地址只能用Basic认证，不适用。
于是我把代码clone下来之后魔改了一下，变成一个可以调用的服务，并且重新写了API接口，终于方便起来了~
这个接口拿到的数据是这样的，后续在管理后台里面做成可视化图表也比较方便。
{
"server": {
"machineName": "machineName",
"systemDateTime": "7/26/2022 11:30:22 PM"
},
"application": {
"cpu": {
"usagePercent": 0
},
"gc": {
"gen0CollectCount": 24,
"gen1CollectCount": 23,
"gen2CollectCount": 22,
"heapMemory": 38328872,
"heapMemoryFormat": "36 M",
"isServerGC": true
},
"thread": {
"availableCompletionPortThreads": 1000,
"availableWorkerThreads": 32766,
"usedCompletionPortThreads": 0,
"usedWorkerThreads": 1,
"usedThreadCount": 29,
"maxCompletionPortThreads": 1000,
"maxWorkerThreads": 32767
}
}
}
具体代码就不复制粘贴了，我把它放在StarBlog.Contrib项目中，作为一个独立的组件方便调用。
访问统计
虽然前面这篇文章有介绍访问统计的实现：基于.NetCore开发博客项目 StarBlog - (11) 实现访问统计
不过只是单纯讲了通过中间件实现访问记录，这些数据存在数据库之后并没有被利用起来
现在就实现了一些简单的统计，目前主要实现了总览数据（总访问、今日、昨日访问）、趋势数据、指定日期统计，这几个功能。
逻辑代码在StarBlog.Web/Services/VisitRecordService.cs中
总览数据代码在这
PS：我发现FreeSQL的ISelect对象在链式操作时候的行为很奇怪，我知道是懒加载，但是已经执行了
.Count()似乎还没执行，下一行调用的代码甚至会把前面的筛选条件加上，无奈我之内在方法内又写了一个嵌套的方法……也就是这个
GetQuerySet，这点让我这种用习惯DjangoORM的人觉得很不适应 = =..
这个接口计算总访问量、今日访问量、昨日访问量，方便做对比（受知乎的创作者中心启发）
public object Overview() {
ISelect<VisitRecord> GetQuerySet() => _repo.Where(a => !a.RequestPath.StartsWith("/Api"));
return new {
TotalVisit = GetQuerySet().Count(),
TodayVisit = GetQuerySet().Where(a => a.Time.Date == DateTime.Today).Count(),
YesterdayVisit = GetQuerySet().Where(a => a.Time.Date == DateTime.Today.AddDays(-2).Date).Count(),
};
}
趋势数据
也就是统计最近n天的访问量
PS：C#的日期处理还是比较舒服的
public object Trend(int days = 7) {
return _repo.Where(a => !a.RequestPath.StartsWith("/Api"))
.Where(a => a.Time.Date > DateTime.Today.AddDays(-days).Date)
.GroupBy(a => a.Time.Date)
.ToList(a => new {
time = a.Key,
date = $"{a.Key.Month}-{a.Key.Day}",
count = a.Count()
});
}
按日期统计
这个简单粗暴不用多说
public object Stats(DateTime date) {
var data = _repo.Where(a => a.Time.Date == date.Date && !a.RequestPath.StartsWith("/Api"));
return new { Count = data.Count() };
}
注意这里面所有的统计我都过滤了以/Api开头的地址，因为我只需要统计博客前台的访问量就行了。
配置管理
博客还是有很多需要配置的东西，比如说Host
之前我是写在appsettings.json文件里的，按理说也可以，修改这文件之后也能hot reload，不过问题是没法实现在管理后台中修改并保存
所以我打算实现一个配置管理的功能
一开始是把目光瞄准了KV数据库，甚至要求找一个嵌入式的、C#实现的开源项目，叠了这么多buff，果然没找到合适的
(不过前几天好像看到有个大佬发了篇文章介绍用C#手写一个KV数据库的，大赞！)
于是还是用博客本身的数据来实现好了，也不难
老规矩，继续写Service：StarBlog.Web/Services/ConfigService.cs
这里只把关键代码放出来，完整代码可以看GitHub
public class ConfigService {
private readonly IConfiguration _conf;
private readonly IBaseRepository<ConfigItem> _repo;
public ConfigItem? GetByKey(string key) {
var item = _repo.Where(a => a.Key == key).First();
if (item == null) {
// 尝试读取初始化配置
var section = _conf.GetSection($"StarBlog:Initial:{key}");
if (!section.Exists()) return null;
item = new ConfigItem { Key = key, Value = section.Value, Description = "Initial" };
item = AddOrUpdate(item);
}
return item;
}
public ConfigItem AddOrUpdate(ConfigItem item) {
return _repo.InsertOrUpdate(item);
}
public int? Update(string key, string value, string? description = default) {
var item = GetByKey(key);
if (item == null) return null;
item.Value = value;
if (description != null) item.Description = description;
return _repo.Update(item);
}
public string this[string key] {
get {
var item = GetByKey(key);
return item == null ? "" : item.Value;
}
set {
var item = GetByKey(key) ?? new ConfigItem { Key = key };
item.Value = value;
AddOrUpdate(item);
}
}
}
这个ConfigService实现了索引器，可以比较方便的实现配置的读取和保存
比如这样
var conf = xxx; // 注入 ConfigService
// 读取配置
Console.WriteLine(conf["host"]);
// 修改配置
conf["host"] = "http://dealiaxy.com";
同时我也写了几个接口，可以通过HTTP的方式管理配置，代码就不放了~
初始化
在我的设计中，这个功能是依赖于配置管理的
所以把配置管理做完之后，我的初始化页面也做出来了
看起来是这样的
也就是首次运行本项目的时候，会进入这个页面，目前的初始化配置就只有创建管理、设置Host两个，后续应该会慢慢增加其他的
后台是通过is_init这个字段来判断是否有初始化的
直接上Controller代码
[HttpGet]
public IActionResult Init([FromServices] ConfigService conf) {
if (conf["is_init"] == "true") {
_messages.Error("已经完成初始化！");
return RedirectToAction(nameof(Index));
}
return View(new InitViewModel {
Host = conf["host"]
});
}
[HttpPost]
public IActionResult Init([FromServices] ConfigService conf, [FromServices] IBaseRepository<User> userRepo, InitViewModel vm) {
if (!ModelState.IsValid) return View();
// 保存配置
conf["host"] = vm.Host;
conf["is_init"] = "true";
// 创建用户
// todo 这里暂时存储明文密码，后期要换成MD5加密存储
userRepo.Insert(new User {
Id = Guid.NewGuid().ToString(),
Name = vm.Username,
Password = vm.Password
});
_messages.Success("初始化完成！");
return RedirectToAction(nameof(Index));
}
同时还要实现一个View页面，这个就比较简单，代码不放了