Trace Bullet

模组

· 作者 korti

通过 OpenTelemetry 将 Minecraft 服务器指标(TPS、玩家数量、区块数量和实体数量)导出到任何兼容 OTLP 的可观测性后端。

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

最新 0.1.2 · 26.1.2 · NeoForge

一键开服(送7天)

Trace Bullet Logo

使用 OpenTelemetry 为你的 Minecraft 服务器进行插桩,并将实时指标导出到任何兼容 OTLP 的可观测性平台。

功能说明

TraceBullet 与你的服务器并行运行,持续收集性能和游戏数据指标,并通过 OTLP 协议导出,以便你可视化趋势、设置警报,并在玩家察觉之前发现问题。

收集的指标

指标 描述
TPS Tick 时间直方图 — 了解服务器在整个分布范围内的性能表现,而不仅仅是平均值
玩家数量 随时间变化的在线玩家数
区块数量 每个维度中已加载的区块数量
实体数量 每个维度中的实体数量
世界保存耗时 每个维度每次世界保存所需时间的直方图
计划 Tick 队列 每个维度中待处理的方块和流体 Tick 队列大小 — 延迟的前兆指标
区块生成 每个维度中新生成的区块数量,区分高成本的生成操作与低成本的磁盘读取

安装步骤

  1. 将模组 JAR 文件放入 mods/ 文件夹(无需其他模组 — OpenTelemetry 已内置)
  2. 启动服务器一次以生成配置文件
  3. 在配置文件中设置你的 OTLP 端点 URL 和服务名称
  4. 将你的可观测性栈指向该端点并开始收集数据

每个版本都包含一个 **Grafana 仪表板**,可作为开箱即用的起点。

配置

所有选项均可在 NeoForge 模组配置 (tracebullet-common.toml) 中找到:

  • OTLP 端点 URL
  • 服务名称
  • 自定义资源属性
  • 各指标的启用/禁用开关
  • 线程池大小设置

Wiki

在 Wiki 上获取入门指南、所有指标列表及配置说明:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源