warsawmedia/newrelic-instrumentation

Improves New Relic transaction naming, grouping and custom parameters for TYPO3.

1.0.0 2026-04-09 20:58 UTC

Requires

• php: ^8.2
• typo3/cms-backend: ^13.4
• typo3/cms-core: ^13.4
• typo3/cms-extbase: ^13.4
• typo3/cms-frontend: ^13.4

GPL-2.0-or-later

• Adam Mroczek

• new relic
• typo3
• apm
• instrumentation

README

Improves New Relic transaction naming, grouping and custom parameters for TYPO3.

Features

• Better frontend transaction naming based on page ID and page type
• Optional frontend user tracing
• Optional tracing of Fluid parsing and rendering
• Optional tracing of Extbase controller and persistence activity
• Optional tracing of cache backend operations
• Optional tracing of backend DataHandler commands
• CLI transaction naming for TYPO3 commands

Requirements

• PHP 8.2+
• TYPO3 CMS 13.4 - 14.2
• PHP New Relic agent / extension installed and enabled

Installation

Install via Composer:

composer require warsawmedia/newrelic-instrumentation

Then activate the extension in TYPO3 if needed.

Configuration

Extension configuration is available in:

Admin Tools > Settings > Extension Configuration

Available options include:

• tracePageUid
• tracePageType
• traceDataHandlerCommands
• traceFluidParsing
• traceFluidRendering
• traceFrontendUsers
• traceFrontendUsersFields
• traceObjectInstancing
• traceExtbaseControllers
• traceExtbasePersistence
• traceCacheOperations

Example transaction names

Frontend

• FE
• FE/page-123-default
• FE/page-123-type98
• FE/login

Backend

• BE/command/delete
• BE/command/move
• BE/command/copy

CLI

• CLI/command/cache:flush
• CLI/command/scheduler:run

Notes

This extension enhances transaction naming and observability in TYPO3, but it does not replace New Relic server-side or infrastructure configuration.

The extension only becomes active when the PHP New Relic extension is loaded.

Compatibility

Version	TYPO3	PHP
1.x	13.4 - 14.2	8.2+

Support

• Source: GitHub repository
• Issues: GitHub issue tracker

License

GPL-2.0-or-later. See LICENSE.txt.