Timings (Paper-API 1.13.2-R0.1-SNAPSHOT API)

java.lang.Object
- co.aikar.timings.Timings

public final class Timings
extends Object

Field Summary

Fields
Modifier and Type Field Description

static Timing NULL_HANDLER

Fields
Modifier and Type	Field	Description
`static Timing`	`NULL_HANDLER`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method	Description
`static void`	`generateReport(TimingsReportListener sender)`	Generates a report and sends it to the specified listener.
`static void`	`generateReport(CommandSender sender)`	Generates a report and sends it to the specified command sender.
`static int`	`getHistoryInterval()`	Gets the interval between Timing History report generation.
`static int`	`getHistoryLength()`	Gets how long in ticks Timings history is kept for the server.
`static boolean`	`isTimingsEnabled()`	Gets whether or not the Spigot Timings system is enabled
`static boolean`	`isVerboseTimingsEnabled()`	Sets whether or not the Timings should monitor at Verbose level.
`static Timing`	`of(Plugin plugin, String name)`	Returns a Timing for a plugin corresponding to a name.
`static Timing`	`of(Plugin plugin, String name, Timing groupHandler)`	Returns a handler that has a groupHandler timer handler.
`static Timing`	`ofStart(Plugin plugin, String name)`	Returns a Timing object after starting it, useful for Java7 try-with-resources.
`static Timing`	`ofStart(Plugin plugin, String name, Timing groupHandler)`	Returns a Timing object after starting it, useful for Java7 try-with-resources.
`static void`	`reset()`	Resets all Timing Data
`static void`	`setHistoryInterval(int interval)`	Sets the interval between Timing History report generations.
`static void`	`setHistoryLength(int length)`	Sets how long Timing History reports are kept for the server.
`static void`	`setTimingsEnabled(boolean enabled)`	Sets whether or not the Spigot Timings system should be enabled
`static void`	`setVerboseTimingsEnabled(boolean enabled)`	Sets whether or not the Timings should monitor at Verbose level.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - NULL_HANDLER
```
public static final Timing NULL_HANDLER
```
- Method Detail
  - of
```
@NotNull
public static Timing of(@NotNull
                        Plugin plugin,
                        @NotNull
                        String name)
```
    Returns a Timing for a plugin corresponding to a name.
    
    Parameters:
    
    plugin - Plugin to own the Timing
    
    name - Name of Timing
    
    Returns:
    
    Handler
  - of
```
@NotNull
public static Timing of(@NotNull
                        Plugin plugin,
                        @NotNull
                        String name,
                        @Nullable
                        Timing groupHandler)
```
    Returns a handler that has a groupHandler timer handler. Parent timers should not have their start/stop methods called directly, as the children will call it for you.
    Parent Timers are used to group multiple subsections together and get a summary of them combined Parent Handler can not be changed after first call
    
    Parameters:
    
    plugin - Plugin to own the Timing
    
    name - Name of Timing
    
    groupHandler - Parent handler to mirror .start/stop calls to
    
    Returns:
    
    Timing Handler
  - ofStart
```
@NotNull
public static Timing ofStart(@NotNull
                             Plugin plugin,
                             @NotNull
                             String name)
```
    Returns a Timing object after starting it, useful for Java7 try-with-resources. try (Timing ignored = Timings.ofStart(plugin, someName)) { // timed section }
    
    Parameters:
    
    plugin - Plugin to own the Timing
    
    name - Name of Timing
    
    Returns:
    
    Timing Handler
  - ofStart
```
@NotNull
public static Timing ofStart(@NotNull
                             Plugin plugin,
                             @NotNull
                             String name,
                             @Nullable
                             Timing groupHandler)
```
    Returns a Timing object after starting it, useful for Java7 try-with-resources. try (Timing ignored = Timings.ofStart(plugin, someName, groupHandler)) { // timed section }
    
    Parameters:
    
    plugin - Plugin to own the Timing
    
    name - Name of Timing
    
    groupHandler - Parent handler to mirror .start/stop calls to
    
    Returns:
    
    Timing Handler
  - isTimingsEnabled
```
public static boolean isTimingsEnabled()
```
    Gets whether or not the Spigot Timings system is enabled
    
    Returns:
    
    Enabled or not
  - setTimingsEnabled
```
public static void setTimingsEnabled(boolean enabled)
```
    Sets whether or not the Spigot Timings system should be enabled
    Calling this will reset timing data.
    
    Parameters:
    
    enabled - Should timings be reported
  - isVerboseTimingsEnabled
```
public static boolean isVerboseTimingsEnabled()
```
    Sets whether or not the Timings should monitor at Verbose level.
    
    When Verbose is disabled, high-frequency timings will not be available.
    
    Returns:
    
    Enabled or not
  - setVerboseTimingsEnabled
```
public static void setVerboseTimingsEnabled(boolean enabled)
```
    Sets whether or not the Timings should monitor at Verbose level.
    When Verbose is disabled, high-frequency timings will not be available. Calling this will reset timing data.
    
    Parameters:
    
    enabled - Should high-frequency timings be reported
  - getHistoryInterval
```
public static int getHistoryInterval()
```
    Gets the interval between Timing History report generation.
    Defaults to 5 minutes (6000 ticks)
    
    Returns:
    
    Interval in ticks
  - setHistoryInterval
```
public static void setHistoryInterval(int interval)
```
    Sets the interval between Timing History report generations.
    
    Defaults to 5 minutes (6000 ticks)
    This will recheck your history length, so lowering this value will lower your history length if you need more than 60 history windows.
    
    Parameters:
    
    interval - Interval in ticks
  - getHistoryLength
```
public static int getHistoryLength()
```
    Gets how long in ticks Timings history is kept for the server. Defaults to 1 hour (72000 ticks)
    
    Returns:
    
    Duration in Ticks
  - setHistoryLength
```
public static void setHistoryLength(int length)
```
    Sets how long Timing History reports are kept for the server. Defaults to 1 hours(72000 ticks) This value is capped at a maximum of getHistoryInterval() * MAX_HISTORY_FRAMES (12) Will not reset Timing Data but may truncate old history if the new length is less than old length.
    
    Parameters:
    
    length - Duration in ticks
  - reset
```
public static void reset()
```
    Resets all Timing Data
  - generateReport
```
public static void generateReport(@Nullable
                                  CommandSender sender)
```
    Generates a report and sends it to the specified command sender. If sender is null, ConsoleCommandSender will be used.
    
    Parameters:
    
    sender - The sender to send to, or null to use the ConsoleCommandSender
  - generateReport
```
public static void generateReport(@NotNull
                                  TimingsReportListener sender)
```
    Generates a report and sends it to the specified listener. Use with BufferedCommandSender to get full response when done!
    
    Parameters:
    
    sender - The listener to send responses too.

Class Timings

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NULL_HANDLER

Method Detail

of

of

ofStart

ofStart

isTimingsEnabled

setTimingsEnabled

isVerboseTimingsEnabled

setVerboseTimingsEnabled

getHistoryInterval

setHistoryInterval

getHistoryLength

setHistoryLength

reset

generateReport

generateReport