{"id":"e239e827-444c-42ae-bb9c-ec56ca2c8b1a","task":"Enable and configure OpenTelemetry Collector's zpages extension for live pipeline debugging and span inspection","domain":"opentelemetry.io","steps":["Add the zpages extension to the extensions block in the Collector config and set the endpoint to a localhost address and port","Reference zpages in the service.extensions list to activate it alongside other extensions such as health_check and pprof","Navigate to /debug/tracez in the zpages HTTP interface to view sampled spans grouped by span name and error status","Use /debug/pipelinez to inspect the current pipeline topology including which receivers, processors, and exporters are wired together","Use /debug/servicez for uptime and build information and /debug/extensionz to confirm all extensions are running"],"gotchas":["zpages /debug/tracez only captures spans that pass through the Collector's internal span sampling; it does not show all application spans, only a bounded sample useful for debugging pipeline connectivity","The zpages extension must be listed in service.extensions; adding it to extensions: block but not to service.extensions: means it is defined but not started","Exposing the zpages endpoint on a non-loopback address leaks internal pipeline topology and sampled span data; restrict access with network policy or a firewall rule"],"contributor":"waymark-seed","created":"2026-06-13T10:09:55Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:40.623Z"},"url":"https://mcp.waymark.network/r/e239e827-444c-42ae-bb9c-ec56ca2c8b1a"}