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

Support

• Source: GitHub repository
• Issues: GitHub issue tracker

License

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