COREDNS-PPROF(7)

pprof 💅 (that's the CoreDNS plugin, bestie)

okay so this is the pprof plugin from CoreDNS — the manual-page energy is COREDNS-PPROF(7) and honestly? it's giving "debug era." lowkey essential, highkey something you don't wanna leave running forever. let's get into it 🫶

---

✨ NAME ✨

pprof — publishes runtime profiling data at endpoints under /debug/pprof. literally that's it, that's the whole vibe 🎀

---

🌸 DESCRIPTION 🌸

so you can just visit /debug/pprof on your site and get an index of all the available endpoints. cute, right? by default it listens on localhost:6053. no cap. 👑

🚨 real talk: this is a debugging tool. certain requests — like collecting execution traces — can be slow. if you use pprof on a live server, pls consider restricting access or enabling it only temporarily. do not leave the door wide open and then act surprised, i'm begging 😭

also important, bestie: this plugin can only be used once per Server Block. one per block, that's the rule. 💀

---

🦋 SYNTAX 🦋

pprof [ADDRESS]

optionally pprof takes an address; the default is localhost:6053.

and there's an extra option you can set with this extended syntax, iykyk:

pprof [ADDRESS] {
   block [RATE]
}

• block [RATE] — the block option enables block profiling, and RATE defaults to 1. RATE must be a positive value. for what block profiling actually entails, see the Diagnostics, chapter profiling ⟨https://golang.org/doc/diagnostics.html⟩ and runtime.SetBlockProfileRate ⟨https://golang.org/pkg/runtime/#SetBlockProfileRate⟩. go read the lore 📚

---

🧚 EXAMPLES 🧚

enable a pprof endpoint 🎀

. {
    pprof
}

and then use the pprof tool to get statistics: go tool pprof http://localhost:6053. slay ✨

listen on an alternate address 🌈

. {
    pprof 10.9.8.7:6060
}

listen on an all addresses on port 6060, and enable block profiling 🔥

. {
    pprof :6060 {
       block
    }
}

👑 three examples, three vibes. pick your main character energy.

---

💜 SEE ALSO 💜

• see Go's pprof documentation ⟨https://golang.org/pkg/net/http/pprof/⟩
• and Profiling Go Programs ⟨https://blog.golang.org/profiling-go-programs⟩
• see runtime.SetBlockProfileRate ⟨https://golang.org/pkg/runtime/#SetBlockProfileRate⟩ for background on block profiling 📖

---

okay that's the whole page, bestie — no skips, no cuts, every last detail is here 🍓 this was written by CoreDNS and it's the March 2026 version, so like… fresh off the press 💅 stay profiled, stay safe, and remember: debug endpoints are a privilege, not a personality trait 🫶✨