Go performance: pprof + escape analysis

⏱ 13 min·⭐ 55 XP

Pré-requisitos (0/1)0%

⬜📐 Generics em Go (1.18+)(Go Profissional)

Recomendamos completar os pré-requisitos antes de seguir, mas nada te impede de continuar.

Ferramentas built-in são surpreendentemente boas

🗺️ O ciclo de otimização, na ordem que funciona

1 · Medir antesperfil ou benchmark

Sem número inicial não existe comparação, e "ficou mais rápido" vira opinião.

LER

▼

2 · Ler o gráfico de chamadasonde o tempo está

O gargalo raramente é onde a intuição aponta. Largura no gráfico é tempo, não complexidade.

ISOLAR

▼

3 · Olhar alocação, não só tempoperfil de memória

Muitas vezes o custo é o coletor de lixo trabalhando, e a correção é evitar que o valor escape para o heap.

CORRIGIR

▼

4 · Corrigir UM pontoo caminho quente

Duas mudanças ao mesmo tempo impedem saber qual funcionou.

MEDIR

▼

5 · Medir de novomesmo benchmark

É aqui que metade das otimizações se revela neutra — e são revertidas, porque custaram legibilidade.

pprof, benchmark (testing.B), race detector, trace, escape analysis, flight-style tracing — tudo vem no binário do go. Você não precisa de APM pago para diagnosticar 90% dos gargalos. Basta saber ler o output.

Benchmark no testing.B

func BenchmarkParseJSON(b *testing.B) {
    data := []byte(sample)
    b.ReportAllocs()
    b.ResetTimer()
    for i := 0; i < b.N; i++ {
        var u User
        if err := json.Unmarshal(data, &u); err != nil {
            b.Fatal(err)
        }
    }
}

// go test -bench=. -benchmem
// BenchmarkParseJSON-8   500000   3120 ns/op   512 B/op   7 allocs/op

B/op e allocs/op são mais reveladores que ns/op. Alocação domina custo em serviços de alto throughput.

Escape analysis

// go build -gcflags="-m=2" ./...
func makeUser(name string) *User {
    u := User{Name: name}
    return &u          // "moved to heap: u" (escapa via return)
}

func usesUser(name string) int {
    u := User{Name: name}
    return len(u.Name) // "u does not escape" → stack
}

💡

Interfaces fazem escape (valor precisa ir para heap para caber no par tipo/valor). Passar slice por valor copia header (barato), passar struct grande por valor copia tudo — use ponteiro em struct > 64 bytes.

pprof: CPU profile

// Em main.go
import _ "net/http/pprof"

go func() {
    log.Println(http.ListenAndServe("127.0.0.1:6060", nil))
}()

# Coletar 30s de CPU profile em produção
go tool pprof -http=:9000 http://prod:6060/debug/pprof/profile?seconds=30

# Heap live
go tool pprof -http=:9000 http://prod:6060/debug/pprof/heap

# Goroutines (detectar leak)
curl http://prod:6060/debug/pprof/goroutine?debug=1 | less

Quiz rápido

O que a análise de escape responde, e por que isso importa para desempenho?

sync.Pool no caminho certo

var bufPool = sync.Pool{
    New: func() any { return new(bytes.Buffer) },
}

func writeResponse(w io.Writer, v any) error {
    buf := bufPool.Get().(*bytes.Buffer)
    defer func() {
        buf.Reset()
        bufPool.Put(buf)
    }()
    if err := json.NewEncoder(buf).Encode(v); err != nil {
        return err
    }
    _, err := buf.WriteTo(w)
    return err
}

⚠️

Pool esquece objetos entre GC runs — não conte com identidade. Reset obrigatório no Put, senão vaza estado entre requests.

sync/atomic para contadores lock-free

type Metrics struct {
    Requests atomic.Int64
    Errors   atomic.Int64
}

m.Requests.Add(1)
r := m.Requests.Load()

Fluxo real de otimização

✅

1) Meça com benchmark ou pprof em staging. 2) Leia o flamegraph, encontre top CPU/alocação. 3) Corrija o hot path (reduzir escape, pool, atomic, evitar interface em loop). 4) Re-benchmark. Sem medir, você adivinha — e geralmente erra.

Perguntas frequentes

❓ Como investigar desempenho em Go?

Com o perfilador embutido, em CPU, memória, rotinas e contenção de trava — e sempre a partir de carga representativa. A ordem que funciona é medir, achar o ponto quente e só então otimizar; sem medição, a intuição erra a maior parte das vezes.

❓ O que é análise de escape e por que importa?

É o compilador decidir se um valor fica na pilha ou vai para o monte. Valor que escapa para o monte cria trabalho para o coletor. Reduzir alocação em caminho quente é a otimização com melhor retorno em Go, e a análise mostra onde ela acontece.

❓ Reduzir alocação vale sempre a pena?

