Class StatusLoggerAdmin

    • Constructor Detail

      • StatusLoggerAdmin

        public StatusLoggerAdmin​(String contextName,
                                 Executor executor)
        Constructs a new StatusLoggerAdmin with the Executor to be used for sending Notifications asynchronously to listeners.
        Parameters:
        contextName - name of the LoggerContext under which to register this StatusLoggerAdmin. Note that the StatusLogger may be registered multiple times, once for each LoggerContext. In web containers, each web application has its own LoggerContext and by associating the StatusLogger with the LoggerContext, all associated MBeans can be unloaded when the web application is undeployed.
        executor - used to send notifications asynchronously
    • Method Detail

      • getStatusDataHistory

        public String[] getStatusDataHistory()
        Description copied from interface: StatusLoggerAdminMBean
        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".
        Specified by:
        getStatusDataHistory in interface StatusLoggerAdminMBean
        Returns:
        the most recent messages logged by the StatusLogger.
      • getStatusData

        public List<StatusData> getStatusData()
        Description copied from interface: StatusLoggerAdminMBean
        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.

        Specified by:
        getStatusData in interface StatusLoggerAdminMBean
        Returns:
        the most recent messages logged by the StatusLogger.
      • getStatusLevel

        public Level getStatusLevel()
        Description copied from interface: StatusListener
        Return the Log Level that this listener wants included.
        Specified by:
        getStatusLevel in interface StatusListener
        Returns:
        the Log Level.
      • log

        public void log​(StatusData data)
        Description copied from interface: StatusListener
        Called as events occur to process the StatusData.
        Specified by:
        log in interface StatusListener
        Parameters:
        data - The StatusData for the event.