Еталонні показники та профілі

Окрім функціональних тестів, go test також має вбудовані тести (BenchmarkXxx) і підтримує профілі ЦП і пам’яті (pprof). Все без зовнішніх залежностей.

Форма репера

func BenchmarkSum(b *testing.B) {
    for i := 0; i < b.N; i++ {
        _ = Sum(2, 3)
    }
}

Характеристики:

• Точний підпис: func BenchmarkXxx(b *testing.B).
• Цикл має виконуватися b.N ітерацій: фреймворк налаштовує b.N автоматично, починаючи з 1 і збільшуючи, доки вимірювання не стабілізується (~1 секунда за замовчуванням).
• Результат ns/op (наносекунди на операцію), а з -benchmem також B/op і allocs/op.

Типові команди

go test -bench=. ./...              # all benchmarks
go test -bench=Sum -benchmem        # only Sum, with memory info
go test -bench=. -benchtime=5s      # each benchmark for 5 seconds
go test -bench=. -cpuprofile=cpu.out # generate a CPU profile

Типовий вихід:

BenchmarkSum-8        1000000000        0.31 ns/op

-8 це значення GOMAXPROCS. 0.31 ns/op середній час виклику.

Дороге налаштування: b.ResetTimer

Якщо у вас довгий етап підготовки перед петлею, виключіть його з вимірювання:

func BenchmarkSearch(b *testing.B) {
    data := buildLargeSlice(1_000_000) // expensive
    b.ResetTimer()
    for i := 0; i < b.N; i++ {
        _ = Search(data, 42)
    }
}

Корисні варіанти:

• b.StopTimer() / b.StartTimer() — призупинити вимірювання навколо нецікавої фази (зручно всередині циклу).
• b.ReportAllocs() — примусове звітування про розподіл навіть без -benchmem.

Таблиця порівняння з b.Run

Так само, як t.Run для тестів, існує b.Run для параметричних тестів:

func BenchmarkSplit(b *testing.B) {
    for _, size := range []int{10, 1000, 100000} {
        b.Run(fmt.Sprintf("n=%d", size), func(b *testing.B) {
            s := strings.Repeat("a,", size)
            b.ResetTimer()
            for i := 0; i < b.N; i++ {
                _ = strings.Split(s, ",")
            }
        })
    }
}

Виведіть такі рядки, як BenchmarkSplit/n=10-8, BenchmarkSplit/n=1000-8, ... ідеально підходить для масштабування діаграм.

Порівняння двох реалізацій із benchstat

go test -bench=. -count=10 > old.txt
# apply change
go test -bench=. -count=10 > new.txt
benchstat old.txt new.txt

benchstat (у golang.org/x/perf/cmd/benchstat) обчислює середнє значення, стандартне відхилення та статистичну значущість різниці.

вправи

$ go test ???