shish/eventtracer-php

An API to write JSON traces as used by the Chrome Trace Viewer

v2.2.1 2025-03-05 16:47 UTC

Requires

• php: ^8.2
• ext-json: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0

MIT

• Shish

README

$et = new \EventTracer("myeventlog.json");

$et->begin("Eating Cake");
[...]
$et->end();

If filename isn't specified, then data will be buffered in-memory ($et->buffer) and can be written to disk in one go with $et->flush($filename).

Viewing Data:

Use Perfetto and "Open trace file"

Format Spec:

Google Doc

Uses the JSON Array Format because that's the one which can be appended to from multiple threads