---
title: "The logging framework (developer guide)"
manual: "TYPO3 Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3coreapi:logging@main"
source: "ApiOverview/Logging/Index.rst"
modified: "2026-09-15T12:49:12+00:00"
---

# The logging framework (developer guide)

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@main).

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

TYPO3 Logging consists of the following components:

-   A [Logger](https://docs.typo3.org/permalink/t3coreapi:logging-logger@main) that receives the log message and related
    details, like a severity.
-   A [LogRecord model](https://docs.typo3.org/permalink/t3coreapi:logging-model@main) which encapsulates the data
-   [Configuration](https://docs.typo3.org/permalink/t3coreapi:logging-configuration@main) of the logging system
-   [Writers](https://docs.typo3.org/permalink/t3coreapi:logging-writers@main) which write the log records to different
    targets (like file, database, rsyslog server, etc.)
-   [Processors](https://docs.typo3.org/permalink/t3coreapi:logging-processors@main) 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@main).

**Contents:**

-   [Quickstart](https://docs.typo3.org/permalink/t3coreapi:logging-quickstart@main)
-   [Logger](https://docs.typo3.org/permalink/t3coreapi:logger@main)
-   [Configuration](https://docs.typo3.org/permalink/t3coreapi:logging-configuration@main)
-   [The LogRecord model](https://docs.typo3.org/permalink/t3coreapi:the-logrecord-model@main)
-   [Log writers](https://docs.typo3.org/permalink/t3coreapi:log-writers@main)
-   [Log processors](https://docs.typo3.org/permalink/t3coreapi:log-processors@main)