Mate Extensions

Container Introspection

symfony-services

Search the services of the compiled container.

Parameter	Description
query	Service ID or class name. Case-insensitive partial match.
tag	DI tag name, for example kernel.event_listener.
context	Kernel context. Only relevant with several cache directories.
limit	Maximum number of services per context. Default 100.

The result holds the matches under services, plus count and truncated. When the result is truncated, narrow the filter. Raising the limit only costs context. With several cache directories the services are grouped by context.

symfony-service-detail

Show one service by its exact id: class, tags, method calls, constructor or factory information and the definition flags debug:container reports (public, synthetic, lazy, shared, abstract, autowired, autoconfigured). Accepts context as well, and reports the context the service was found in.

Both tools fail with a clear error when no container was dumped yet. They never answer as if nothing matched.

1
2

$ vendor/bin/mate tools:call symfony-services --tag=kernel.event_listener
$ vendor/bin/mate tools:call symfony-service-detail --id=App\\Mailer\\Notifier

Configuration:

1
2

$container->parameters()
    ->set('ai_mate_symfony.cache_dir', '%mate.root_dir%/var/cache');

The extension looks for a *DebugContainer.xml file in the cache directory itself, then in its dev, test and prod subdirectories. Kernels with a custom class name are found too.

Profiler

The profiler tools are registered when symfony/http-kernel is installed. They need symfony/web-profiler-bundle to have profiles to read.

symfony-profiler-list

List profiles with summary data, most recent first.

Parameter	Description
limit	Maximum number of profiles. Default 20. Use 1 for the latest.
method	HTTP method.
url	URL path. Partial match.
ip	Client IP address.
statusCode	HTTP response status code.
from	Start of the time range.
to	End of the time range.
context	Kernel context. Only relevant with several profiler directories.

symfony-profiler-get

Get one profile by its token, with its metadata and the collectors it has.

Every profile carries a resource_uri that points at the full profile resource. With several profiler directories it also carries a context field.

Two resource templates hold the details:

symfony-profiler://profile/{token}

The profile metadata and the list of collectors, each with its own URI.

symfony-profiler://profile/{token}/{collector}

The data of one collector.

This split keeps large payloads out of the context window. The agent lists first, then reads only the collector that matters:

1
2
3
4
5
6
7
8

# Find the failed requests
$ vendor/bin/mate tools:call symfony-profiler-list --statusCode=500 --limit=5

# See which collectors that profile has
$ vendor/bin/mate resources:read symfony-profiler://profile/abc123

# Read one of them
$ vendor/bin/mate resources:read symfony-profiler://profile/abc123/exception

Collector formatters

A formatter reduces the raw collector data to what an agent needs for a diagnosis. The extension ships formatters for these collectors:

A collector without a formatter is exposed with its raw data.

To add a formatter for your own collector, implement Symfony\AI\Mate\Bridge\Symfony\Profiler\Service\CollectorFormatterInterface and tag the service with ai_mate.profiler_collector_formatter:

1
2
3
4

// mate/config.php
$container->services()
    ->set(MyCollectorFormatter::class)
        ->tag('ai_mate.profiler_collector_formatter');

getName() returns the collector name, getSummary() the short form shown in the profile, and format() the full data.

Redaction

The request formatter redacts cookies, session data, the raw request body, the reconstructed curl command, authentication headers and sensitive environment variables. A header, parameter or variable counts as sensitive when its name contains a word like password, token, secret, key, auth, credential, csrf or session. The raw data of a collector without a formatter goes through the same kind of key-based redaction.

Configuration:

1
2

$container->parameters()
    ->set('ai_mate_symfony.profiler_dir', '%mate.root_dir%/var/cache/dev/profiler');