pprof — menemukan di mana waktunya habis

Menebak di mana aplikasi lambat hampir selalu salah. pprof memberi jawabannya dalam dua menit, dan ia sudah ada di dalam setiap binari Go tanpa dependensi apa pun.

Memasangnya dengan aman

import (
	"net/http"
	_ "net/http/pprof"      // mendaftarkan handler ke DefaultServeMux
)

// ❌ JANGAN: kalau handler utamamu memakai DefaultServeMux, seluruh
//    endpoint pprof jadi terbuka ke internet.

// ✅ Port terpisah yang hanya bisa dijangkau dari dalam VPC / sidecar.
func mulaiDebug(addr string, log *slog.Logger) {
	go func() {
		srv := &http.Server{
			Addr:              addr,           // "127.0.0.1:6060" atau port internal
			Handler:           http.DefaultServeMux,
			ReadHeaderTimeout: 5 * time.Second,
		}
		if err := srv.ListenAndServe(); err != nil &&
			!errors.Is(err, http.ErrServerClosed) {
			log.Error("server debug berhenti", "err", err)
		}
	}()
}

Profil yang tersedia

Mengambil dan membaca

# CPU selama 30 detik, langsung buka antarmuka web
go tool pprof -http=:8081 http://localhost:6060/debug/pprof/profile?seconds=30

# Heap saat ini
go tool pprof -http=:8081 http://localhost:6060/debug/pprof/heap

# Goroutine — versi teks paling cepat dibaca
curl -s 'http://localhost:6060/debug/pprof/goroutine?debug=1' | head -40

# Simpan dulu, analisis nanti (mis. dari produksi)
curl -o cpu.pprof 'http://localhost:6060/debug/pprof/profile?seconds=30'
go tool pprof -http=:8081 ./bin/server cpu.pprof

Pola yang khas dan artinya

Menemukan kebocoran goroutine

curl -s 'http://localhost:6060/debug/pprof/goroutine?debug=1' | head -5

goroutine profile: total 48213
41077 @ 0x43e1c5 0x44f3f8 0x7c2a41
#	0x7c2a40	contoh.com/toko/internal/notif.(*Pengirim).kirim+0x120

   ↑ 41.077 goroutine menumpuk di satu baris — ini kebocoran,
     bukan beban tinggi.

Membandingkan sebelum dan sesudah

go tool pprof -http=:8081 -base lama.pprof baru.pprof

Tampilannya jadi selisih: hijau untuk yang berkurang, merah untuk yang bertambah. Ini cara tercepat membuktikan sebuah optimasi benar-benar bekerja — dan cara tercepat menemukan regresi setelah deploy.

Profil terus-menerus di produksi

// Perekam terbang (flight recorder), stabil sejak Go 1.25: simpan jejak
// beberapa detik terakhir di memori, tulis HANYA saat sesuatu terjadi.
fr := trace.NewFlightRecorder(trace.FlightRecorderConfig{
	MinAge: 5 * time.Second,
})
_ = fr.Start()

// Di middleware: kalau ada permintaan yang sangat lambat, abadikan
// beberapa detik sebelum kejadiannya.
if durasi > 2*time.Second {
	var buf bytes.Buffer
	if _, err := fr.WriteTo(&buf); err == nil {
		simpanKeS3(ctx, buf.Bytes())
	}
}