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.