lsst::log::Log Class Reference

#include <Log.h>

Public Member Functions
	Log ()
bool	isDebugEnabled () const
bool	isErrorEnabled () const
bool	isFatalEnabled () const
bool	isInfoEnabled () const
bool	isTraceEnabled () const
bool	isWarnEnabled () const
std::string	getName () const
void	setLevel (int level)
int	getLevel () const
bool	isEnabledFor (int level) const
void	log (log4cxx::LevelPtr level, log4cxx::spi::LocationInfo const &location, char const *fmt,...)
void	logMsg (log4cxx::LevelPtr level, log4cxx::spi::LocationInfo const &location, std::string const &msg)

Static Public Member Functions
static Log	getDefaultLogger ()
	Return default logger instance, same as default constructor. More...
static std::string	getDefaultLoggerName ()
static void	configure ()
static void	configure (std::string const &filename)
static void	configure_prop (std::string const &properties)
static Log	getLogger (Log const &logger)
static Log	getLogger (std::string const &loggername)
static void	pushContext (std::string const &name)
static void	popContext ()
static void	MDC (std::string const &key, std::string const &value)
static void	MDCRemove (std::string const &key)
static int	MDCRegisterInit (std::function< void()> function)
static void	log (Log logger, log4cxx::LevelPtr level, log4cxx::spi::LocationInfo const &location, char const *fmt,...)
static void	logMsg (Log logger, log4cxx::LevelPtr level, log4cxx::spi::LocationInfo const &location, std::string const &msg)

Private Member Functions
	Log (log4cxx::LoggerPtr const &logger)

Static Private Member Functions
static log4cxx::LoggerPtr &	_defaultLogger ()

Private Attributes
log4cxx::LoggerPtr	_logger

Detailed Description

This static class includes a variety of methods for interacting with the the logging module. These methods are not meant for direct use. Rather, they are used by the LOG* macros and the SWIG interface declared in logInterface.h.

Definition at line 723 of file Log.h.

Constructor & Destructor Documentation

lsst::log::Log::Log ( )

inline

Definition at line 732 of file Log.h.

: _logger(_defaultLogger()) { }

lsst::log::Log::Log ( log4cxx::LoggerPtr const &  logger )

inlineprivate

Definition at line 801 of file Log.h.

: _logger(logger) { }

Member Function Documentation

log4cxx::LoggerPtr & lsst::log::Log::_defaultLogger ( )

staticprivate

Returns default LOG4CXX logger.

Definition at line 149 of file Log.cc.

                                      {
    static log4cxx::LoggerPtr _default(::log4cxxInit());
    return _default;
}

void lsst::log::Log::configure ( )

static

Explicitly configures log4cxx and initializes logging system.

Uses either default configuration or log4cxx basic configuration. Default configuration can be specified via environment variable LSST_LOG_CONFIG, if it is set and specifies existing file name then this file name is used for configuration. Otherwise log4cxx BasicConfigurator class is used to configure, which is hardwired to add to the root logger a ConsoleAppender. In this case, the output will be formatted using a PatternLayout set to the pattern "%-4r [%t] %-5p %c %x - %m%n".

Definition at line 165 of file Log.cc.

                    {

    // in case log4cxxInit() was not called yet tell it to ignore basic config
    ::doBasicConfig = false;

    // TODO: does resetConfiguration() remove existing appenders?
    log4cxx::BasicConfigurator::resetConfiguration();

    // if LSST_LOG_CONFIG is set then use that file
    if (const char* env = getenv(::configEnv)) {
        if (env[0] and access(env, R_OK) == 0) {
            configure(env);
            return;
        }
    }

    // Do basic configuration (only if not configured already?)
    log4cxx::LoggerPtr rootLogger = log4cxx::Logger::getRootLogger();
    if (rootLogger->getAllAppenders().size() == 0) {
        log4cxx::BasicConfigurator::configure();
    }

    // reset default logger to the root logger
    _defaultLogger() = rootLogger;
}

void lsst::log::Log::configure ( std::string const &  filename )

static

Configures log4cxx from specified file.

If file name ends with ".xml", it is passed to log4cxx::xml::DOMConfigurator::configure(). Otherwise, it assumed to be a log4j Java properties file and is passed to log4cxx::PropertyConfigurator::configure(). See http://logging.apache.org/log4cxx/usage.html for additional details.

Parameters

filename

Path to configuration file.

Definition at line 201 of file Log.cc.

                                             {
    // in case log4cxxInit() was not called yet tell it to ignore basic config
    ::doBasicConfig = false;
    // TODO: does resetConfiguration() remove existing appenders?
    log4cxx::BasicConfigurator::resetConfiguration();
    if (getFileExtension(filename).compare(".xml") == 0) {
        log4cxx::xml::DOMConfigurator::configure(filename);
    } else {
        log4cxx::PropertyConfigurator::configure(filename);
    }
    // reset default logger to the root logger
    _defaultLogger() = log4cxx::Logger::getRootLogger();
}

