org.apache.oozie.service

Class XLogService

java.lang.Object

org.apache.oozie.service.XLogService

All Implemented Interfaces:

Service, Instrumentable

public class XLogService
extends Object
implements Service, Instrumentable

Built-in service that initializes and manages Logging via Log4j.

Oozie Lo4gj default configuration file is oozie-log4j.properties.

The file name can be changed by setting the Java System property oozie.log4j.file.

The Log4j configuration files must be a properties file.

The Log4j configuration file is first looked in the Oozie configuration directory see ConfigurationService. If the file is not found there, it is looked in the classpath.

If the Log4j configuration file is loaded from Oozie configuration directory, automatic reloading is enabled.

If the Log4j configuration file is loaded from the classpath, automatic reloading is disabled.

the automatic reloading interval is defined by the Java System property oozie.log4j.reload. The default value is 10 seconds.

Unlike most of the other Services, XLogService isn't easily overridable because Services depends on XLogService being available

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_LOG4J_PROPERTIES Default value for the log4j configuration file if LOG4J_FILE is not set.
static String	DEFAULT_RELOAD_INTERVAL Default value for the reload interval if LOG4J_RELOAD is not set.
static String	GROUP Group log info constant.
static String	LOG4J_FILE System property that indicates the log4j configuration file to load.
static String	LOG4J_RELOAD System property that indicates the reload interval of the configuration file.
static String	OOZIE_LOG_DIR System property that indicates the logs directory.
static String	USER Group log info constant.

Fields inherited from interface org.apache.oozie.service.Service

CONF_PREFIX, DEFAULT_LOCK_TIMEOUT, lockTimeout

Constructor Summary

Constructors

Constructor and Description
XLogService()

Method Summary

Modifier and Type	Method and Description
void	destroy() Destroy the log service.
Class<? extends Service>	getInterface() Return the public interface for log service.
boolean	getLogOverWS()
String	getOozieAuditLogName()
String	getOozieAuditLogPath()
int	getOozieAuditLogRotation()
String	getOozieErrorLogName()
String	getOozieErrorLogPath()
int	getOozieErrorLogRotation()
String	getOozieLogName()
String	getOozieLogPath()
int	getOozieLogRotation()
void	init(Services services) Initialize the log service.
void	instrument(Instrumentation instr) Instruments the log service.
boolean	isAuditLogEnabled()
boolean	isErrorLogEnabled()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OOZIE_LOG_DIR

public static final String OOZIE_LOG_DIR

System property that indicates the logs directory.

See Also:

Constant Field Values

LOG4J_FILE

public static final String LOG4J_FILE

System property that indicates the log4j configuration file to load.

See Also:

Constant Field Values

LOG4J_RELOAD

public static final String LOG4J_RELOAD

System property that indicates the reload interval of the configuration file.

See Also:

Constant Field Values

DEFAULT_LOG4J_PROPERTIES

public static final String DEFAULT_LOG4J_PROPERTIES

Default value for the log4j configuration file if LOG4J_FILE is not set.

See Also:

Constant Field Values

DEFAULT_RELOAD_INTERVAL

public static final String DEFAULT_RELOAD_INTERVAL

Default value for the reload interval if LOG4J_RELOAD is not set.

See Also:

Constant Field Values

USER

public static final String USER

Group log info constant.

See Also:

Constant Field Values

GROUP

public static final String GROUP

Group log info constant.

See Also:

Constant Field Values

Constructor Detail

XLogService

public XLogService()

Method Detail

getOozieLogPath

public String getOozieLogPath()

getOozieErrorLogPath

public String getOozieErrorLogPath()

getOozieLogName

public String getOozieLogName()

getOozieErrorLogName

public String getOozieErrorLogName()

init

public void init(Services services)
          throws ServiceException

Initialize the log service.

Specified by:

init in interface Service

Parameters:

services - services instance.

Throws:

ServiceException - thrown if the log service could not be initialized.

destroy

public void destroy()

Destroy the log service.

Specified by:

destroy in interface Service

getInterface

public Class<? extends Service> getInterface()

Return the public interface for log service.

Specified by:

getInterface in interface Service

Returns:

XLogService.

instrument

public void instrument(Instrumentation instr)

Instruments the log service.

It sets instrumentation variables indicating the config file, reload interval and if loaded from the classpath.

Specified by:

instrument in interface Instrumentable

Parameters:

instr - instrumentation to use.

getLogOverWS

public boolean getLogOverWS()

isErrorLogEnabled

public boolean isErrorLogEnabled()

getOozieLogRotation

public int getOozieLogRotation()

getOozieErrorLogRotation

public int getOozieErrorLogRotation()

getOozieAuditLogRotation

public int getOozieAuditLogRotation()

getOozieAuditLogPath

public String getOozieAuditLogPath()

getOozieAuditLogName

public String getOozieAuditLogName()

isAuditLogEnabled

public boolean isAuditLogEnabled()