0 follower

CLogger

Package system.logging
Inheritance class CLogger » CComponent
Since 1.0
Version $Id$
Source Code framework/logging/CLogger.php
CLogger records log messages in memory.

CLogger implements the methods to retrieve the messages with various filter conditions, including log levels and log categories.

Public Properties

Hide inherited properties

PropertyTypeDescriptionDefined By
executionTime float Returns the total time for serving the current request. CLogger
logs array Retrieves log messages. CLogger
memoryUsage integer Returns the memory usage of the current application. CLogger
profilingResults array Returns the profiling results. CLogger

Public Methods

Hide inherited methods

MethodDescriptionDefined By
__call() Calls the named method which is not a class method. CComponent
__get() Returns a property value, an event handler list or a behavior based on its name. CComponent
__isset() Checks if a property value is null. CComponent
__set() Sets value of a component property. CComponent
__unset() Sets a component property to be null. CComponent
asa() Returns the named behavior object. CComponent
attachBehavior() Attaches a behavior to this component. CComponent
attachBehaviors() Attaches a list of behaviors to the component. CComponent
attachEventHandler() Attaches an event handler to an event. CComponent
canGetProperty() Determines whether a property can be read. CComponent
canSetProperty() Determines whether a property can be set. CComponent
detachBehavior() Detaches a behavior from the component. CComponent
detachBehaviors() Detaches all behaviors from the component. CComponent
detachEventHandler() Detaches an existing event handler. CComponent
disableBehavior() Disables an attached behavior. CComponent
disableBehaviors() Disables all behaviors attached to this component. CComponent
enableBehavior() Enables an attached behavior. CComponent
enableBehaviors() Enables all behaviors attached to this component. CComponent
getEventHandlers() Returns the list of attached event handlers for an event. CComponent
getExecutionTime() Returns the total time for serving the current request. CLogger
getLogs() Retrieves log messages. CLogger
getMemoryUsage() Returns the memory usage of the current application. CLogger
getProfilingResults() Returns the profiling results. CLogger
hasEvent() Determines whether an event is defined. CComponent
hasEventHandler() Checks whether the named event has attached handlers. CComponent
hasProperty() Determines whether a property is defined. CComponent
log() Logs a message. CLogger
raiseEvent() Raises an event. CComponent

Property Details

executionTime property read-only
public float getExecutionTime()

Returns the total time for serving the current request. This method calculates the difference between now and the timestamp defined by constant YII_BEGIN_TIME. To estimate the execution time more accurately, the constant should be defined as early as possible (best at the beginning of the entry script.)

logs property read-only
public array getLogs(string $levels='', string $categories='')

Retrieves log messages.

Messages may be filtered by log levels and/or categories. A level filter is specified by a list of levels separated by comma or space (e.g. 'trace, error'). A category filter is similar to level filter (e.g. 'system, system.web'). A difference is that in category filter you can use pattern like 'system.*' to indicate all categories starting with 'system'.

If you do not specify level filter, it will bring back logs at all levels. The same applies to category filter.

Level filter and category filter are combinational, i.e., only messages satisfying both filter conditions will be returned.

memoryUsage property read-only
public integer getMemoryUsage()

Returns the memory usage of the current application. This method relies on the PHP function memory_get_usage(). If it is not available, the method will attempt to use OS programs to determine the memory usage. A value 0 will be returned if the memory usage can still not be determined.

profilingResults property read-only (available since v1.0.6)
public array getProfilingResults(string $token=NULL, string $category=NULL, boolean $refresh=false)

Returns the profiling results. The results may be filtered by token and/or category. If no filter is specified, the returned results would be an array with each element being array($token,$category,$time). If a filter is specified, the results would be an array of timings.

Method Details

getExecutionTime() method
public float getExecutionTime()
{return} float the total time for serving the current request.
Source Code: framework/logging/CLogger.php#138 (show)
public function getExecutionTime()
{
    return 
microtime(true)-YII_BEGIN_TIME;
}

Returns the total time for serving the current request. This method calculates the difference between now and the timestamp defined by constant YII_BEGIN_TIME. To estimate the execution time more accurately, the constant should be defined as early as possible (best at the beginning of the entry script.)

