追踪子弹

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

功能简介

TraceBullet 与您的服务器并行运行，持续收集性能和游戏内指标，通过 OTLP 导出，使您能够可视化趋势、设置告警，并在玩家注意到问题之前捕获异常。

采集的指标

指标	说明
TPS	刻耗时直方图 — 查看服务器在完整分布区间（而非仅平均值）的表现
在线玩家数	随时间变化的在线玩家数量
区块数量	每个维度的已加载区块数
实体数量	每个维度的实体数量
世界保存耗时	每个维度世界保存耗时的直方图
计划刻队列	每个维度的待处理方块刻与流体刻队列大小 — 卡顿的前兆指标
区块生成	每个维度新生成区块的数量，区分高成本的生成与低成本的磁盘加载

安装指南

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

每次发布均包含一个 **Grafana 仪表板**，方便快速上手。

配置

所有选项均在 NeoForge 模组配置文件中可用（tracebullet-common.toml）：

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

维基

在维基上可找到入门指南、所有指标列表及配置说明：
https://github.com/korti11/tracebullet/wiki