How to Analyze a Timings v2 Report

A timings report is a diagnostic tool used on Paper servers, that provides a detailed breakdown of server performance. Often, these are used to help server owners diagnose where server lag may be occurring and can be utilized to help manage your server.

#How to Read a Timings Report

Once a report has been generated, you may open it, Upon doing so, you will be presented with one of 2 variants.

This guide describes how to analyze Timings report v2, which is generated from PaperMC server types. If your report doesn't look similar to the one below, it means you most likely have timings report v1 which is generated by Spigot.

If you have generated a Timings v1 Report, you are required to follow this analyzation guide.

#Reading a Timings Report v2

1. Check Server Ticks per Second (TPS)

Navigate to the Avg tab under results bar and select it. Then check the value named Minecraft::Full Server Tick. If it's above 18 TPS (make sure to check the value in "()"), your server isn't experiencing consistent tick-related lag. The lag may be caused by latency issues. To fix latency lag, consider changing your server location.

2. Check Entity Count

Too many entities may take a lot of your server’s processing power. Therefore, to check it navigate to Regions > Count and expand the world option. There you will be able to find the total number of entities per region.

If there are more than 2000+ entities present on your server at the same time, this may result in poor server performance. In this instance, we recommend checking our guide on How to Reduce Entity Lag on your Server.

3. Check Average Player Count

Players as entities take valuable resources to process their actions on the server. Therefore having too many players online at the same time may negatively impact your server’s performance. This is more common in cases where your server may not have enough RAM. If more than 20 players are connected to your server per GB of RAM, we suggest upgrading your server to reduce player-related lag (this may vary depending on your Server Type).

To check the number of players in the selected region, navigate to Regions > Count and search for the Player value.

4. Attempt to Resolve Alerts

PaperMC Timings reports alert you if some settings are not optimized or are beyond their normal values. In the example below, we can see that the report alerted us that the server is not using Aikar flags and it also provides a resolution. The errors may vary, but they always contain a cause and suggestion on how to resolve the issue.

In rare cases, it may happen that you won’t be able to find any conclusive evidence of what is causing lag on your server.

There are a few ways you may resolve lag that is not appearing on your timings report. We would recommend checking the following documentation:

• Optimize bukkit.yml to Reduce Lag

• Optimizing spigot.yml to Reduce Lag

• How to Fix Lag By Reducing View Distance on a Minecraft Server

• Use Plugins to Reduce Lag on Your Minecraft Server

You may also simply upgrade your server to a higher plan, which may instantly solve your issues.

If your server is still lagging, you may contact our 24/7 support team, providing your timings report in a ticket. We will be happy to take a look and assist you in finding a resolution for your lag problems.