Hangfire.HttpJob 心跳与进程监控指南：CPU/内存/磁盘利用率实时可视化

Hangfire.HttpJob 心跳与进程监控指南：CPU/内存/磁盘利用率实时可视化

【免费下载链接】Hangfire.HttpJobhttpjob for Hangfire,restful api for Hangfire,job调度与业务分离项目地址: https://gitcode.com/gh_mirrors/ha/Hangfire.HttpJob

Hangfire.HttpJob 是围绕 Hangfire 打造的 HTTP 任务调度框架，核心设计理念是"job 调度与业务分离"。它不仅能通过 RESTful API 管理常规作业和周期性作业，还内置了一套完整的心跳与进程监控能力：调度端与 Agent 端实时上报进程状态，让你在 Hangfire Dashboard 上就能直观看到CPU 利用率、内存占用、磁盘可用空间的实时曲线。本文将用通俗易懂的方式，带你从零掌握 Hangfire.HttpJob 心跳监控的开启方法、工作机制与配置技巧。

为什么你需要心跳与进程监控

任务调度系统最怕"静默失败"：作业挂掉了、服务器宕机了、Agent 失联了，你却毫无察觉。Hangfire.HttpJob 的进程监控与心跳机制解决了三个核心痛点：

• 🔍调度端状态可视：服务进程的 CPU/内存/磁盘占用一目了然，方便评估资源是否吃紧
• 🫀Agent 失联检测：周期性作业依赖的 Agent 是否在线，通过心跳实时判定
• 📊运维决策有据：磁盘可用空间、内存水位等指标，为扩容与告警提供数据支撑

数据采集由后台进程自动完成，写入存储后由 Dashboard 轮询渲染，全程无需人工干预。

心跳监控的数据流转机制

理解"数据从哪来、存到哪、怎么展示"，是掌握心跳监控的关键。整个链路分三步：

1. 采集：ProcessMonitor（服务端）与HeartBeatReport（Agent 端）分别采集所在进程的 CPU、内存、磁盘指标
2. 存储：数据序列化后写入 JobStorage 的 Hash 中（键名为utilization:{serverId}与AgentHeart:{serverId}），并设置过期时间避免脏数据堆积
3. 展示：Dashboard 的/heartbeat页面通过/heartbeat/stats接口轮询读取并渲染图表

核心实现分别位于 ProcessMonitor.cs 与 Heartbeat.cs，两者共用一套采集逻辑：CPU 通过两次采样TotalProcessorTime差值计算并除以核心数，内存取WorkingSet64工作集，磁盘则取进程可执行文件所在盘符的AvailableFreeSpace。

一键开启心跳监控：两步配置

开启流程极简，只需要在服务端配置两行代码：

// 第一步：启用心跳仪表盘页面 config.UseHeartbeatPage(); // 第二步：启动 HttpJob 全组件（内部会自动启动心跳服务） config.UseHangfireHttpJob(options);

• UseHeartbeatPage()注册/heartbeat页面、导航菜单与统计数据接口，见 ConfigurationExtensions.cs
• UseHangfireHttpJob()内部会调用JobAgentHeartBeatServer.Start()自动启动 Agent 心跳检测服务，见 GlobalConfigurationExtension.cs

配置完成后重启应用，打开 Hangfire Dashboard，导航菜单中就会出现Heartbeat入口。

CPU/内存/磁盘利用率实时可视化

点击导航栏的 Heartbeat 即可进入进程监控总览页。该页面以轮询方式每 1 秒刷新一次（默认间隔），以表格和图表形式展示各服务器的：

• CPU 利用率：基于进程总 CPU 时间差值与核心数计算，保留 1 位小数
• 内存占用：进程工作集内存 WorkingSet，直观反映内存水位
• 磁盘可用空间：可执行文件所在磁盘分区的剩余容量
• 最近心跳时间：辅助判断数据是否新鲜

页面与接口的实现位于 OverviewPage.cs，统计数据的序列化与轮询间隔由 HeartbeatDashboardOptions.cs 控制。

💡 数据的 Hash 键过期时间约为检查间隔加 1 分钟（见ProcessMonitor中_expireIn），因此你看到的始终是"最近一分钟内"的活跃服务器，挂掉的进程会自动从列表消失。

心跳检查间隔的最快配置方法

默认 1 秒一次的检查频率对多数场景足够，但如果你希望降低存储写入压力，或需要更精细的监控粒度，可以通过构造函数传入自定义间隔：

// 每 5 秒采集一次 config.UseHeartbeatPage(TimeSpan.FromSeconds(5)); // 或传入完整选项 config.UseHeartbeatPage(new HeartbeatDashboardOptions(TimeSpan.FromSeconds(5)));

服务端的进程监控频率同样可以调整：ProcessMonitor提供了默认构造（1 秒）与带参构造（自定义间隔）两种方式，配置类见 HeartbeatProcessMonitorOptions.cs。注意检查间隔必须为正数，否则会抛出参数异常。

Agent 心跳上报机制详解

这是 Hangfire.HttpJob 与普通 Hangfire 监控最大的不同点——Agent 心跳由调度端主动拉取：

1. 调度端每 5 秒扫描周期性作业，找出所有带AgentClass的 AgentJob，解析出 Agent 地址
2. 向 Agent 发送带x-job-agent-action: heartbeat标识的 HTTP 请求，携带存储连接串与调度端标识
3. Agent 收到请求后启动本地心跳器：每 1 秒上报一次自身进程指标，并将存活窗口重置为 30 分钟
4. 调度端收到响应中的agentServerId后，将 Agent 标记为活跃并记录心跳时间

这套机制的实现集中在 JobAgentHeartBeatServer.cs，Agent 端的采集与上报逻辑在 Heartbeat.cs。若 Agent 超过 10 秒未上报，调度端即判定其为失联（Error 状态），Dashboard 中会以红色警示图标标出。

心跳失联的排查与调优建议

如果你发现 Dashboard 中 Agent 长时间显示"Waiting"或红色异常，可按以下顺序排查：

• ✅ 确认 Agent 服务已启动，且端口可从调度端访问
• ✅ 检查 Agent 作业配置中的Url、BasicUserName、BasicPassword是否正确
• ✅ 确认调度端与 Agent 均连接到同一个 JobStorage
• ✅ 检查心跳 Hash 的过期时间：Agent 端数据过期时间约 1 分钟，若网络抖动频繁可适当增大调度端检测间隔
• ✅ 查看日志中是否有send agent heartbeat fail错误信息，定位网络或鉴权问题

总结

Hangfire.HttpJob 把"任务调度"与"业务执行"彻底分离，同时用一套轻量而完整的心跳与进程监控机制，让调度端和 Agent 端的 CPU、内存、磁盘利用率全部实时可视。无论是排查 Agent 失联，还是评估服务器资源水位，你都可以在/heartbeat页面一站式搞定。开启它只需两行配置，强烈建议在生产环境中默认启用，让每一次调度都有据可查、有迹可循。

【免费下载链接】Hangfire.HttpJobhttpjob for Hangfire,restful api for Hangfire,job调度与业务分离项目地址: https://gitcode.com/gh_mirrors/ha/Hangfire.HttpJob