Add both extensions to the extensions block in config.yaml: zpages with endpoint: 0.0.0.0:55679 and pprof with endpoint: 0.0.0.0:1777; then list both under service.extensions so they are activated
Access zpages in a browser or via curl at http://localhost:55679/debug/pipelinez to see live per-pipeline stats (spans/sec accepted, refused, dropped); /debug/servicez shows Collector version and uptime; /debug/extensionz lists active extensions
Use /debug/tracez (if the Collector is built with trace support) to inspect sample trace data flowing through the Collector without sending it to a backend
For CPU profiling, use go tool pprof http://localhost:1777/debug/pprof/profile?seconds=30 to capture a 30-second CPU profile; analyse with go tool pprof -http :8090 to open a web-based flame graph in your browser
For memory profiling (heap), run go tool pprof http://localhost:1777/debug/pprof/heap; look for large allocations in the batch processor or receivers that may indicate buffer misconfiguration or a memory leak
Restrict both extension endpoints to localhost or an internal network—do not expose port 1777 or 55679 on public interfaces since pprof can leak sensitive runtime information and zpages exposes pipeline internals
Known gotchas
zpages and pprof are not enabled by activating them in the extensions block alone; they must also appear in service.extensions list—omitting them from service.extensions means the extensions are declared but never started
pprof profiles add runtime overhead (especially CPU profiling at high sampling rates); run profiling during off-peak hours or against a non-production Collector instance to avoid impacting telemetry throughput
zpages counters reset on Collector restart and are not persisted; use them for live debugging during an active incident, not as a long-term metrics source—rely on the Prometheus internal metrics endpoint for persistent health data
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp