org.apache.logging.log4j.core.jmx
Interface StatusLoggerAdminMBean

All Known Implementing Classes:
StatusLoggerAdmin

public interface StatusLoggerAdminMBean

The MBean interface for monitoring and managing the StatusLogger.


Field Summary
static String NAME
          Object name of this MBean.
static String NOTIF_TYPE_DATA
          Notifications with this type have a StatusData userData object and a null message.
static String NOTIF_TYPE_MESSAGE
          Notifications with this type have a formatted status data message string but no StatusData in their userData field.
 
Method Summary
 String getLevel()
          Returns the StatusLogger level as a String.
 List<org.apache.logging.log4j.status.StatusData> getStatusData()
          Returns a list with the most recent StatusData objects in the status history.
 String[] getStatusDataHistory()
          Returns a string array with the most recent messages in the status history.
 void setLevel(String level)
          Sets the StatusLogger level to the specified value.
 

Field Detail

NAME

static final String NAME
Object name of this MBean.

See Also:
Constant Field Values

NOTIF_TYPE_DATA

static final String NOTIF_TYPE_DATA
Notifications with this type have a StatusData userData object and a null message.

See Also:
Constant Field Values

NOTIF_TYPE_MESSAGE

static final String NOTIF_TYPE_MESSAGE
Notifications with this type have a formatted status data message string but no StatusData in their userData field.

See Also:
Constant Field Values
Method Detail

getStatusData

List<org.apache.logging.log4j.status.StatusData> getStatusData()
Returns a list with the most recent StatusData objects in the status history. The list has up to 200 entries by default but the length can be configured with system property "log4j2.status.entries".

Note that the returned objects may contain Throwables from external libraries. JMX clients calling this method must be prepared to deal with the errors that occur if they do not have the class definition for such Throwables in their classpath.

Returns:
the most recent messages logged by the StatusLogger.

getStatusDataHistory

String[] getStatusDataHistory()
Returns a string array with the most recent messages in the status history. The list has up to 200 entries by default but the length can be configured with system property "log4j2.status.entries".

Returns:
the most recent messages logged by the StatusLogger.

getLevel

String getLevel()
Returns the StatusLogger level as a String.

Returns:
the StatusLogger level.

setLevel

void setLevel(String level)
Sets the StatusLogger level to the specified value.

Parameters:
level - the new StatusLogger level.
Throws:
IllegalArgumentException - if the specified level is not one of "OFF", "FATAL", "ERROR", "WARN", "INFO", "DEBUG", "TRACE", "ALL"


Copyright © 1999-2013 Apache Software Foundation. All Rights Reserved.
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.