org.apache.logging.log4j.core.appender
Class FailoverAppender
java.lang.Object
org.apache.logging.log4j.core.filter.AbstractFilterable
org.apache.logging.log4j.core.appender.AbstractAppender
org.apache.logging.log4j.core.appender.FailoverAppender
- All Implemented Interfaces:
- Appender, Filterable, LifeCycle
public final class FailoverAppender
- extends AbstractAppender
The FailoverAppender will capture exceptions in an Appender and then route the event
to a different appender. Hopefully it is obvious that the Appenders must be configured
to not suppress exceptions for the FailoverAppender to work.
Methods inherited from class org.apache.logging.log4j.core.appender.AbstractAppender |
error, error, error, getHandler, getLayout, getName, ignoreExceptions, isStarted, parseInt, setHandler, stop |
start
public void start()
- Description copied from class:
AbstractAppender
- Start the Appender.
- Specified by:
start
in interface LifeCycle
- Overrides:
start
in class AbstractAppender
append
public void append(LogEvent event)
- Handle the Log event.
- Parameters:
event
- The LogEvent.
toString
public String toString()
- Overrides:
toString
in class AbstractAppender
createAppender
public static FailoverAppender createAppender(String name,
String primary,
String[] failovers,
String retryIntervalString,
Configuration config,
Filter filter,
String ignore)
- Create a Failover Appender.
- Parameters:
name
- The name of the Appender (required).primary
- The name of the primary Appender (required).failovers
- The name of one or more Appenders to fail over to (at least one is required).retryIntervalString
- The retry intervalMillis.config
- The current Configuration (passed by the Configuration when the appender is created).filter
- A Filter (optional).ignore
- If "true"
(default) exceptions encountered when appending events are logged; otherwise
they are propagated to the caller.
- Returns:
- The FailoverAppender that was created.
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.