Class Recording

java.lang.Object

one.profiler.Recording

public class Recording
extends Object

Tracks async-profiler's recording state and provides timestamps aligned with the profiler clock.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	RUNNING	A JFR session is running.
static final int	STOPPED	async-profiler is loaded, but no JFR session is running.
static final int	UNAVAILABLE	async-profiler is not loaded.

Method Summary

Modifier and Type	Method	Description
static long	clockFrequency()	Returns the tick rate of the timestamp() clock.
static int	state()
static long	timestamp()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

UNAVAILABLE

public static final int UNAVAILABLE

async-profiler is not loaded.

See Also:

• Constant Field Values

STOPPED

public static final int STOPPED

async-profiler is loaded, but no JFR session is running.

See Also:

• Constant Field Values

RUNNING

public static final int RUNNING

A JFR session is running.

See Also:

• Constant Field Values

Method Details

state

public static int state()

Returns:

the current recording state: UNAVAILABLE, STOPPED or RUNNING

clockFrequency

public static long clockFrequency()

Returns the tick rate of the timestamp() clock. The frequency is not a constant: it may change when a recording starts, since async-profiler can switch the clock source between recordings.

The frequency alone is enough to convert durations to profiler ticks.

Returns:

the number of ticks per second of the profiler clock

timestamp

public static long timestamp()

Returns:

the current time in the same clock async-profiler uses for its events, so span and sample timestamps are comparable