Open Telemetry Instrumentation Extension Mod FAQ
10 questions players actually ask, answered.
How do I start collecting metrics after installing the mod?
Install the OpenTelemetry Java Agent on your server, then add this mod and the Fabric helper extension to your mods folder. Start your server—it will automatically begin sending telemetry data to your configured OpenTelemetry collector endpoint or cloud monitoring account.
What's the difference between TPS and MSPT and why do I need both?
TPS (ticks per second) shows how many game ticks your server completes each second, while MSPT (milliseconds per tick) measures how long each individual tick takes. Together they reveal whether lag is caused by the server struggling to process ticks or by something else slowing the overall tick rate.
Can I monitor individual player stats like experience and levels?
Yes, but you need to enable it first. Set `metrics.enable-player-details-samplers` to true in your configuration to start tracking per-player metrics like experience, levels, and world location.
How do I reduce CPU usage from metric collection?
Enable `metrics.freeze-when-server-paused` to stop sampling when the server is idle, and use `metrics.enabled-only` to collect only the specific metrics you actually need instead of everything.
What should I set my metrics prefix to?
Set `metrics.prefix` to something that identifies your server or environment, like `minecraft_survival_` or `production_`. This makes it easier to organize and filter your metrics in Grafana when monitoring multiple servers.
Does this mod work with other performance monitoring mods like spark?
Yes, the mod can optionally connect with spark to gather additional diagnostic details beyond what OpenTelemetry collects alone, giving you a more complete picture of server performance.
Why are some of my metrics not showing up in Grafana?
Check whether you've disabled them in the config using `metrics.disabled`, or if you're using `metrics.enabled-only` and forgot to include them in that list. You may also need to verify that your OpenTelemetry collector is actually receiving and forwarding the data.
Can I track entities by dimension and type?
Yes, the mod automatically groups entities by type, ground status, and dimension, so you can see exactly where mobs are spawning and how many are loaded in each world.
What does 'strip-identifier-namespaces' do and when should I use it?
When set to true, it removes default namespaces from metric identifiers to make them shorter and cleaner. Use this if your monitoring system has namespace conflicts or if you prefer simpler metric names.
How do I add custom suffixes to my counter metrics?
Set `metrics.counter-suffix` to your desired suffix string (like `_total` or `_count`), and it will be automatically appended to all counter metrics you're collecting.