Browsing profiles

The profiler UI endpoints, the debug headers linking a response to its profile, the built-in and custom list filters, and profile export.

Every profiled execution receives a unique token and lands in the profiler UI. This page covers the endpoints that expose the collected data, the debug headers that link a response to its profile, the list filters, and how to export a profile.

Profiler UI — profiles list with filters, HTTP statuses, durations and global panels

Profiler UI endpoints

Endpoint	Description
`GET /_profiler`	List of recent profiles (HTML)
`GET /_profiler/:token`	Profile detail page (HTML)
`GET /_profiler/:token/data`	Raw profile data (JSON)

Debug headers

Every non-profiler request receives response headers:

Header	Value
`X-Debug-Token`	The request token (UUID v4)
`X-Debug-Token-Link`	Link to `/_profiler/{token}`

List filters

The profile list supports server-side filtering via query parameters:

GET /_profiler?method=GET&minDuration=100&q=/api&statusClass=2

Parameter	Description
`type`	Request kind: `http` (REST), `command` (CLI), or `graphql` when the GraphQL package is installed
`method`	HTTP method (GET, POST, …)
`q`	Search across URL, GraphQL operation name and command name
`status`	Exact response status code
`statusClass`	Status class: `2`, `3`, `4` or `5` (matches 2xx…5xx)
`minDuration`	Minimum duration in ms
`maxDuration`	Maximum duration in ms
`hasExceptions`	When set, only profiles that captured an exception

Optional packages extend the filters — for example @eleven-labs/nest-profiler-graphql adds a GraphQL choice to the type select via registerFilterOption('type', …).

Custom list filters

Filters are pluggable. A filter is a ProfilerListFilter — it describes its own control, parses its raw query value and decides whether a profile matches:

import { ProfilerCoreService, ProfilerListFilter } from '@eleven-labs/nest-profiler';

const slowFilter: ProfilerListFilter<boolean> = {
  key: 'slow',
  label: 'Slow only',
  control: 'checkbox',
  // Checked boxes submit '1'; undefined keeps the filter inactive.
  parse: (raw) => (raw ? true : undefined),
  matches: (profile) => (profile.performance.duration ?? 0) >= 500,
};

core.registerListFilter(slowFilter); // core: ProfilerCoreService

or declaratively via the PROFILER_LIST_FILTERS multi-token:

{ provide: PROFILER_LIST_FILTERS, useValue: slowFilter, multi: true }

Export a profile

Every profile detail page has an Export JSON button. You can also download the raw profile directly:

curl http://localhost:3000/_profiler/{token}/data > profile.json

Visual tour — the Profiler UI page walks through the profiles list, every built-in tab and every collector panel with screenshots.