.NET 开源实时监控体系 - WatchDog
前言在平时的开发中随着我们体系应用不断地迭代变的复杂，对应用的实时监控变得越来越重要。实时监控不仅可以帮助我们快速定位题目，还能在出现题目时及时采取措施，减少业务中断的时间。
本文将介绍一个名为WatchDog的.NET开源实时应用监控体系，它可以帮助我们轻松实现对.NET应用的实时监控。
项目介绍
WatchDog是一个开源（MIT License）、免费的实时应用监控体系，专为ASP.NET Core Web应用程序和API计划。我们可以实时记载和查看应用程序中的消息、事件、HTTP哀求和相应，以及运行时捕获的异常。
一个高效的监控体系不仅能进步应用的可用性和可靠性，还能帮助我们更快地办理题目。WatchDog是一款专为.NET应用计划的开源实时应用监控体系，它提供了一系列强盛的功能来帮助我们监控应用的状态和性能。
https://img2024.cnblogs.com/blog/576536/202408/576536-20240826000428512-1388516627.png
功能特点
[*]实时日志记载：可以大概实时记载HTTP哀求、相应以及运行时捕获的异常。
[*]代码内日志记载：支持在代码中记载消息和事件。
[*]日志视图查看：提供易于利用的日志查看界面。
[*]日志搜索功能：支持对HTTP哀求和异常日志进行搜索。
[*]HTTP日志筛选：可根据HTTP方法和状态码筛选HTTP日志。
[*]日志视图认证：提供日志视图的访问权限控制。
[*]自动日志清理：支持自动清除旧的日志记载。
[*]报警通知：支持通过邮件、短信等多种方式发送报警通知，确保可以大概及时得到反馈。
[*]机动配置：可以根据应用需求进行机动的配置，顺应不同的监控需求。
[*]易于集成：通过简朴的API调用即可集成到现有的.NET应用中。
项目技术栈
[*]后端：基于.NET Core 或 .NET 5及以上版本。
[*]前端：利用 React 或 Angular等前端框架搭建的用户界面。
[*]数据库：支持MySQL、PostgreSQL等关系型数据库，以及MongoDB等NoSQL数据库。
[*]官方支持 .NET 8：新增对 .NET 8 的官方支持。
[*].NET 8 中的 Output Cache 支持：增长了对 .NET 8 中利用 Output Cache 的支持。
[*]利用正则表达式黑名单：新增了利用正则表达式进行黑名单过滤的功能。
工作原理
WatchDog 利用 SignalR 实现了实时监控，并利用LiteDb作为无需配置的类似MongoDB的服务器端数据库，同时也支持利用外部数据库（如MSSQL、MySQL、PostgreSQL、MongoDB）。
1、支持.NET版本
.NET Core 3.1 及更高版本。
2、下载源码
通过下载源码，可以进行学习和应用，详细操纵如下图所示：
https://img2024.cnblogs.com/blog/576536/202408/576536-20240826000605183-1782123077.png
安装与配置
1、WatchDog 安装
搜索 WatchDog.NETNuGet包进行安装，详细如下图所示：
https://img2024.cnblogs.com/blog/576536/202408/576536-20240826000551803-1149807395.png
<img alt="">2、WatchDog 服务注册
在ASP.NET Core Web API 的Program.cs或 Startup.cs中注册 WatchDog 服务。
从ILogger 记载日志到 WatchDog
还可以将来自.NET的ILogger的日志记载到 WatchDog 中。
适用于 .NET 6 及以上版本
builder.Services.AddWatchDogServices(opt =>
{
opt.IsAutoClear = true;
opt.ClearTimeSchedule = WatchDogAutoClearScheduleEnum.Monthly;
opt.DbDriverOption = WatchDogDbDriverEnum.Mongo;
opt.SetExternalDbConnString = "mongodb://localhost:27017";
});
builder.Logging.AddWatchDogLogger();对于 .NET Core 3.1
在 Program.cs 类的 CreateHostBuilder 方法中配置日志记载，并添加 .AddWatchDogLogger()。
Host.CreateDefaultBuilder(args)
.ConfigureLogging( logging =>
{
logging.AddWatchDogLogger();
})
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup<Startup>();
});3、添加异常记载器
在主要的WatchDog中间件之前添加异常日志记载器，最好将其放置在中间件的最上面，以便捕获大概的早期异常。
app.UseWatchDogExceptionLogger();
...
app.UseWatchDog(opt =>
{
opt.WatchPageUsername = "admin";
opt.WatchPagePassword = "Qwerty@123";
...
});4、设置自动清除日志（可选）
该功能可在特定时间后自动清除日志。
注意：当IsAutoClear设置为true时，默认的清除筹划时间为每周。
如需覆盖默认设置，请按照以下方式进行配置：
services.AddWatchDogServices(opt =>
{
opt.IsAutoClear = true;
opt.ClearTimeSchedule = WatchDogAutoClearScheduleEnum.Monthly;
});5、设置日志记载到外部数据库（可选）
将日志记载到数据库，如SQL Server (MSSQL)、MySQL、PostgreSQL 或 MongoDB，可以根据需求配置。
[*]添加数据库毗连字符串：提供数据库的毗连字符串。
[*]选择数据库驱动选项：根据所利用的数据库类型选择合适的驱动程序。
services.AddWatchDogServices(opt =>
{
opt.IsAutoClear = true;
opt.SetExternalDbConnString = "Server=localhost;Database=testDb;
User Id=postgres;Password=root;";
opt.DbDriverOption = WatchDogDbDriverEnum.PostgreSql;
});6、设置访问日志的账号暗码
app.UseWatchDog(opt =>
{
opt.WatchPageUsername = "admin";
opt.WatchPagePassword = "Qwerty@123";
});注意：如果你的项目利用权限验证，那么 app.UseWatchDog(); 应该在 app.UseRouting(), app.UseAuthentication(), 和 app.UseAuthorization() 之后按顺序添加。
7、配置说明和示例
[*]黑名单：要忽略的路由、路径或端点列表（应为逗号分隔的字符串，如下所示）。
[*]序列化器：如果不利用默认的全局 JSON 序列化器/转换器，请指定类型。
[*]CORS策略：如果项目利用了跨源资源共享（CORS），请指定策略名称。
[*]利用Output缓存：如果项目利用了ASP.NET Output缓存。功能仅适用于 .NET 8 及以上版本。
[*]利用正则表达式黑名单：启用利用正则表达式来黑名单化哀求路由、路径或端点。
示例配置
app.UseWatchDog(opt =>
{
opt.WatchPageUsername = "admin";
opt.WatchPagePassword = "Qwerty@123";
//Optional
opt.Blacklist = "Test/testPost, api/auth/login";
//Prevent logging for specified endpoints
opt.Serializer = WatchDogSerializerEnum.Newtonsoft;
//If your project use a global json converter
opt.CorsPolicy = "MyCorsPolicy";
opt.UseOutputCache = true;
opt.UseRegexForBlacklisting = true;
});8、记载消息/事件
WatchLogger.Log("...Test Log...");
WatchLogger.LogWarning(JsonConvert.Serialize(model));
WatchLogger.LogError(res.Content, eventId: reference);9、查看日志和异常
启动服务器并访问 /watchdog 来查看日志。
示例：
https://myserver.com/watchdog
https://localhost:/watchdog项目效果
1、WatchDog登录
https://img2024.cnblogs.com/blog/576536/202408/576536-20240826000616044-620086039.png
<img alt="">2、WatchDog 日志
https://img2024.cnblogs.com/blog/576536/202408/576536-20240826000610819-290977633.png
<img alt="">3、哀求日志
https://img2024.cnblogs.com/blog/576536/202408/576536-20240826000622483-922049654.png
<img alt="">4、消息/事件
https://img2024.cnblogs.com/blog/576536/202408/576536-20240826000632068-514733386.png
<img alt="">项目地址
Github：https://github.com/IzyPro/WatchDog
总结
WatchDog 是一款强盛且易于利用的.NET开源实时应用监控体系。通过利用WatchDog，我们可以轻松实现对.NET应用的实时监控，进步应用的稳固性和可靠性。渴望这篇文章可以大概帮助你更好地明白和利用WatchDog。
末了
如果你觉得这篇文章对你有帮助，不妨点个赞支持一下！你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助，欢迎随时留言。
也可以加入微信公众号 社区，与其他热爱技术的同行一起交流心得，共同成长！
https://img2024.cnblogs.com/blog/576536/202408/576536-20240814113403514-910171896.png
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]