精通
英语
和
开源
,
擅长
开发
与
培训
,
胸怀四海
第一信赖
这个例子从codeproject.com上找到,对.NET Core的特性表达的充分,复杂度适中,所以推荐给大家学习,锐英源对它也录制了视频,视频费用50元。
本文内容分2部分,视频PPT前段内容和翻译内容,翻译内容从寒冰屋博客下载,对博主致谢。
部署
效果
.NET Core易用性
综合性:数据库,逻辑,通信输出
架构
通信接口
逻辑
理解后能独立写出,近中级程序员水平
数据库
appsettings.json
EnvironmentCategory
包含环境的所有类别:开发,qa和生产
细节的数据化是产品化思维的体现
会处理相关的数据表明逻辑能力有明显提高
using (var dbContext = GetServiceMonitorDbContext())
{
dbContext.ServiceCategories.Add(new ServiceCategory { Name = "Database" });
dbContext.ServiceCategories.Add(new ServiceCategory { Name = "RESTful API" });
dbContext.ServiceCategories.Add(new ServiceCategory { Name = "Server" });
一个数据库上下文对象管理所有数据表,是层级思想的体现,主项目只关心用,其它层只关注实现
这里其它层放到其它项目里,更好管理
本文介绍如何创建服务监视器应用程序,但它是什么?简单来说:它是一个允许监视网络中的服务并保存监视结果到数据库的应用程序,本例中为SQL Server。
我知道有很多工具可以提供这个功能,还有更好的工具,可以用钱买,但本文的意图是展示如何使用.NET核心能力来构建开发人员可以扩展以满足自定义要求的应用程序。
基本思想是这样的:有一个以无限方式运行的进程来监视主机,数据库和API; 将监控结果保存在SQL Server数据库中,然后我们可以为最终用户构建一个精美的UI并显示每个服务的状态,我们可以有很多目标进行监控,但最好是允许用户订阅特定服务而不是全部; 例如,DBA需要观察数据库服务器而不是API,开发人员需要观察开发数据库和API等。
还要考虑在开发室中安装大型显示器并观察服务状态,并且最好的情况是使用图表。:)
一个特殊功能可能是让一个通知服务在一个或多个服务失败的情况下为所有管理员发送消息,在这种情况下,服务意味着目标,如主机,数据库,API。
在本文中,我们将使用以下服务进行监控:
名称 |
描述 |
主机 |
Ping现有主机 |
数据库 |
打开并关闭现有数据库的连接 |
RESTful API |
从现有API中获取一个操作 |
正如我们之前所说,我们将创建一个应用程序来监视现有目标(主机,数据库,API),因此我们需要掌握有关这些概念的基本知识。
主机将使用ping操作进行监控,因此我们将添加与网络相关的包以执行此操作。
数据库将通过开放和关闭连接进行监视,不使用集成安全性,因为您需要使用凭据模拟服务监视器进程,因此在这种情况下,最好让特定用户与数据库连接,并且只有这样才能避免黑客攻击。
RESTful API将使用REST客户端进行监视,以定位返回简单JSON的操作。
在存储库内部,有一个名为\ Resources \ Database的目录,该目录包含相关的数据库文件,请确保按以下顺序运行以下文件:
文件名 |
描述 |
00 - Database.sql |
数据库定义 |
01 - Tables.sql |
表定义 |
02 - Constraints.sql |
约束(主键,外键和唯一性) |
03 - Rows.sql |
初始数据 |
我们可以在这里找到数据库脚本。
表说明 |
|
表 |
描述 |
EnvironmentCategory |
包含环境的所有类别:开发,qa和生产 |
ServiceCategory |
包含服务的所有类别:数据库,rest API,服务器,URL和Web服务 |
Service |
包含所有服务定义 |
ServiceWatcher |
包含C#端的所有组件以执行监视操作 |
ServiceEnvironment |
包含服务和环境的关系,例如我们可以定义一个以不同环境命名的FinanceService服务:开发,qa和生产 |
ServiceEnvironmentStatus |
包含每个环境的每个服务的状态 |
ServiceEnvironmentStatusLog |
包含每个服务环境状态的详细信息 |
Owner |
包含代表所有所有者的应用程序的用户列表 |
ServiceOwner |
包含服务和所有者之间的关系 |
User |
包含观看服务的所有用户 |
ServiceUser |
包含服务和用户之间的关系 |
请不要忘记我们正在使用在本地计算机上运行的解决方案,资源目录中有一个示例API来执行测试,但您需要更改连接字符串并根据您的上下文添加服务。
另外我不建议在ServiceEnvironment表中公开真实的连接字符串,请向您的DBA请求单个用户只能对目标数据库执行打开连接,以防数据库的安全性成为您的任务,创建特定的用户来执行仅打开与数据库的连接并防止泄露敏感信息。
现在我们需要为此解决方案定义项目,以获得有关项目范围的清晰概念:
项目名 |
类型 |
描述 |
ServiceMonitor.Core |
类库 |
包含与数据库存储相关的所有定义 |
ServiceMonitor.Common |
类库 |
包含ServiceMonitor项目的常见定义,例如观察者,序列化器和客户端(REST) |
ServiceMonitor.WebApi |
Web API |
包含Web API控制器,用于读取和写入有关监视的信息 |
ServiceMonitor |
控制台应用 |
包含监控所有服务的过程 |
该项目包含实体和数据库访问的所有定义,因此我们需要为项目添加以下包:
名称
版
描述
Microsoft.EntityFrameworkCore.SqlServer
最新版本
通过EF Core提供对SQL Server的访问
该项目包含三个层次:业务逻辑,数据库访问和实体。
DashboardService 类代码:
using System;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Logging;
using ServiceMonitor.Core.BusinessLayer.Contracts;
using ServiceMonitor.Core.BusinessLayer.Responses;
using ServiceMonitor.Core.DataLayer;
using ServiceMonitor.Core.DataLayer.DataContracts;
using ServiceMonitor.Core.EntityLayer;
namespace ServiceMonitor.Core.BusinessLayer
{
public class DashboardService : Service, IDashboardService
{
public DashboardService(ILogger<DashboardService> logger, ServiceMonitorDbContext dbContext)
: base(logger, dbContext)
{
}
public async Task<IListResponse<ServiceWatcherItemDto>> GetActiveServiceWatcherItemsAsync()
{
Logger?.LogDebug("'{0}' has been invoked", nameof(GetActiveServiceWatcherItemsAsync));
var response = new ListResponse<ServiceWatcherItemDto>();
try
{
response.Model = await DbContext.GetActiveServiceWatcherItems().ToListAsync();
Logger.LogInformation("The service watch items were loaded successfully");
}
catch (Exception ex)
{
response.SetError(Logger, nameof(GetActiveServiceWatcherItemsAsync), ex);
}
return response;
}
public async Task<IListResponse<ServiceStatusDetailDto>> GetServiceStatusesAsync(string userName)
{
Logger.LogDebug("'{0}' has been invoked", nameof(GetServiceStatusesAsync));
var response = new ListResponse<ServiceStatusDetailDto>();
try
{
var user = await DbContext.GetUserAsync(userName);
if (user == null)
{
Logger.LogInformation("There isn't data for user '{0}'", userName);
return new ListResponse<ServiceStatusDetailDto>();
}
else
{
response.Model = await DbContext.GetServiceStatuses(user).ToListAsync();
Logger?.LogInformation("The service status details for '{0}' user were loaded successfully", userName);
}
}
catch (Exception ex)
{
response.SetError(Logger, nameof(GetServiceStatusesAsync), ex);
}
return response;
}
public async Task<ISingleResponse<ServiceEnvironmentStatus>> GetServiceStatusAsync(ServiceEnvironmentStatus entity)
{
Logger.LogDebug("'{0}' has been invoked", nameof(GetServiceStatusAsync));
var response = new SingleResponse<ServiceEnvironmentStatus>();
try
{
response.Model = await DbContext.GetServiceEnvironmentStatusAsync(entity);
}
catch (Exception ex)
{
response.SetError(Logger, nameof(GetServiceStatusAsync), ex);
}
return response;
}
}
}
IWatcher 接口代码:
IWatchResponse 接口代码:
ISerializer 接口代码:
这些是实现:
DatabaseWatcher 类代码:
HttpWebRequestWatcher 类代码:
PingWatcher 类代码:
这个项目代表服务监视器的RESTful API,所以我们将有两个控制器:DashboardController和AdministrationController。仪表板具有与最终用户结果相关的所有操作,管理包含与保存信息(创建,编辑和删除)相关的所有操作。
DashboardController 类代码:
AdministrationController 类代码:
这个项目包含Service Monitor Client的所有对象,在这个项目中,我们添加了Newtonsoft.Json用于JSON序列化的包,在ServiceMonitor.Common中有一个名称为ISerializer的接口,因为我不想强制使用特定的序列化程序,你可以改变它在这个层。:)
ServiceMonitorSerializer 类代码:
接下来,我们将开始MonitorController类,在这个类中,我们将执行所有观察操作,并通过Service Monitor API 中的AdministrationController将所有结果保存在数据库中。
MonitorController 类代码:
在运行控制台应用程序之前,请确保以下方面:
我们可以检查url api/v1/Dashboard/ServiceWatcherItems的返回值:
正如我们所看到的,API为DefaultUser返回所有服务,请记住关于一个用户可以订阅多个服务的概念,显然在此示例中,我们的默认用户被绑定到所有服务但我们可以在ServiceUser表中更改此链接。
Program 类代码:
一旦我们检查了之前的方面,现在我们继续转向控制台应用程序,控制台输出是这样的:
现在我们继续检查数据库中保存的数据,请检查ServiceEnvironmentStatus表,你会得到这样的结果:
它是如何一起工作的?控制台应用程序从API中监视所有服务,然后在MonitorController中以无限循环的方式为每个监视项启动一个任务,每个任务都有一个延迟时间,该间隔在服务定义中设置,但是如果没有为间隔定义值,间隔取自AppSettings; 因此,在执行Watch操作之后,结果将通过API保存在数据库中,并且该过程会自行重复。如果要watch对其他类型执行操作,可以创建自己的Watcher类。