Skip to content

Go Runtime Metrics and Go Version Mapping

This page helps you to quickly query when a metric of runtime/metrics was supported. For example, you can query the table to know metrics /gc/gogc:percent was added in go1.21.0

Runtime Metrics Table

Metric Name Initial Supported Go Version
/cgo/go-to-c-calls:calls go1.19
/cpu/classes/gc/mark/assist:cpu-seconds go1.20
/cpu/classes/gc/mark/dedicated:cpu-seconds go1.20
/cpu/classes/gc/mark/idle:cpu-seconds go1.20
/cpu/classes/gc/pause:cpu-seconds go1.20
/cpu/classes/gc/total:cpu-seconds go1.20
/cpu/classes/idle:cpu-seconds go1.20
/cpu/classes/scavenge/assist:cpu-seconds go1.20
/cpu/classes/scavenge/background:cpu-seconds go1.20
/cpu/classes/scavenge/total:cpu-seconds go1.20
/cpu/classes/total:cpu-seconds go1.20
/cpu/classes/user:cpu-seconds go1.20
/gc/cycles/automatic:gc-cycles go1.16
/gc/cycles/forced:gc-cycles go1.16
/gc/cycles/total:gc-cycles go1.16
/gc/gogc:percent go1.21.0
/gc/gomemlimit:bytes go1.21.0
/gc/heap/allocs-by-size:bytes go1.16
/gc/heap/allocs:bytes go1.17
/gc/heap/allocs:objects go1.17
/gc/heap/frees-by-size:bytes go1.16
/gc/heap/frees:bytes go1.17
/gc/heap/frees:objects go1.17
/gc/heap/goal:bytes go1.16
/gc/heap/live:bytes go1.21.0
/gc/heap/objects:objects go1.16
/gc/heap/tiny/allocs:objects go1.17
/gc/limiter/last-enabled:gc-cycle go1.19
/gc/pauses:seconds go1.16
/gc/scan/globals:bytes go1.21.0
/gc/scan/heap:bytes go1.21.0
/gc/scan/stack:bytes go1.21.0
/gc/scan/total:bytes go1.21.0
/gc/stack/starting-size:bytes go1.19
/godebug/non-default-behavior/allowmultiplevcs:events go1.25.0
/godebug/non-default-behavior/asynctimerchan:events go1.23.0
/godebug/non-default-behavior/containermaxprocs:events go1.25.0
/godebug/non-default-behavior/embedfollowsymlinks:events go1.25.0
/godebug/non-default-behavior/execerrdot:events go1.21.0
/godebug/non-default-behavior/gocachehash:events go1.21.0
/godebug/non-default-behavior/gocachetest:events go1.21.0
/godebug/non-default-behavior/gocacheverify:events go1.21.0
/godebug/non-default-behavior/gotestjsonbuildtext:events go1.24.0
/godebug/non-default-behavior/gotypesalias:events go1.22.0
/godebug/non-default-behavior/http2client:events go1.21.0
/godebug/non-default-behavior/http2server:events go1.21.0
/godebug/non-default-behavior/httplaxcontentlength:events go1.22.0
/godebug/non-default-behavior/httpmuxgo121:events go1.22.0
/godebug/non-default-behavior/httpservecontentkeepheaders:events go1.23.0
/godebug/non-default-behavior/installgoroot:events go1.21.0
/godebug/non-default-behavior/jstmpllitinterp:events go1.21.0
/godebug/non-default-behavior/multipartmaxheaders:events go1.21.0
/godebug/non-default-behavior/multipartmaxparts:events go1.21.0
/godebug/non-default-behavior/multipathtcp:events go1.21.0
/godebug/non-default-behavior/netedns0:events go1.23.0
/godebug/non-default-behavior/panicnil:events go1.21.0
/godebug/non-default-behavior/randautoseed:events go1.21.0
/godebug/non-default-behavior/randseednop:events go1.24.0
/godebug/non-default-behavior/rsa1024min:events go1.24.0
/godebug/non-default-behavior/tarinsecurepath:events go1.21.0
/godebug/non-default-behavior/tls10server:events go1.22.0
/godebug/non-default-behavior/tls3des:events go1.23.0
/godebug/non-default-behavior/tlsmaxrsasize:events go1.22.0
/godebug/non-default-behavior/tlsrsakex:events go1.22.0
/godebug/non-default-behavior/tlssha1:events go1.25.0
/godebug/non-default-behavior/tlsunsafeekm:events go1.22.0
/godebug/non-default-behavior/updatemaxprocs:events go1.25.0
/godebug/non-default-behavior/winreadlinkvolume:events go1.23.0
/godebug/non-default-behavior/winsymlink:events go1.23.0
/godebug/non-default-behavior/x509keypairleaf:events go1.23.0
/godebug/non-default-behavior/x509negativeserial:events go1.23.0
/godebug/non-default-behavior/x509rsacrt:events go1.24.0
/godebug/non-default-behavior/x509sha1:events go1.21.0
/godebug/non-default-behavior/x509sha256skid:events go1.25.0
/godebug/non-default-behavior/x509usefallbackroots:events go1.21.0
/godebug/non-default-behavior/x509usepolicies:events go1.22.0
/godebug/non-default-behavior/zipinsecurepath:events go1.21.0
/memory/classes/heap/free:bytes go1.16
/memory/classes/heap/objects:bytes go1.16
/memory/classes/heap/released:bytes go1.16
/memory/classes/heap/stacks:bytes go1.16
/memory/classes/heap/unused:bytes go1.16
/memory/classes/metadata/mcache/free:bytes go1.16
/memory/classes/metadata/mcache/inuse:bytes go1.16
/memory/classes/metadata/mspan/free:bytes go1.16
/memory/classes/metadata/mspan/inuse:bytes go1.16
/memory/classes/metadata/other:bytes go1.16
/memory/classes/os-stacks:bytes go1.16
/memory/classes/other:bytes go1.16
/memory/classes/profiling/buckets:bytes go1.16
/memory/classes/total:bytes go1.16
/sched/gomaxprocs:threads go1.19
/sched/goroutines:goroutines go1.16
/sched/latencies:seconds go1.17
/sched/pauses/stopping/gc:seconds go1.22.0
/sched/pauses/stopping/other:seconds go1.22.0
/sched/pauses/total/gc:seconds go1.22.0
/sched/pauses/total/other:seconds go1.22.0
/sync/mutex/wait/total:seconds go1.20