getLogs() method
public array getLogs(string $levels='', string $categories='')
$levels string level filter
$categories string category filter
{return} array list of messages. Each array elements represents one message with the following structure: array( [0] => message (string) [1] => level (string) [2] => category (string) [3] => timestamp (float, obtained by microtime(true));
Source Code: framework/logging/CLogger.php#87 (show)
public function getLogs($levels='',$categories='')
{
    
$this->_levels=preg_split('/[\s,]+/',strtolower($levels),-1,PREG_SPLIT_NO_EMPTY);
    
$this->_categories=preg_split('/[\s,]+/',strtolower($categories),-1,PREG_SPLIT_NO_EMPTY);
    if(empty(
$levels) && empty($categories))
        return 
$this->_logs;
    else if(empty(
$levels))
        return 
array_values(array_filter(array_filter($this->_logs,array($this,'filterByCategory'))));
    else if(empty(
$categories))
        return 
array_values(array_filter(array_filter($this->_logs,array($this,'filterByLevel'))));
    else
    {
        
$ret=array_values(array_filter(array_filter($this->_logs,array($this,'filterByLevel'))));
        return 
array_values(array_filter(array_filter($ret,array($this,'filterByCategory'))));
    }
}

Retrieves log messages.

Messages may be filtered by log levels and/or categories. A level filter is specified by a list of levels separated by comma or space (e.g. 'trace, error'). A category filter is similar to level filter (e.g. 'system, system.web'). A difference is that in category filter you can use pattern like 'system.*' to indicate all categories starting with 'system'.

If you do not specify level filter, it will bring back logs at all levels. The same applies to category filter.

Level filter and category filter are combinational, i.e., only messages satisfying both filter conditions will be returned.

getMemoryUsage() method
public integer getMemoryUsage()
{return} integer memory usage of the application (in bytes).
Source Code: framework/logging/CLogger.php#151 (show)
public function getMemoryUsage()
{
    if(
function_exists('memory_get_usage'))
        return 
memory_get_usage();
    else
    {
        
$output=array();
        if(
strncmp(PHP_OS,'WIN',3)===0)
        {
            
exec('tasklist /FI "PID eq ' getmypid() . '" /FO LIST',$output);
            return isset(
$output[5])?preg_replace('/[\D]/','',$output[5])*1024 0;
        }
        else
        {
            
$pid=getmypid();
            
exec("ps -eo%mem,rss,pid | grep $pid"$output);
            
$output=explode("  ",$output[0]);
            return isset(
$output[1]) ? $output[1]*1024 0;
        }
    }
}

Returns the memory usage of the current application. This method relies on the PHP function memory_get_usage(). If it is not available, the method will attempt to use OS programs to determine the memory usage. A value 0 will be returned if the memory usage can still not be determined.

getProfilingResults() method (available since v1.0.6)
public array getProfilingResults(string $token=NULL, string $category=NULL, boolean $refresh=false)
$token string token filter. Defaults to null, meaning not filtered by token.
$category string category filter. Defaults to null, meaning not filtered by category.
$refresh boolean whether to refresh the internal timing calculations. If false, only the first time calling this method will the timings be calculated internally.
{return} array the profiling results.
Source Code: framework/logging/CLogger.php#186 (show)
public function getProfilingResults($token=null,$category=null,$refresh=false)
{
    if(
$this->_timings===null || $refresh)
        
$this->calculateTimings();
    if(
$token===null && $category===null)
        return 
$this->_timings;
    
$results=array();
    foreach(
$this->_timings as $timing)
    {
        if((
$category===null || $timing[1]===$category) && ($token===null || $timing[0]===$token))
            
$results[]=$timing[2];
    }
    return 
$results;
}

Returns the profiling results. The results may be filtered by token and/or category. If no filter is specified, the returned results would be an array with each element being array($token,$category,$time). If a filter is specified, the results would be an array of timings.

log() method
public void log(string $message, string $level='info', string $category='application')
$message string message to be logged
$level string level of the message (e.g. 'Trace', 'Warning', 'Error'). It is case-insensitive.
$category string category of the message (e.g. 'system.web'). It is case-insensitive.
Source Code: framework/logging/CLogger.php#56 (show)
public function log($message,$level='info',$category='application')
{
    
$this->_logs[]=array($message,$level,$category,microtime(true));
}

Logs a message. Messages logged by this method may be retrieved back via getLogs.

See Also