void lsst::log::Log::configure_prop ( std::string const &  properties )

static

Configures log4cxx using a string containing the list of properties, equivalent to configuring from a file containing the same content but without creating temporary files.

Parameters

properties

Configuration properties.

Definition at line 221 of file Log.cc.

                                                    {
    // in case log4cxxInit() was not called yet tell it to ignore basic config
    ::doBasicConfig = false;

    std::vector<unsigned char> data(properties.begin(), properties.end());
    log4cxx::helpers::InputStreamPtr inStream(new log4cxx::helpers::ByteArrayInputStream(data));
    log4cxx::helpers::Properties prop;
    prop.load(inStream);
    log4cxx::PropertyConfigurator::configure(prop);

    // reset default logger to the root logger
    _defaultLogger() = log4cxx::Logger::getRootLogger();
}

static Log lsst::log::Log::getDefaultLogger ( )

inlinestatic

Return default logger instance, same as default constructor.

Definition at line 765 of file Log.h.

{ return Log(_defaultLogger()); }

std::string lsst::log::Log::getDefaultLoggerName ( )

static

Get the current default logger name.

Returns

String containing the default logger name.

Definition at line 238 of file Log.cc.

                                    {
    return getDefaultLogger().getName();
}

int lsst::log::Log::getLevel

(

)

const

Retrieve the logging threshold.

Returns

int Indicating the logging threshold.

Definition at line 356 of file Log.cc.

                        {
    log4cxx::LevelPtr level = _logger->getLevel();
    int levelno = -1;
    if (level != NULL) {
        levelno = level->toInt();
    }
    return levelno;
}

static Log lsst::log::Log::getLogger ( Log const &  logger )

inlinestatic

Definition at line 772 of file Log.h.

{ return logger; }

Log lsst::log::Log::getLogger ( std::string const &  loggername )

static

Returns logger object for a given name.

If name is empty then current logger is returned and not a root logger.

Parameters

loggername

Name of logger to return.

Returns

Log instance corresponding to logger name.

Definition at line 261 of file Log.cc.

                                              {
    if (loggername.empty()){
        return getDefaultLogger();
    } else {
        return Log(log4cxx::Logger::getLogger(loggername));
    }
}

std::string lsst::log::Log::getName

(

)

const

Get the logger name associated with the Log object.

Returns

String containing the logger name.

Definition at line 245 of file Log.cc.

                             {
    std::string name = _logger->getName();
    if (name == "root") {
        name.clear();
    }
    return name;
}

bool lsst::log::Log::isDebugEnabled ( ) const

inline

Check whether the logger is enabled for the DEBUG Level

Definition at line 737 of file Log.h.

{ return _logger->isDebugEnabled(); }

bool lsst::log::Log::isEnabledFor

(

int

level

)

const

Return whether the logging threshold of the logger is less than or equal to LEVEL.

Returns

Bool indicating whether or not logger is enabled.

Parameters

level

Logging threshold to check.

Definition at line 371 of file Log.cc.

                                      {
    if (_logger->isEnabledFor(log4cxx::Level::toLevel(level))) {
        return true;
    } else {
        return false;
    }
}

bool lsst::log::Log::isErrorEnabled ( ) const

inline

Check whether the logger is enabled for the ERROR Level

Definition at line 741 of file Log.h.

{ return _logger->isErrorEnabled(); }

bool lsst::log::Log::isFatalEnabled ( ) const

inline

Check whether the logger is enabled for the FATAL Level

Definition at line 745 of file Log.h.

{ return _logger->isFatalEnabled(); }

bool lsst::log::Log::isInfoEnabled ( ) const

inline

Check whether the logger is enabled for the INFO Level

Definition at line 749 of file Log.h.

{ return _logger->isInfoEnabled(); }

bool lsst::log::Log::isTraceEnabled ( ) const

inline

Check whether the logger is enabled for the TRACE Level

Definition at line 753 of file Log.h.

{ return _logger->isTraceEnabled(); }

bool lsst::log::Log::isWarnEnabled ( ) const

inline

Check whether the logger is enabled for the WARN Level

Definition at line 757 of file Log.h.

{ return _logger->isWarnEnabled(); }

void lsst::log::Log::log ( Log  logger, log4cxx::LevelPtr  level, log4cxx::spi::LocationInfo const &  location, char const *  fmt,   ...  )

static

Method used by LOG_INFO and similar macros to process a log message with variable arguments along with associated metadata.

Parameters

logger	the logger
level	message level
location	message origin location
fmt	message format string

Definition at line 397 of file Log.cc.

               {
    va_list args;
    va_start(args, fmt);
    char msg[MAX_LOG_MSG_LEN];
    vsnprintf(msg, MAX_LOG_MSG_LEN, fmt, args);
    logger.logMsg(level, location, msg);
}

void lsst::log::Log::log	(	log4cxx::LevelPtr	level,
		log4cxx::spi::LocationInfo const &	location,
		char const *	fmt,
			...
	)