Raw Json from go1.16 to go1.25.0

runtime/metrics was added in go1.16 so I start the go version here. Below is the json representation for the markdown table below for you to reference. so you can customize based on your usage.

{
  "/cgo/go-to-c-calls:calls": "go1.19",
  "/cpu/classes/gc/mark/assist:cpu-seconds": "go1.20",
  "/cpu/classes/gc/mark/dedicated:cpu-seconds": "go1.20",
  "/cpu/classes/gc/mark/idle:cpu-seconds": "go1.20",
  "/cpu/classes/gc/pause:cpu-seconds": "go1.20",
  "/cpu/classes/gc/total:cpu-seconds": "go1.20",
  "/cpu/classes/idle:cpu-seconds": "go1.20",
  "/cpu/classes/scavenge/assist:cpu-seconds": "go1.20",
  "/cpu/classes/scavenge/background:cpu-seconds": "go1.20",
  "/cpu/classes/scavenge/total:cpu-seconds": "go1.20",
  "/cpu/classes/total:cpu-seconds": "go1.20",
  "/cpu/classes/user:cpu-seconds": "go1.20",
  "/gc/cycles/automatic:gc-cycles": "go1.16",
  "/gc/cycles/forced:gc-cycles": "go1.16",
  "/gc/cycles/total:gc-cycles": "go1.16",
  "/gc/gogc:percent": "go1.21.0",
  "/gc/gomemlimit:bytes": "go1.21.0",
  "/gc/heap/allocs-by-size:bytes": "go1.16",
  "/gc/heap/allocs:bytes": "go1.17",
  "/gc/heap/allocs:objects": "go1.17",
  "/gc/heap/frees-by-size:bytes": "go1.16",
  "/gc/heap/frees:bytes": "go1.17",
  "/gc/heap/frees:objects": "go1.17",
  "/gc/heap/goal:bytes": "go1.16",
  "/gc/heap/live:bytes": "go1.21.0",
  "/gc/heap/objects:objects": "go1.16",
  "/gc/heap/tiny/allocs:objects": "go1.17",
  "/gc/limiter/last-enabled:gc-cycle": "go1.19",
  "/gc/pauses:seconds": "go1.16",
  "/gc/scan/globals:bytes": "go1.21.0",
  "/gc/scan/heap:bytes": "go1.21.0",
  "/gc/scan/stack:bytes": "go1.21.0",
  "/gc/scan/total:bytes": "go1.21.0",
  "/gc/stack/starting-size:bytes": "go1.19",
  "/godebug/non-default-behavior/allowmultiplevcs:events": "go1.25.0",
  "/godebug/non-default-behavior/asynctimerchan:events": "go1.23.0",
  "/godebug/non-default-behavior/containermaxprocs:events": "go1.25.0",
  "/godebug/non-default-behavior/embedfollowsymlinks:events": "go1.25.0",
  "/godebug/non-default-behavior/execerrdot:events": "go1.21.0",
  "/godebug/non-default-behavior/gocachehash:events": "go1.21.0",
  "/godebug/non-default-behavior/gocachetest:events": "go1.21.0",
  "/godebug/non-default-behavior/gocacheverify:events": "go1.21.0",
  "/godebug/non-default-behavior/gotestjsonbuildtext:events": "go1.24.0",
  "/godebug/non-default-behavior/gotypesalias:events": "go1.22.0",
  "/godebug/non-default-behavior/http2client:events": "go1.21.0",
  "/godebug/non-default-behavior/http2server:events": "go1.21.0",
  "/godebug/non-default-behavior/httplaxcontentlength:events": "go1.22.0",
  "/godebug/non-default-behavior/httpmuxgo121:events": "go1.22.0",
  "/godebug/non-default-behavior/httpservecontentkeepheaders:events": "go1.23.0",
  "/godebug/non-default-behavior/installgoroot:events": "go1.21.0",
  "/godebug/non-default-behavior/jstmpllitinterp:events": "go1.21.0",
  "/godebug/non-default-behavior/multipartmaxheaders:events": "go1.21.0",
  "/godebug/non-default-behavior/multipartmaxparts:events": "go1.21.0",
  "/godebug/non-default-behavior/multipathtcp:events": "go1.21.0",
  "/godebug/non-default-behavior/netedns0:events": "go1.23.0",
  "/godebug/non-default-behavior/panicnil:events": "go1.21.0",
  "/godebug/non-default-behavior/randautoseed:events": "go1.21.0",
  "/godebug/non-default-behavior/randseednop:events": "go1.24.0",
  "/godebug/non-default-behavior/rsa1024min:events": "go1.24.0",
  "/godebug/non-default-behavior/tarinsecurepath:events": "go1.21.0",
  "/godebug/non-default-behavior/tls10server:events": "go1.22.0",
  "/godebug/non-default-behavior/tls3des:events": "go1.23.0",
  "/godebug/non-default-behavior/tlsmaxrsasize:events": "go1.22.0",
  "/godebug/non-default-behavior/tlsrsakex:events": "go1.22.0",
  "/godebug/non-default-behavior/tlssha1:events": "go1.25.0",
  "/godebug/non-default-behavior/tlsunsafeekm:events": "go1.22.0",
  "/godebug/non-default-behavior/updatemaxprocs:events": "go1.25.0",
  "/godebug/non-default-behavior/winreadlinkvolume:events": "go1.23.0",
  "/godebug/non-default-behavior/winsymlink:events": "go1.23.0",
  "/godebug/non-default-behavior/x509keypairleaf:events": "go1.23.0",
  "/godebug/non-default-behavior/x509negativeserial:events": "go1.23.0",
  "/godebug/non-default-behavior/x509rsacrt:events": "go1.24.0",
  "/godebug/non-default-behavior/x509sha1:events": "go1.21.0",
  "/godebug/non-default-behavior/x509sha256skid:events": "go1.25.0",
  "/godebug/non-default-behavior/x509usefallbackroots:events": "go1.21.0",
  "/godebug/non-default-behavior/x509usepolicies:events": "go1.22.0",
  "/godebug/non-default-behavior/zipinsecurepath:events": "go1.21.0",
  "/memory/classes/heap/free:bytes": "go1.16",
  "/memory/classes/heap/objects:bytes": "go1.16",
  "/memory/classes/heap/released:bytes": "go1.16",
  "/memory/classes/heap/stacks:bytes": "go1.16",
  "/memory/classes/heap/unused:bytes": "go1.16",
  "/memory/classes/metadata/mcache/free:bytes": "go1.16",
  "/memory/classes/metadata/mcache/inuse:bytes": "go1.16",
  "/memory/classes/metadata/mspan/free:bytes": "go1.16",
  "/memory/classes/metadata/mspan/inuse:bytes": "go1.16",
  "/memory/classes/metadata/other:bytes": "go1.16",
  "/memory/classes/os-stacks:bytes": "go1.16",
  "/memory/classes/other:bytes": "go1.16",
  "/memory/classes/profiling/buckets:bytes": "go1.16",
  "/memory/classes/total:bytes": "go1.16",
  "/sched/gomaxprocs:threads": "go1.19",
  "/sched/goroutines:goroutines": "go1.16",
  "/sched/latencies:seconds": "go1.17",
  "/sched/pauses/stopping/gc:seconds": "go1.22.0",
  "/sched/pauses/stopping/other:seconds": "go1.22.0",
  "/sched/pauses/total/gc:seconds": "go1.22.0",
  "/sched/pauses/total/other:seconds": "go1.22.0",
  "/sync/mutex/wait/total:seconds": "go1.20"
}

