Profiling

For diagnosing CPU, memory, or contention issues, Smart Router can ship continuous profiles to Pyroscope, or expose Go's pprof server for one-off captures.

Continuous profiling (Pyroscope)

Point the router at a Pyroscope server and it streams CPU, heap, goroutine, mutex, and block profiles continuously:

smartrouter config.yml --use-static-spec specs/ \
  --pyroscope-address http://pyroscope:4040 \
  --pyroscope-app-name smartrouter \
  --pyroscope-tags "instance=router-1,region=us-east"

Flag	Default	Purpose
--pyroscope-address	—	Pyroscope server URL. Profiling is off until this is set.
--pyroscope-app-name	smartrouter	Application name shown in Pyroscope.
--pyroscope-tags	—	Comma-separated key=value tags (instance, region, …) for filtering.
--pyroscope-mutex-profile-fraction	5	Mutex profile sampling rate (1 in N events).
--pyroscope-block-profile-rate	1	Block profile rate (ns; 1 records all blocking events).

The tags are how you separate replicas in the Pyroscope UI — set at least instance when you run more than one router.

One-off profiling (pprof)

Without a Pyroscope server, expose Go's standard pprof HTTP server and capture profiles on demand:

smartrouter config.yml --use-static-spec specs/ --pprof-address localhost:6060

# capture a 30s CPU profile
go tool pprof http://localhost:6060/debug/pprof/profile?seconds=30

Bind it to localhost (or behind your network controls) — the pprof endpoints are unauthenticated.