SpecificProfiler

SpecificProfiler measures how long entities and tile entities take to "tick" and then records that data along with their location. If you use Claims, then the owner of the chunk is also available.

The intended purpose of SpecificProfiler is:

• To identify which entities and tile entities use up the most tick time.
• To see which players have the most CPU-demanding bases (if you have claims support).

To get a complete view of your server, also consider using WarmRoast.

Configuration

SpecificProfiler can be configured in specificprofiler.cfg. The only options available are ones to adjust the default and maximum profiler durations.

# The number of seconds to profile for by default (if not specified)
defaultProfileDuration=30
# The maximum number of seconds to profile for
maxProfileDuration=300

Generating Reports

To generate a SpecificProfiler report, use the /sprofiler start command with an optional number of seconds to run the profiler for. The longer that you run the profiler for, the more average the results will be.

The profiler can be prematurely stopped using /sprofiler stop. Only one profile session can be run at one time.

After the profiler has finished, the results will be sent off to Report Writers. If you have default settings, you can find a .csv file saved to the reports/ folder.

Analyzing Reports

Reports are best analyzed in a spreadsheet program at this moment using the "PivotTable" function.

In Excel

If you are using Excel, follow the steps below after opening up the .csv file.

1. Select the top left cell and insert a PivotTable using the ribbon.

   

2. Use default settings and click OK on the dialog that pops up.

3. On the sidebar, drag columns to the areas at the bottom of the sidebar. Under "Rows," you should drag columns that you want to categorize by, such as Owner or Class. Under "Values", drag columns that you want to calculate a number for and display as a PivotTable column, such as "Time".

   

4. If you dragged Time, you may want to modify it so that it displays a percentage of the parent row.

   

5. You should see the results as shown below:

   

6. You may want to sort the PivotTable by clicking a column, going to the Data ribbon, and clicking one of the sort buttons.