服务脉搏

服务脉搏

ServicePulse 为分布式应用程序提供实时生产监控。它监视系统端点的运行状况，检测处理错误，发送失败消息进行重新处理，并确保满足特定环境的需求，所有这些都在一个整合的仪表板中完成。

ServicePulse 是特定服务平台的一部分，其中包括 NServiceBus 以及用于构建、监控和调试分布式系统的工具。

有关更多信息，请参阅 ServicePulse 文档。

设置开发项目

设置 ServiceControl Main 和 ServiceControl Monitoring 实例

ServicePulse主要呈现ServiceControl和ServiceControl监控实例提供的数据。

这两个服务的 URL 都可以在src/Frontend/public/js/app.constants.js中设置。

设置包管理器

ServicePulse 使用 npm 和 Bower 作为包管理器。为了使解决方案发挥作用，必须在启动 ServicePulse 网站之前下载依赖项。

安装依赖项

如果尚未安装以下依赖项，请安装它们。

• 适用于 Windows 的 Git
• Node.js
  • 注意：在本地环境中安装或更新 Node.js 时，最好检查并确保ci.yml和release.yml工作流的 Node.js 版本与本地环境的版本匹配。查找步骤name: Set up Node.js

设置开发环境

步骤 0 - 使用合适的 IDE 进行前端开发

尽管 Visual Studio 或 Rider 似乎是适合前端开发的 IDE，但它们对于最新的前端框架、linting 和格式往往不可靠。因此，我们提供了额外的建议来帮助您在前端开发方面取得更大的成功。

第 1 步 - 运行 Vue.js 开发服务器

导航到ServicePulsesrcFrontend并：

• 运行npm install以安装所有 npm 依赖项
• 运行以下命令npm run dev （这将在端口 5173 上托管一个开发服务器并开始监视/Frontend目录中的更改）

如果npm run dev失败并出现与未正确配置 git 子模块相关的错误，请再次运行npm install命令以确保所有必需的依赖项均可用，然后运行npm run dev 。

第 2 步 - 打开浏览器

完成上述步骤后，导航到 Vue.js 应用程序执行时显示的 URL 以查看 ServicePulse 应用程序。

运行自动化测试

前端自动化测试利用 Vitest 作为测试框架和测试实用程序的测试库。 Vitest默认提供两种模式：开发环境下的watch mode和CI环境下的run mode 。 Watch mode在文件保存后立即重新运行相关测试，在开发过程中提供即时反馈。

在运行测试之前，请确保您已设置开发服务器。导航到ServicePulsesrcFrontend并运行npm install以安装所有 npm 依赖项。

运行组件测试

导航到ServicePulsesrcFrontend并运行：

 npm run test:component

此命令运行目录ServicePulsesrcFrontendsrc及其子目录中的所有组件测试文件*.spcs.ts 。启用watch mode后，它可以实现高效的测试开发，因为只有相关测试才会在文件保存时重新运行。

运行应用程序测试

导航到ServicePulsesrcFrontend并运行：

 npm run test:application

与组件测试类似，此命令运行目录ServicePulsesrcFrontendtest及其子目录中的所有应用程序测试文件*.spcs.ts 。

运行测试覆盖率

导航到ServicePulsesrcFrontend并运行：

 npm run test:coverage

此命令生成一个报告，指示测试覆盖的语句、分支、函数和行的百分比。此外，它还可以识别未覆盖的行号。

提供npm脚本

Vue.js

• dev - 运行vite来启动开发服务器对源文件进行热重载
• build - 运行构建脚本，将文件输出到..app文件夹
• lint - 使用 eslint 检查所有 vue、ts 和 js 文件
• type-check - 在无发出模式下运行 TypeScript

维泰斯特

• test:application - 运行位于Frontend/test文件夹中的所有应用程序测试。
• test:component - 运行测试位于Frontend/src文件夹和任何子目录中的所有组件测试。
• test:coverage - 对vitest.config.ts中定义的文件运行测试覆盖率报告

从 ServicePulse.Host.exe 运行

可以通过ServicePulse.Host.exe直接运行 ServicePulse。

第 1 步 - 保留 URL ACL

ServicePulse.Host.exe 依赖于自托管 Web 服务器。在项目运行之前，必须设置 URL ACL 预留。使用管理权限运行 Visual Studio 或运行以下命令来添加所需的 URL ACL 预留：

add urlacl url=URL

其中URL是本地计算机上配置的 URL。

第 2 步 - 构建 ServicePulse 站点

从命令行执行构建脚本：

 PowerShell -File .build.ps1

笔记

可能需要使用Set-ExecutionPolicy Unrestricted -scope UserPolicy更改 PowerShell 执行策略

第 3 步 - 运行ServicePulse.Host.exe

在 IDE 中构建并运行ServicePulse.Host项目。

支持的浏览器版本

以下桌面浏览器版本支持 ServicePulse：

• Chrome 最新主要版本
• Edge 与 EdgeHTML v17+
• Firefox ESR 当前版本
• Safari 最新主要版本

容器镜像开发

ServicePulse 的 Dockerfile 位于src/ServicePulse文件夹中。容器镜像都是作为发布工作流程的一部分构建的，并暂存在 Github 容器注册表中。对于有 PR 的分支，图像将标有 PR 编号，例如pr-1234 。