Method

This table is generated, and you can refer to the code here. It requires you to run the code multiple times with different go versions as runtime/metrics resides inside golang source code bundled with go command. Here is the go version lists and the shell to trigger all go versions.

values=(
    "go1.25.0" 
    "go1.24.0"
    "go1.23.0"
    "go1.22.0"
    "go1.21.0"
    "go1.20"
    "go1.19"
    "go1.18"
    "go1.17"
    "go1.16"
)

for value in "${values[@]}"; do
  echo "Processing: $value"
  # find a go version managed tool to do so.
  xxx go run main.go --go="$value"
  # Optional: handle errors or output
  if [ $? -eq 0 ]; then
    echo "Command succeeded for $value"
  else
    echo "Command failed for $value"
  fi
done
Go Source Code to Retrieve Runtime Metrics 
package main

import (
    "encoding/json"
    "io"
    "os"
    "runtime"
    "runtime/metrics"
)

func main() {
    getAllMetrics()
}

func getAllMetrics() {
    descriptions := metrics.All()
    gover := runtime.Version()
    metrics := make(map[string]metrics.Description)
    for _, desc := range descriptions {
        metrics[desc.Name] = desc
    }

    file, err := os.OpenFile("all.json", os.O_RDWR|os.O_CREATE, 0644)
    if err != nil {
        panic(err)
    }
    defer file.Close()
    data, err := io.ReadAll(file)
    if err != nil {
        panic(err)
    }
    if len(data) == 0 {
        data = []byte("{}")
    }
    var result map[string]interface{}
    err = json.Unmarshal(data, &result)
    if err != nil {
        panic(err)
    }
    result[gover] = metrics

    data, err = json.Marshal(result)
    if err != nil {
        panic(err)
    }
    err = os.WriteFile("all.json", data, 0644)
    if err != nil {
        panic(err)
    }
}
Parse Result of All Go Runtime Metrics 
func format() {
    var m map[string]map[string]metrics.Description
    data, err := os.ReadFile("all.json")
    if err != nil {
        panic(err)
    }
    err = json.Unmarshal(data, &m)
    if err != nil {
        panic(err)
    }

    metricsVersionMap := make(map[string]string)
    for gover, metrics := range m {
        for name := range metrics {
            oldVer, exists := metricsVersionMap[name]
            if !exists {
                metricsVersionMap[name] = gover
                continue
            }
            // fill the earlier version
            if version.Compare(gover, oldVer) < 0 {
                metricsVersionMap[name] = gover
            }
        }
    }

    output, err := json.Marshal(metricsVersionMap)
    if err != nil {
        panic(err)
    }
    err = os.WriteFile("metrics_version.json", output, 0644)
    if err != nil {
        panic(err)
    }

    type tuple struct {
        Name    string `json:"name"`
        Version string `json:"version"`
    }
    var metricsArray []tuple
    for name, ver := range metricsVersionMap {
        metricsArray = append(metricsArray, tuple{
            Name:    name,
            Version: ver,
        })
    }

    sort.Slice(metricsArray, func(i, j int) bool {
        return metricsArray[i].Name < metricsArray[j].Name
    })

    var buf bytes.Buffer
    buf.WriteString("| Metric Name      | Initial Supported Go Version|\n|:-----------------|:----------------|\n")
    for _, t := range metricsArray {
        buf.WriteString("| " + t.Name + " | " + t.Version + " |\n")
    }
    err = os.WriteFile("METRICS_VERSION.md", buf.Bytes(), 0644)
    if err != nil {
        panic(err)
    }
}

Comments