
使用 OpenTelemetry 为你的 Minecraft 服务器进行插桩,并将实时指标导出到任何兼容 OTLP 的可观测性平台。
功能说明
TraceBullet 与你的服务器并行运行,持续收集性能和游戏数据指标,并通过 OTLP 协议导出,以便你可视化趋势、设置警报,并在玩家察觉之前发现问题。
收集的指标
| 指标 |
描述 |
| TPS |
Tick 时间直方图 — 了解服务器在整个分布范围内的性能表现,而不仅仅是平均值 |
| 玩家数量 |
随时间变化的在线玩家数 |
| 区块数量 |
每个维度中已加载的区块数量 |
| 实体数量 |
每个维度中的实体数量 |
| 世界保存耗时 |
每个维度每次世界保存所需时间的直方图 |
| 计划 Tick 队列 |
每个维度中待处理的方块和流体 Tick 队列大小 — 延迟的前兆指标 |
| 区块生成 |
每个维度中新生成的区块数量,区分高成本的生成操作与低成本的磁盘读取 |
安装步骤
- 将模组 JAR 文件放入
mods/ 文件夹(无需其他模组 — OpenTelemetry 已内置)
- 启动服务器一次以生成配置文件
- 在配置文件中设置你的 OTLP 端点 URL 和服务名称
- 将你的可观测性栈指向该端点并开始收集数据
每个版本都包含一个 **Grafana 仪表板**,可作为开箱即用的起点。
配置
所有选项均可在 NeoForge 模组配置 (tracebullet-common.toml) 中找到:
- OTLP 端点 URL
- 服务名称
- 自定义资源属性
- 各指标的启用/禁用开关
- 线程池大小设置
Wiki
在 Wiki 上获取入门指南、所有指标列表及配置说明:

Instrument your Minecraft server with OpenTelemetry and export real-time metrics to any OTLP-compatible observability platform.
What It Does
TraceBullet runs alongside your server and continuously collects performance and gameplay metrics, exporting them via OTLP so you can visualize trends, set up alerts, and catch problems before your players notice.
Metrics Collected
| Metric |
Description |
| TPS |
Tick time histogram — see how your server performs across the full distribution, not just the average |
| Player Count |
Online player count over time |
| Chunk Count |
Loaded chunk count per dimension |
| Entity Count |
Entity count per dimension |
| World Save Duration |
Histogram of how long each world save takes per dimension |
| Scheduled Tick Queue |
Pending block and fluid tick queue size per dimension — a leading indicator of lag |
| Chunk Generation |
Count of newly generated chunks per dimension, distinguishing expensive generation from cheap disk loads |
Setup
- Drop the mod JAR into your
mods/ folder (no other mods required — OpenTelemetry is bundled)
- Start the server once to generate the config file
- Set your OTLP endpoint URL and service name in the config
- Point your observability stack at the endpoint and start collecting
A **Grafana dashboard** is included in each release for a ready-to-use starting point.
Configuration
All options are available in the NeoForge mod config (tracebullet-common.toml):
- OTLP endpoint URL
- Service name
- Custom resource attributes
- Per-metric enable/disable toggles
- Thread pool sizing
Wiki
Find a getting start guide, a list of all metrics and configuration on the wiki:
评论 0
登录后参与评分
还没有评论,来抢沙发吧