Attention
TYPO3 v8 has reached its end-of-life March 31st, 2020 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.
There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.
The LogRecord model¶
All logging data is modeled using
\TYPO3\CMS\Core\Log\LogRecord
.
This model has the following properties:
- requestId
A unique identifier for each request which is created by the TYPO3 bootstrap.
- created
The micro-timestamp when the record is created.
- component
The name of the logger which created the LogRecord, usually the fully qualified class name where the Logger has been instanciated.
- level
An integer severity level from \TYPO3\CMS\Core\Log\LogLevel.
- message
The log message string.
- data
Any additional data, encapsulated within an array.
The API to create a new instance of LogRecord is
\TYPO3\CMS\Core\Log\Logger:log()
or one of the shorthand methods.
LogRecord
implements the ArrayAccess
interface so that the properties
can be accessed like a native array, for example: $logRecord['requestId']
.
It also implements a __toString()
method for your convenience,
which returns the log records as a simplified string.
A LogRecord
can be processed using LogProcessors
or LogWriters. LogProcessors
are meant to add values
to the data
property of LogRecord
. For example,
if you would like to add a stack trace, use
\TYPO3\CMS\Core\Log\Processor\IntrospectionProcessor
.
LogWriters
are used to write a LogRecord
to a particular target,
for example a log file.