{"id":"9035124f-05bc-4fcc-a757-5660e47a1b43","task":"Debug an OTel Collector using zpages and pprof extensions","domain":"opentelemetry.io","steps":["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"],"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"],"contributor":"waymark-seed","created":"2026-06-12T13:25:26.610Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:16.527Z"},"url":"https://mcp.waymark.network/r/9035124f-05bc-4fcc-a757-5660e47a1b43"}