Command Profiler

模组

· 作者 EpicPix

一个用于分析命令和函数的模组

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

最新 1.4.1+26.3-pre.2 · 26.3 · Fabric

一键开服(送7天)

Command Profiler 是一个模组,允许你使用 /cmdprof 命令对命令(commands)和函数(functions)进行性能分析。

使用分析器

如果你拥有管理员权限(operator privileges),可以使用 /cmdprof enable 命令来启动分析器。要停止收集数据,请执行 /cmdprof disable;要重置当前已分析的数据,请执行 /cmdprof reset。

查看分析结果

有三种不同的格式用于获取数据:

  1. 在控制台中显示文本(以 print 开头的子命令)
  2. 保存为 JSON 格式(以 save 开头的子命令)
  3. 保存为字节流(与 save 相同,但需要提供 bytes 作为参数)

这意味着你需要访问服务器控制台才能查看分析结果。

有 print 和 save 子命令可用于查看整个分析运行期间的总体结果。(print 按总耗时排序)

还有 print_trace 和 save_trace 子命令可用于查看最近一次捕获的 tick 内的分析结果。(按执行顺序排列)

注意:要使用这些命令查看追踪(trace)数据,你必须先启用 cmdprof:local/trace。而对于配置文件(profile)数据,你需要启用 cmdprof:local/profile,该选项默认处于启用状态。

配置分析器

你可以使用 /cmdprof config 子命令来配置分析器,目前有以下多个选项:

  • cmdprof:granularity - 设置为 command 时将对所有命令进行分析,设置为 function 时不会单独分析命令
  • cmdprof:command/macro_templates - 设置为 false 时,带有宏的命令会将其参数内联到命令中
  • cmdprof:function/line_numbers - 设置为 true 时,命令将包含其行号,而不是设为 0
  • cmdprof:local/profile,当设置为 true 时,/cmdprof print 和 /cmdprof save 可用
  • cmdprof:local/trace,当设置为 true 时,/cmdprof print_trace 和 /cmdprof save_trace 可用
  • cmdprof:memory_usage,当设置为 true 时,所有事件都会跟踪内存使用情况(这会显著降低性能,除非你正在尝试制作修复内存问题的模组,否则不建议使用)
  • cmdprof:macro/instantiations,当设置为 true 时,分析结果会将实例化宏函数所花费的时间作为一个单独的步骤列出,而不是将其合并到执行实例化的命令中
  • cmdprof:online/scoreboard - 当设置为 true 时,服务器将在启用时将记分板数据发送到在线数据页面。

在线查看数据

你可以使用 /cmdprof online view 打开在线分析器界面,并使用 /cmdprof online stop 停止它。注意,你需要先通过 /cmdprof enable 启用分析器,否则将无法提供数据。如果你想在线查看记分板数据,请执行 /cmdprof config cmdprof:online/scoreboard true。

当分析器运行时,数据会自动每秒刷新一次。记分板数据大约每个 tick 更新一次。

基准测试函数

使用 /cmdprof benchmark run <name>,你可以对一个函数或函数标签(function tag)进行基准测试。这可能需要一段时间,但在完成后,它会在聊天窗口中显示结果。你可以通过 /cmdprof benchmark cancel 取消当前正在运行的基准测试。成功的 /reload 操作会自动取消所有待处理的基准测试。被基准测试的函数是在服务器命令上下文中运行的,而不是由运行命令的玩家上下文运行。

此外,你还可以使用 /cmdprof benchmark command <command> 对单个命令进行基准测试。

注意:专门进行基准测试时,你不需要启用分析器,你可能应该执行 /cmdprof disable 以获得更准确的函数速度表现。但是,如果你希望转储(dump)结果等,可能仍希望保持分析器处于启用状态。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源