Тип runtime.MemStats

Тип runtime.MemStats предоставляет детальную информацию о состоянии системы управления памятью Go. Он включает данные о распределении памяти, количестве объектов, времени сборки мусора и других важных метриках. Статистика заполняется при вызове функции runtime.ReadMemStats.

Синтаксис

goimport "runtime"

var stats runtime.MemStats
runtime.ReadMemStats(&stats)

Основные поля

Структура содержит множество полей, разделенных на логические группы:

gotype MemStats struct {
  Alloc    uint64 // bytes allocated and not yet freed
  TotalAlloc uint64 // bytes allocated (even if freed)
  Sys    uint64 // bytes obtained from system
  Lookups  uint64 // number of pointer lookups
  Mallocs  uint64 // number of mallocs
  Frees    uint64 // number of frees
  HeapAlloc  uint64 // heap bytes allocated and not freed
  HeapSys  uint64 // heap bytes obtained from system
  HeapIdle   uint64 // heap bytes waiting to be used
  HeapInuse  uint64 // heap bytes in use
  HeapReleased uint64 // heap bytes released to OS
  HeapObjects uint64 // number of allocated objects
  StackInuse uint64 // bytes used by stack allocator
  StackSys   uint64 // bytes obtained from system for stack
  MSpanInuse uint64 // bytes used by mspan structures
  MSpanSys   uint64 // bytes obtained for mspan structures
  MCacheInuse uint64 // bytes used by mcache structures
  MCacheSys  uint64 // bytes obtained for mcache structures
  BuckHashSys uint64 // bytes used by profiling bucket hash table
  GCSys    uint64 // bytes used for garbage collection metadata
  OtherSys   uint64 // bytes used for other system allocations
  NextGC   uint64 // next target heap size for GC
  LastGC   uint64 // time of last GC (nanoseconds since epoch)
  PauseTotalNs uint64 // total GC pause time
  PauseNs  [256]uint64 // circular buffer of GC pause times
  PauseEnd   [256]uint64 // circular buffer of GC pause end times
  NumGC    uint32 // number of completed GC cycles
  NumForcedGC uint32 // number of forced GC cycles
  GCCPUFraction float64 // fraction of CPU time used by GC
  EnableGC   bool // true if GC is enabled
  DebugGC  bool // true if debug GC is enabled
  BySize   [61]struct {
    Size uint32
    Mallocs uint64
    Frees   uint64
  }
}

Пример получения статистики

Получим основные показатели использования памяти:

gopackage main

import (
  "fmt"
  "runtime"
)

func main() {
  var stats runtime.MemStats
  runtime.ReadMemStats(&stats)

  fmt.Printf("Alloc = %d bytes\n", stats.Alloc)
  fmt.Printf("TotalAlloc = %d bytes\n", stats.TotalAlloc)
  fmt.Printf("Sys = %d bytes\n", stats.Sys)
  fmt.Printf("NumGC = %d\n", stats.NumGC)
}

Результат выполнения кода:

go"Alloc = 123456 bytes"
"TotalAlloc = 1234567 bytes"
"Sys = 2345678 bytes"
"NumGC = 42"

Пример мониторинга памяти

Отследим изменения памяти после выделения объектов:

gopackage main

import (
  "fmt"
  "runtime"
)

func main() {
  var stats runtime.MemStats
  
  runtime.ReadMemStats(&stats)
  before := stats.HeapAlloc

  // Allocate some memory
  s := make([]int, 1000000)
  for i := range s {
    s[i] = i
  }

  runtime.ReadMemStats(&stats)
  after := stats.HeapAlloc

  fmt.Printf("HeapAlloc before: %d bytes\n", before)
  fmt.Printf("HeapAlloc after: %d bytes\n", after)
  fmt.Printf("Difference: %d bytes\n", after-before)
}

Результат выполнения кода:

go"HeapAlloc before: 123456 bytes"
"HeapAlloc after: 8234567 bytes"
"Difference: 8111111 bytes"

Пример отслеживания сборки мусора

Проанализируем время и частоту сборок мусора:

gopackage main

import (
  "fmt"
  "runtime"
  "time"
)

func main() {
  var stats runtime.MemStats
  runtime.ReadMemStats(&stats)

  // Trigger GC manually
  runtime.GC()
  time.Sleep(100 * time.Millisecond)

  runtime.ReadMemStats(&stats)
  fmt.Printf("Number of GC cycles: %d\n", stats.NumGC)
  fmt.Printf("Total GC pause time: %d ns\n", stats.PauseTotalNs)
  fmt.Printf("Last GC time: %d ns\n", stats.LastGC)
  fmt.Printf("Next GC target: %d bytes\n", stats.NextGC)
}

Результат выполнения кода:

go"Number of GC cycles: 43"
"Total GC pause time: 12345678 ns"
"Last GC time: 1234567890123456 ns"
"Next GC target: 16777216 bytes"

Смотрите также