Class RecordingInfo

java.lang.Object
jdk.management.jfr.RecordingInfo

public final class RecordingInfo
extends Object
Management representation of a Recording.
Since:
9
See Also:
Recording
  • Method Summary

    Modifier and Type Method Description
    static RecordingInfo from​(CompositeData cd)
    Returns a RecordingInfo represented by the specified CompositeData object.
    String getDestination()
    Returns destination path where data, for the recording associated with this RecordingInfo, should be written when the recording stops, or null if the recording should not be written.
    boolean getDumpOnExit()
    Returns if the recording associated with this RecordingInfo should be dumped to file when the JVM exits.
    long getDuration()
    Returns the desired duration, measured in seconds, of the recording associated with this RecordingInfo, or {code 0} if no duration has been set.
    long getId()
    Returns the unique ID for the recording associated with this RecordingInfo.
    long getMaxAge()
    Returns how many seconds data should be kept on disk, or 0 if data is to be kept forever.
    long getMaxSize()
    Returns the amount of data, measured in bytes, the recording associated with this RecordingInfo, should be kept on disk, before it's rotated away, or 0 if data is to be kept indefinitely.
    String getName()
    Returns the name of the recording associated with this RecordingInfo.
    Map<String,​String> getSettings()
    Returns the settings for the recording associated with this RecordingInfo.
    long getSize()
    Returns the amount data recorded by recording. associated with this RecordingInfo.
    long getStartTime()
    Returns start time of the recording associated with this RecordingInfo, measured as ms since epoch, or null if the recording hasn't started.
    String getState()
    Returns a String representation of state of the recording associated with this RecordingInfo.
    long getStopTime()
    Returns the actual or expected stop time of the recording associated with this RecordingInfo, measured as ms since epoch, or null if the expected or actual stop time is not known, which can only happen if the recording has not yet been stopped.
    boolean isToDisk()
    Returns true if the recording associated with this RecordingInfo should be flushed to disk, when memory buffers are full, false otherwise.
    String toString()
    Returns a string description of the recording associated with this RecordingInfo

    Methods declared in class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Method Details

    • getName

      public String getName()
      Returns the name of the recording associated with this RecordingInfo.
      Returns:
      the recording name, not null
      See Also:
      Recording.getName()
    • getId

      public long getId()
      Returns the unique ID for the recording associated with this RecordingInfo.
      Returns:
      the recording ID
      See Also:
      Recording.getId()
    • getDumpOnExit

      public boolean getDumpOnExit()
      Returns if the recording associated with this RecordingInfo should be dumped to file when the JVM exits.
      Returns:
      true if recording should be dumped on exit, false otherwise
      See Also:
      Recording.getDumpOnExit()
    • getMaxAge

      public long getMaxAge()
      Returns how many seconds data should be kept on disk, or 0 if data is to be kept forever.

      In-memory recordings are not affected by maximum age.

      Returns:
      how long data should be kept on disk, measured in seconds
      See Also:
      Recording.getMaxAge(), Recording.setToDisk(boolean)
    • getMaxSize

      public long getMaxSize()
      Returns the amount of data, measured in bytes, the recording associated with this RecordingInfo, should be kept on disk, before it's rotated away, or 0 if data is to be kept indefinitely.

      In-memory recordings are not affected by maximum size.

      Returns:
      the amount of data should be kept on disk, in bytes
      See Also:
      Recording.setToDisk(boolean), Recording.getMaxSize()
    • getState

      public String getState()
      Returns a String representation of state of the recording associated with this RecordingInfo.

      Valid return values are "NEW", "DELAYED", "STARTING", "RUNNING", "STOPPING", "STOPPED" and "CLOSED".

      Returns:
      the recording state, not null
      See Also:
      Enum.toString(), Recording.getState()
    • getStartTime

      public long getStartTime()
      Returns start time of the recording associated with this RecordingInfo, measured as ms since epoch, or null if the recording hasn't started.
      Returns:
      the start time of the recording, or null if the recording hasn't started
      See Also:
      Recording.getStartTime()
    • getStopTime

      public long getStopTime()
      Returns the actual or expected stop time of the recording associated with this RecordingInfo, measured as ms since epoch, or null if the expected or actual stop time is not known, which can only happen if the recording has not yet been stopped.
      Returns:
      the stop time of recording, or null if recording hasn't been stopped.
      See Also:
      Recording.getStopTime()
    • getSettings

      public Map<String,​String> getSettings()
      Returns the settings for the recording associated with this RecordingInfo.
      Returns:
      the recording settings, not null
      See Also:
      Recording.getSettings()
    • getDestination

      public String getDestination()
      Returns destination path where data, for the recording associated with this RecordingInfo, should be written when the recording stops, or null if the recording should not be written.
      Returns:
      the destination, or null if not set
      See Also:
      Recording.getDestination()
    • toString

      public String toString()
      Returns a string description of the recording associated with this RecordingInfo
      Overrides:
      toString in class Object
      Returns:
      description, not null
    • getSize

      public long getSize()
      Returns the amount data recorded by recording. associated with this RecordingInfo.
      Returns:
      the amount of recorded data, measured in bytes
    • isToDisk

      public boolean isToDisk()
      Returns true if the recording associated with this RecordingInfo should be flushed to disk, when memory buffers are full, false otherwise.
      Returns:
      true if recording is to disk, false otherwise
    • getDuration

      public long getDuration()
      Returns the desired duration, measured in seconds, of the recording associated with this RecordingInfo, or {code 0} if no duration has been set.
      Returns:
      the desired duration, or {code 0} if no duration has been set
      See Also:
      Recording.getDuration()
    • from

      public static RecordingInfo from​(CompositeData cd)
      Returns a RecordingInfo represented by the specified CompositeData object.

      The specified CompositeData must have the following item names and item types to be valid.

      Supported names and types in a specified CompositeData object
      Name Type
      id Long
      name String
      state String
      dumpOnExit Boolean
      size Long
      disk Boolean
      maxAge Long
      maxSize Long
      startTime Long
      stopTime Long
      destination String
      duration Long
      settings javax.management.openmbean.CompositeData[] whose element type is the mapped type for SettingDescriptorInfo as specified in the SettingDescriptorInfo.from(javax.management.openmbean.CompositeData) method.

      Parameters:
      cd - CompositeData representing the RecordingInfo to return
      Returns:
      the RecordingInfo represented by cd, or null if cd is null
      Throws:
      IllegalArgumentException - if cd does not represent a valid RecordingInfo