Package org.forgerock.opendj.server.config.server

Interface ProfilerPluginCfg

  • All Superinterfaces:
    Configuration, PluginCfg
    public interface ProfilerPluginCfg
extends PluginCfg
    A server-side interface for querying Profiler Plugin settings.

    The Profiler plug-in captures profiling information about operations performed inside the JVM while the OpenDJ directory server is running.

    • Method Detail

      • addProfilerChangeListener

        void addProfilerChangeListener​(ConfigurationChangeListener<ProfilerPluginCfg> listener)
        Register to be notified when this Profiler Plugin is changed.
        Parameters:
        listener - The Profiler Plugin configuration change listener.

      • removeProfilerChangeListener

        void removeProfilerChangeListener​(ConfigurationChangeListener<ProfilerPluginCfg> listener)
        Deregister an existing Profiler Plugin configuration change listener.
        Parameters:
        listener - The Profiler Plugin configuration change listener.

      • isEnableProfilingOnStartup

        boolean isEnableProfilingOnStartup()
        Gets the "enable-profiling-on-startup" property.

        Indicates whether the profiler plug-in is to start collecting data automatically when the directory server is started.

        This property is read only when the server is started, and any changes take effect on the next restart. This property is typically set to "false" unless startup profiling is required, because otherwise the volume of data that can be collected can cause the server to run out of memory if it is not turned off in a timely manner.

        Returns:
        Returns the value of the "enable-profiling-on-startup" property.

      • isInvokeForInternalOperations

        boolean isInvokeForInternalOperations()
        Gets the "invoke-for-internal-operations" property.

        Indicates whether the plug-in should be invoked for internal operations.

        Any plug-in that can be invoked for internal operations must ensure that it does not create any new internal operatons that can cause the same plug-in to be re-invoked.

        Specified by:
        isInvokeForInternalOperations in interface PluginCfg
        Returns:
        Returns the value of the "invoke-for-internal-operations" property.

      • getJavaClass

        String getJavaClass()
        Gets the "java-class" property.

        Specifies the fully-qualified name of the Java class that provides the plug-in implementation.

        Specified by:
        getJavaClass in interface PluginCfg
        Returns:
        Returns the value of the "java-class" property.

      • getPluginType

        SortedSet<PluginCfgDefn.PluginType> getPluginType()
        Gets the "plugin-type" property.

        Specifies the set of plug-in types for the plug-in, which specifies the times at which the plug-in is invoked.

        Specified by:
        getPluginType in interface PluginCfg
        Returns:
        Returns an unmodifiable set containing the values of the "plugin-type" property.

      • getProfileAction

        ProfilerPluginCfgDefn.ProfileAction getProfileAction()
        Gets the "profile-action" property.

        Specifies the action that should be taken by the profiler.

        A value of "start" causes the profiler thread to start collecting data if it is not already active. A value of "stop" causes the profiler thread to stop collecting data and write it to disk, and a value of "cancel" causes the profiler thread to stop collecting data and discard anything that has been captured. These operations occur immediately.

        Returns:
        Returns the value of the "profile-action" property.

      • getProfileDirectory

        String getProfileDirectory()
        Gets the "profile-directory" property.

        Specifies the path to the directory where profile information is to be written. This path may be either an absolute path or a path that is relative to the root of the OpenDJ directory server instance.

        The directory must exist and the directory server must have permission to create new files in it.

        Returns:
        Returns the value of the "profile-directory" property.

      • getProfileSampleInterval

        long getProfileSampleInterval()
        Gets the "profile-sample-interval" property.

        Specifies the sample interval in milliseconds to be used when capturing profiling information in the server.

        When capturing data, the profiler thread sleeps for this length of time between calls to obtain traces for all threads running in the JVM.

        Returns:
        Returns the value of the "profile-sample-interval" property.