Maykesh's Server Observability Framework

模组

· 作者 pz.labs

一个适用于 Minecraft 1.21 的综合服务器可观测性框架。以极低的开销监控刻时间、实体更新、区块加载、网络数据包等。非常适合用于调试、优化和限流系统。

0 本站下载 0 关注 更新于 4 个月前

需要前置:Fabric API

最新 1.0.0 · 1.21 · Fabric

一键开服(送7天)

? Maykesh 的服务器可观测性框架(Freemium • Beta)

专为 Fabric 1.21 服务器构建的正式可观测性与遥测框架。
此 Freemium 模块对完整的 Minecraft 服务器运行时进行仪器化监控,并为开发者提供结构化的遥测数据,用于构建优化工具、诊断工具、调试实用程序或速率限制系统。它提供了统一的资源归因、模块化收集器和中央遥测总线,以实现深入的服务器内省——且完全不改变游戏玩法。


⚠️ 当前构建状态(Freemium‑Beta)

此构建为 Freemium‑Beta,包含:

  • 基础指标,
  • 核心收集器,
  • 遥测总线,
  • 命令,
  • 配置系统,
  • 暂无 GUI。

Freemium‑Release 版本(预计时间:约 3 天)将引入一个基本的、极简的功能性 GUI,旨在用于简单的收集器切换和基本指标查看。

Premium 和 Ultra‑Premium 版本将具备更高级、更有序且功能显著更强的 UI,旨在用于深度分析和生产级可观测性。


? 外部链接

在 CurseForge 上可供下载:

CurseForge 评论 / 反馈:


⚠️ 许可与再分发

本项目依据 CC BY‑NC‑SA 4.0 许可协议授权。

如果此模组被编辑、修改、扩展或重新分发,衍生作品必须:

  • 免费提供,
  • 发布在 Github 上,
  • 保持开源,
  • 同时署名 Maykesh 和 PhaseZero Labs,
  • 包含指向原始 Modrinth 项目页面的链接,
  • 不得用于商业用途,
  • 遵守许可协议的所有其他条款。

任何衍生版本必须明确声明其为分支版本,并直接链接到此原始 Modrinth 页面。


⚠️ 推荐须知

此 freemium 版本非常适合开发、测试、诊断和轻量级可观测性场景。

不建议高级服务器管理员使用,
也不建议需要全规模分析、生产级导出器或深入运行时工具的高级玩家使用。

Premium Edition(包含强大的 UI、扩展的导出器和更深入的分析工具)计划于 1–4 周内发布。
高级用户应等待 Premium 版本以获得最佳体验。


? 为何使用此框架?

  • ? 完整的运行时仪器化监控 — 观察.tick 循环、实体更新、区块活动、数据包流、异步任务、调度器队列、世界生成事件等。
  • ? 模块化收集器系统 — 16 个收集器,每个均可通过配置文件或命令独立切换。
  • ? 结构化遥测输出 — 通过 JSON 文件或内存缓冲区导出统一指标。
  • ? 遥测总线 API — 其他模组可以订阅实时事件,以构建自定义工具和集成。
  • ? 基于命令的管理 — 在游戏中直接启用、禁用、重载、测试和检查收集器。
  • ?️ 零游戏玩法变更 — 纯诊断性质;无机制改动、无平衡调整、无面向玩家的影响。
  • ? 仅限 Fabric 1.21 — 专门为 1.21 运行时及其更新的 API 设计。
  • ? Freemium 层级 — 包含核心收集器、遥测、命令和配置系统。
    Premium 功能(高级 UI、扩展的导出器、更深入的分析工具)不包含在此版本中。

✨ 功能

? 核心可观测性

  • Tick 循环仪器化监控 — 监控 tick 持续时间和子系统成本。
  • 实体更新 — 跟踪更新负载和行为指标。
  • 区块加载 — 观察加载/卸载操作和内存压力。
  • 数据包发送/接收 — 检查入站/出站数据包的频率。
  • 方块与红石更新 — 识别更新密集区域。
  • 世界生成事件 — 跟踪世界生成队列活动。
  • 事件总线活动 — 检测模组/插件的事件泛滥。
  • 线程池与异步任务 — 监控后台工作负载。
  • 调度器队列 — 检查延迟任务和计划任务。
  • 寻路与库存操作 — 将成本归因于高影响系统。
  • 命令执行 — 分析命令处理过程。
  • 异常检测 — 检测尖峰、洪水和失控循环。

?️ 配置与控制

  • 热重载 — 无需重启服务器即可应用配置更改。
  • 权限系统 — 完全可配置的 OP 等级要求。
  • 配置文件
    • config/runtime-profiler.json
    • config/runtime-profiler-permissions.json

? 命令界面

  • /profiler help — 显示所有命令和收集器
  • /profiler list — 查看收集器状态
  • /profiler enable <collector> — 启用收集器
  • /profiler disable <collector> — 禁用收集器
  • /profiler toggle <collector> — 切换收集器
  • /profiler reload — 重载配置
  • /profiler metrics — 显示统一资源指标
  • /profiler test collectors — 运行诊断测试

? 适用对象

  • 正在构建优化工具的开发者
  • 诊断和调试环境
  • 速率限制和反垃圾邮件系统
  • 监控仪表板和数据分析管道
  • 早期阶段开发和测试

不建议高级服务器管理员或高级玩家使用。
推荐使用 Premium Edition(1–4 周内发布)。

? 需求

  • Minecraft 1.21
  • Fabric Loader 0.15.11+
  • Fabric API 0.100.8+1.21
  • Java 21
  • 仅限 Fabric — 不支持 Quilt、Forge 或 NeoForge

? 关于 PhaseZero Labs

由 Maykesh 在 PhaseZero Labs (pz.labs) 旗下开发,
该组织结合人类专业知识与 AI 辅助工具,以加速复杂 Minecraft 模组的开发、测试和优化工作流。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源