Method used by LOG_INFO and similar macros to process a log message with variable arguments along with associated metadata.

Parameters

level	message level
location	message origin location
fmt	message format string

Definition at line 382 of file Log.cc.

               {
    va_list args;
    va_start(args, fmt);
    char msg[MAX_LOG_MSG_LEN];
    vsnprintf(msg, MAX_LOG_MSG_LEN, fmt, args);
    logMsg(level, location, msg);
}

void lsst::log::Log::logMsg ( Log  logger, log4cxx::LevelPtr  level, log4cxx::spi::LocationInfo const &  location, std::string const &  msg  )

static

Method used by LOGS_INFO and similar macros to process a log message..

Parameters

logger	the logger
level	message level
location	message origin location
msg	message string

Definition at line 439 of file Log.cc.

                   {
    logger.logMsg(level, location, msg);
}

void lsst::log::Log::logMsg	(	log4cxx::LevelPtr	level,
		log4cxx::spi::LocationInfo const &	location,
		std::string const &	msg
	)

Method used by LOGS_INFO and similar macros to process a log message..

Parameters

level	message level
location	message origin location
msg	message string

Definition at line 412 of file Log.cc.

                   {

    // do one-time per-thread initialization, this was implemented
    // with thread_local initially but clang on OS X did not support it
    void *ptr = pthread_getspecific(::pthreadKey.key);
    if (ptr == nullptr) {

        // use pointer value as a flag, don't care where it points to
        ptr = static_cast<void*>(&::pthreadKey);
        pthread_setspecific(::pthreadKey.key, ptr);

        std::lock_guard<std::mutex> lock(mdcInitMutex);
                // call all functions in the MDC init list
        for (auto& fun: mdcInitFunctions) {
            fun();
        }
    }

    // forward everything to logger
    _logger->forcedLog(level, msg, location);
}

void lsst::log::Log::MDC ( std::string const &  key, std::string const &  value  )

static

Places a KEY/VALUE pair in the Mapped Diagnostic Context (MDC) for the current thread. The VALUE may then be included in log messages by using the following the X conversion character within a pattern layout as X{KEY}.

Parameters

key	Unique key.
value	String value.

Definition at line 318 of file Log.cc.

                                                          {
    log4cxx::MDC::put(key, value);
}

int lsst::log::Log::MDCRegisterInit ( std::function< void()>  function )

static

Definition at line 330 of file Log.cc.

                                                     {

    std::lock_guard<std::mutex> lock(mdcInitMutex);

    // logMsg may have been called already in this thread, to make sure that
    // this function is executed in this thread call it explicitly
    function();

    // store function for later use
    ::mdcInitFunctions.push_back(std::move(function));

    // return arbitrary number
    return 1;
}

void lsst::log::Log::MDCRemove ( std::string const &  key )

static

Remove the value associated with KEY within the MDC.

Parameters

key	Key identifying value to remove.

Definition at line 326 of file Log.cc.

                                        {
    log4cxx::MDC::remove(key);
}

void lsst::log::Log::popContext ( )

static

Pops the last pushed name off the global hierarchical default logger name.

Definition at line 300 of file Log.cc.

                     {
    // switch to parent logger, this assumes that loggers are not
    // re-parented between calls to push and pop
    log4cxx::LoggerPtr parent = _defaultLogger()->getParent();
    // root logger does not have parent, stay at root instead
    if (parent) {
        _defaultLogger() = parent;
    }
}

void lsst::log::Log::pushContext ( std::string const &  name )

static

Pushes NAME onto the global hierarchical default logger name.

Parameters

name	String to push onto logging context.

Definition at line 273 of file Log.cc.

                                           {
    // can't handle empty names
    if (name.empty()) {
        throw std::invalid_argument("lsst::log::Log::pushContext(): "
                "empty context name is not allowed");
    }
    // we do not allow multi-level context (logger1.logger2)
    if (name.find('.') != std::string::npos) {
        throw std::invalid_argument("lsst::log::Log::pushContext(): "
                "multi-level contexts are not allowed: " + name);
    }

    // Construct new default logger name
    std::string newName = _defaultLogger()->getName();
    if (newName == "root") {
        newName = name;
    } else {
        newName += ".";
        newName += name;
    }
    // Update defaultLogger
    _defaultLogger() = log4cxx::Logger::getLogger(newName);
}

void lsst::log::Log::setLevel

(

int

level

)

Set the logging threshold to LEVEL.

Parameters

level

New logging threshold.

Definition at line 349 of file Log.cc.

                            {
    _logger->setLevel(log4cxx::Level::toLevel(level));
}

Member Data Documentation

log4cxx::LoggerPtr lsst::log::Log::_logger

private

Definition at line 803 of file Log.h.

---

The documentation for this class was generated from the following files:

• /home/lsstsw/stack/Linux64/log/12.1.rc1-1-g83b2247/include/lsst/log/Log.h
• /home/lsstsw/stack/Linux64/log/12.1.rc1-1-g83b2247/src/Log.cc