Vale no caminho quente e não vale no resto — código torturado para evitar alocação em caminho frio é complexidade sem retorno. Reutilização de buffer com reservatório é a técnica padrão, e ela só se justifica onde o perfil mostrou o custo.

Fixando

Quiz rápido

Ao adotar um pool de buffers, qual é o cuidado obrigatório?

Quiz rápido

Qual é o fluxo de otimização recomendado?

Terminou de ler?

Marcar como concluído registra o XP, mantém sua sequência e coloca 3 cartas deste módulo na fila de revisão espaçada.

Próximos passos sugeridos

🏁

Capstone: CLI tool + API Go idiomática

Go Profissional · 18 min · +85 XP

→

Temas deste módulo

Discussão

Carregando comentários…

Go performance: pprof + escape analysis

⏱ 13 min·⭐ 55 XP

Pré-requisitos (0/1)0%

⬜📐 Generics em Go (1.18+)(Go Profissional)

Recomendamos completar os pré-requisitos antes de seguir, mas nada te impede de continuar.

Ferramentas built-in são surpreendentemente boas

🗺️ O ciclo de otimização, na ordem que funciona

1 · Medir antesperfil ou benchmark

Sem número inicial não existe comparação, e "ficou mais rápido" vira opinião.

LER

▼

2 · Ler o gráfico de chamadasonde o tempo está

O gargalo raramente é onde a intuição aponta. Largura no gráfico é tempo, não complexidade.

ISOLAR

▼

3 · Olhar alocação, não só tempoperfil de memória

Muitas vezes o custo é o coletor de lixo trabalhando, e a correção é evitar que o valor escape para o heap.

CORRIGIR

▼

4 · Corrigir UM pontoo caminho quente

Duas mudanças ao mesmo tempo impedem saber qual funcionou.

MEDIR

▼

5 · Medir de novomesmo benchmark

É aqui que metade das otimizações se revela neutra — e são revertidas, porque custaram legibilidade.

Benchmark no testing.B

func BenchmarkParseJSON(b *testing.B) {
    data := []byte(sample)
    b.ReportAllocs()
    b.ResetTimer()
    for i := 0; i < b.N; i++ {
        var u User
        if err := json.Unmarshal(data, &u); err != nil {
            b.Fatal(err)
        }
    }
}

// go test -bench=. -benchmem
// BenchmarkParseJSON-8   500000   3120 ns/op   512 B/op   7 allocs/op

B/op e allocs/op são mais reveladores que ns/op. Alocação domina custo em serviços de alto throughput.

Escape analysis

// go build -gcflags="-m=2" ./...
func makeUser(name string) *User {
    u := User{Name: name}
    return &u          // "moved to heap: u" (escapa via return)
}

func usesUser(name string) int {
    u := User{Name: name}
    return len(u.Name) // "u does not escape" → stack
}

💡

pprof: CPU profile

// Em main.go
import _ "net/http/pprof"

go func() {
    log.Println(http.ListenAndServe("127.0.0.1:6060", nil))
}()

# Coletar 30s de CPU profile em produção
go tool pprof -http=:9000 http://prod:6060/debug/pprof/profile?seconds=30

# Heap live
go tool pprof -http=:9000 http://prod:6060/debug/pprof/heap

# Goroutines (detectar leak)
curl http://prod:6060/debug/pprof/goroutine?debug=1 | less

Quiz rápido

O que a análise de escape responde, e por que isso importa para desempenho?

sync.Pool no caminho certo

var bufPool = sync.Pool{
    New: func() any { return new(bytes.Buffer) },
}

func writeResponse(w io.Writer, v any) error {
    buf := bufPool.Get().(*bytes.Buffer)
    defer func() {
        buf.Reset()
        bufPool.Put(buf)
    }()
    if err := json.NewEncoder(buf).Encode(v); err != nil {
        return err
    }
    _, err := buf.WriteTo(w)
    return err
}

⚠️

Pool esquece objetos entre GC runs — não conte com identidade. Reset obrigatório no Put, senão vaza estado entre requests.

sync/atomic para contadores lock-free

type Metrics struct {
    Requests atomic.Int64
    Errors   atomic.Int64
}

m.Requests.Add(1)
r := m.Requests.Load()

Fluxo real de otimização

✅

Perguntas frequentes

❓ Como investigar desempenho em Go?

❓ O que é análise de escape e por que importa?

❓ Reduzir alocação vale sempre a pena?

Fixando

Quiz rápido

Ao adotar um pool de buffers, qual é o cuidado obrigatório?

Quiz rápido

Qual é o fluxo de otimização recomendado?

Terminou de ler?

Marcar como concluído registra o XP, mantém sua sequência e coloca 3 cartas deste módulo na fila de revisão espaçada.

Próximos passos sugeridos

🏁

Capstone: CLI tool + API Go idiomática

Go Profissional · 18 min · +85 XP

→

Temas deste módulo

Discussão

Carregando comentários…