---
title: "The logging framework (developer guide)"
manual: "TYPO3 Explained"
version: "12.4"
permalink: "https://docs.typo3.org/permalink/t3coreapi:logging@12.4"
source: "ApiOverview/Logging/Index.rst"
rendered: "2026-10-21T15:29:37+00:00"
---

> [!WARNING]
> **Attention**
>
> TYPO3 v12 has reached end-of-life as of April 30th 2026 and
> is no longer being maintained. Use the version switcher on the top
> left of this page to select documentation for a supported version of TYPO3.
>
> Need more time before upgrading?
> You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here:
> [TYPO3 ELTS](https://typo3.com/services/extended-support-elts).

# The logging framework (developer guide) {#logging}

This chapter is intended for **developers** who want to use the TYPO3 logging
framework in their extensions, middleware, or custom services.

It explains the internal architecture of the logging system and how to interact
with it programmatically.

If you're looking for production-level logging guidance (e.g., log rotation,
monitoring, or security), see:
[Logging considerations during production](https://docs.typo3.org/permalink/t3coreapi:production-logging@12.4).

The chapter [Quickstart: Writing to the logger from PHP](https://docs.typo3.org/permalink/t3coreapi:logging-quickstart@12.4) helps you get started.

TYPO3 Logging consists of the following components:

-   A [Logger](https://docs.typo3.org/permalink/t3coreapi:logging-logger@12.4) that receives the log message and related
    details, like a severity.
-   A [LogRecord model](https://docs.typo3.org/permalink/t3coreapi:logging-model@12.4) which encapsulates the data
-   [Configuration](https://docs.typo3.org/permalink/t3coreapi:logging-configuration@12.4) of the logging system
-   [Writers](https://docs.typo3.org/permalink/t3coreapi:logging-writers@12.4) which write the log records to different
    targets (like file, database, rsyslog server, etc.)
-   [Processors](https://docs.typo3.org/permalink/t3coreapi:logging-processors@12.4) which enhance the log record with
    more detailed information.

> [!NOTE]
> **See also**
>
> Are you looking for information on how to configure logging for production
> environments (log rotation, error monitoring, security)? See
> [Logging in production](https://docs.typo3.org/permalink/t3coreapi:production-logging@12.4).

**Contents:**

-   [Quickstart](https://docs.typo3.org/permalink/t3coreapi:quickstart-writing-to-the-logger-from-php@12.4)
-   [Logger](https://docs.typo3.org/permalink/t3coreapi:logger@12.4)
-   [Configuration](https://docs.typo3.org/permalink/t3coreapi:configuration-of-the-logging-system@12.4)
-   [The LogRecord model](https://docs.typo3.org/permalink/t3coreapi:the-logrecord-model@12.4)
-   [Log writers](https://docs.typo3.org/permalink/t3coreapi:log-writers@12.4)
-   [Log processors](https://docs.typo3.org/permalink/t3coreapi:log-processors@12.4)