The LogRecord model¶
All logging data is modeled using \TYPO3\CMS\Core\Log\LogRecord.
This model has the following properties:
- A unique identifier for each request which is created by the TYPO3 bootstrap.
- The micro-timestamp when the record is created.
- The name of the logger which created the LogRecord, usually the fully qualified class name where the Logger has been instanciated.
- An integer severity level from \TYPO3\CMS\Core\Log\LogLevel.
- The log message string.
- 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:
It also implements a
__toString() method for your convenience,
which returns the log records as a simplified string.
LogRecord can be processed using LogProcessors
LogProcessors are meant to add values
data property of
LogRecord. For example,
if you would like to add a stack trace, use
LogWriters are used to write a
LogRecord to a particular target,
for example a log file.