README

TYPO3 extension typo3_request_profiler

A dev-only TYPO3 frontend request profiler. It instruments live frontend requests and writes one compact JSON profile per request (SQL queries, N+1 patterns, cache state, and timing) to var/log/profiles/{request_id}.json.

Important

This extension is active by default only in a Development context (Environment::getContext()->isDevelopment()). Outside Development it stays off and collects no data unless explicitly opted in; see Activation.

The profiler is a thin, standalone collector with no external dependencies. It is inspired by the Symfony Profiler and by some of the metrics the TYPO3 Admin Panel surfaces, but records them as compact, machine-readable JSON instead of an interactive panel.

✨ Features

• Timing and memory: wall-clock and SQL timing, peak memory usage, included PHP file count
• Query analysis: full query count, top slow queries, and N+1 duplicate detection
• Outgoing HTTP client calls: count, total time, and the slowest requests
• Cache state: hit/miss with disabled reasons
• Log activity: count by level and the noisiest components
• Optional query tracing: call-site origin (Class::method (file:line)) for every flagged query, see Configuration
• Optional PSR-14 event timing: count and the most expensive event classes, see Configuration
• Uncaught exceptions: class, file, and line, never the message, even though no response was produced

🔥 Installation

Requirements

• TYPO3 13.4 LTS & 14.0+
• PHP 8.2+
• Doctrine DBAL 3.x or 4.x

Composer

composer require --dev konradmichalik/typo3-request-profiler

TER

Download the zip file from TYPO3 extension repository (TER).

🚀 Quick start

Start it up in a Development context (no configuration needed) and every request writes a compact JSON profile to var/log/profiles/{request_id}.json:

{
  "schemaVersion": 1,
  "token": "<RequestId>",
  "url": "https://example.ddev.site/",
  "status": 200,
  "meta": { "activationMode": "context" },
  "timing": { "total_ms": 142.5 },
  "queries": { "count": 101, "total_ms": 38.2 },
  "slow_queries": [
    { "sql": "SELECT * FROM pages WHERE slug = ? ORDER BY slug desc", "ms": 12.4 }
  ]
}

That's the gist. The full artifact also carries cache state, memory usage, PHP include count, N+1 duplicate-query detection, log activity, and optional PSR-14 event timing. See Profile Format for the complete schema.

🔗 Related

• typo3-ai-mate: a symfony/ai-mate bridge that serves these profiles to AI coding assistants over MCP

📚 Documentation

🧑‍💻 Contributing

Please have a look at CONTRIBUTING.md.

⭐ License

This project is licensed under GNU General Public License 2.0 (or later).