Interface ServerManagerMonitorMBean

All Superinterfaces:
SelfEmailingMBean
All Known Implementing Classes:
ServerManagerMonitor

public interface ServerManagerMonitorMBean extends SelfEmailingMBean
Provides ability to manage and monitor a ServerManager. When run from within a servlet engine context also attempts to register the servlet engine process with wt.servlet.ServletEngineMonitorMBean's running in the server manager while pinging the server manager.

Supported API: true

Extendable: true
  • Field Details

    • PING_FAILED_NOTIFY_TYPE

      static final String PING_FAILED_NOTIFY_TYPE
      String PING_FAILED_NOTIFY_TYPE - Notification for when a ping fails.

      Supported API: true
    • PING_SUCCESS_NOTIFY_TYPE

      static final String PING_SUCCESS_NOTIFY_TYPE
      String PING_SUCCESS_NOTIFY_TYPE - Notification for when a ping succeeds.

      Supported API: true
  • Method Details

    • getLoggerLevel

      String getLoggerLevel()
      The current level of the logger. Valid values are ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF (or blank/unspecified). (not persisted with MBean)

      Supported API: true
      Returns:
      String - The logger level.
    • setLoggerLevel

      void setLoggerLevel(String logLevel)
      The current level of the logger. Valid values are ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF (or blank/unspecified). (not persisted with MBean)

      Supported API: true
      Parameters:
      logLevel - - The new log level.
    • getLoggerName

      String getLoggerName()
      The logger name.

      Supported API: true
      Returns:
      String - The logger name.
    • getPingIntervalSeconds

      int getPingIntervalSeconds()
      The current interval between pings (in seconds).

      Supported API: true
      Returns:
      int - The number of seconds between pings.
    • setPingIntervalSeconds

      void setPingIntervalSeconds(int pingIntervalSeconds)
      The current interval between pings (in seconds).

      Supported API: true
      Parameters:
      pingIntervalSeconds - - Number of seconds between pings.
    • getFailedPingsUntilRestart

      int getFailedPingsUntilRestart()
      The number of failed pings before attempting to restart the ServerManager. A negative or zero value implies restarts will not be attempted.

      Supported API: true
      Returns:
      int - The number of failed pings before attempting to restart the ServerManager.
    • getAllowInitialAutoStartup

      boolean getAllowInitialAutoStartup()
      Allows/disallows auto startup of the ServerManager if it is not already running.

      Supported API: true
      Returns:
      boolean - Allows/disallows auto startup of the ServerManager if it is not already running.
    • setAllowInitialAutoStartup

      void setAllowInitialAutoStartup(boolean allowAutoStartup)
      Allows/disallows auto startup of the ServerManager if it is not already running.

      Supported API: true
      Parameters:
      allowAutoStartup - - Allows/disallows auto startup of the ServerManager if it is not already running.
    • setFailedPingsUntilRestart

      void setFailedPingsUntilRestart(int newFailedPingsUntilRestart)
      The number of failed pings before attempting to restart the ServerManager. A negative or zero value implies restarts will not be attempted.

      Supported API: true
      Parameters:
      newFailedPingsUntilRestart - - Number of failed pings allowed before attempting to restart the ServerManager.
    • getLastPingResponseSeconds

      double getLastPingResponseSeconds()
      The response time of the most recent ping of the ServerManager (in seconds).

      Supported API: true
      Returns:
      double - The number of seconds the last ping took.
    • getAvgPingResponseSeconds

      double getAvgPingResponseSeconds()
      The average response time of ServerManager pings (in seconds).

      Supported API: true
      Returns:
      double - The average number of seconds pings take.
    • getPercentageServerManagerUpTime

      double getPercentageServerManagerUpTime()
      The percentage of time the ServerManager is up.

      Supported API: true
      Returns:
      double - The percentage of the time the ServerManager was up.
    • getServerManagerPings

      int getServerManagerPings()
      The total number of ServerManager pings attempted.

      Supported API: true
      Returns:
      int - The number of attempted pings to the ServerManager.
    • getLastResetTime

      Timestamp getLastResetTime()
      Time at which cumulative statistics were last reset.

      Supported API: true
    • getServerManagerInfo

      CompositeData getServerManagerInfo() throws Exception
      Usage information and statistics about the ServerManager.

      Supported API: true
      Returns:
      CompositeData - Data and descriptions about the ServerManager.
      Throws:
      Exception - - If there is an error getting the ServerManager info.
    • stopServerManager

      @MBeanOperationImpact(1) String stopServerManager() throws Exception
      Stop the ServerManager.

      Supported API: true
      Returns:
      String - A message about the success of the stop request.
      Throws:
      Exception
    • startServerManager

      @MBeanOperationImpact(1) String startServerManager() throws Exception
      Start the ServerManager.

      Supported API: true
      Returns:
      String - A message about the success of the start request.
      Throws:
      Exception
    • restartServerManger

      @MBeanOperationImpact(1) String restartServerManger() throws Exception
      Restart the ServerManager.

      Supported API: true
      Returns:
      String - A message about the success of the restart request.
      Throws:
      Exception
    • pingServerManager

      @MBeanOperationImpact(1) String pingServerManager() throws Exception
      Ping the ServerManager.

      Supported API: true
      Returns:
      String - A message about the success or failure of the ping request.
      Throws:
      Exception - - When error occurrs while attempting to ping the ServerManager. Contains message describing the problem and the original Exception.
    • resetStatistics

      @MBeanOperationImpact(1) void resetStatistics()
      Reset ping response time statistics.

      Supported API: true