diff --git a/docs/prometheus-integration.md b/docs/prometheus-integration.md index af40f6cc11f..80b4dd56f38 100644 --- a/docs/prometheus-integration.md +++ b/docs/prometheus-integration.md @@ -328,23 +328,24 @@ in seconds for each field validation value #### Go Metrics - **go_cgo_go_to_c_calls_calls_total:** Count of calls made from Go to C by -the current process. +the current process. Sourced from /cgo/go-to-c-calls:calls - **go_cpu_classes_gc_mark_assist_cpu_seconds_total:** Estimated total CPU time goroutines spent performing GC tasks to assist the GC and prevent it -from falling behind the application. This metric is an overestimate, and -not directly comparable to system CPU time measurements. Compare only with -other /cpu/classes metrics. +from falling behind the application. This metric is an overestimate, and not +directly comparable to system CPU time measurements. Compare only with other +/cpu/classes metrics. Sourced from /cpu/classes/gc/mark/assist:cpu-seconds - **go_cpu_classes_gc_mark_dedicated_cpu_seconds_total:** Estimated total CPU time spent performing GC tasks on processors (as defined by GOMAXPROCS) dedicated to those tasks. This metric is an overestimate, and not directly comparable to system CPU time measurements. Compare only with other -/cpu/classes metrics. +/cpu/classes metrics. Sourced from /cpu/classes/gc/mark/dedicated:cpu-seconds - **go_cpu_classes_gc_mark_idle_cpu_seconds_total:** Estimated total CPU time spent performing GC tasks on spare CPU resources that the Go scheduler could not otherwise find a use for. This should be subtracted from the total GC CPU time to obtain a measure of compulsory GC CPU time. This metric is an overestimate, and not directly comparable to system CPU time -measurements. Compare only with other /cpu/classes metrics. +measurements. Compare only with other /cpu/classes metrics. Sourced from +/cpu/classes/gc/mark/idle:cpu-seconds - **go_cpu_classes_gc_pause_cpu_seconds_total:** Estimated total CPU time spent with the application paused by the GC. Even if only one thread is running during the pause, this is computed as GOMAXPROCS times the pause @@ -352,309 +353,384 @@ latency because nothing else can be executing. This is the exact sum of samples in /sched/pauses/total/gc:seconds if each sample is multiplied by GOMAXPROCS at the time it is taken. This metric is an overestimate, and not directly comparable to system CPU time measurements. Compare only with other -/cpu/classes metrics. +/cpu/classes metrics. Sourced from /cpu/classes/gc/pause:cpu-seconds - **go_cpu_classes_gc_total_cpu_seconds_total:** Estimated total CPU time spent performing GC tasks. This metric is an overestimate, and not directly comparable to system CPU time measurements. Compare only with other -/cpu/classes metrics. Sum of all metrics in /cpu/classes/gc. +/cpu/classes metrics. Sum of all metrics in /cpu/classes/gc. Sourced from +/cpu/classes/gc/total:cpu-seconds - **go_cpu_classes_idle_cpu_seconds_total:** Estimated total available CPU time not spent executing any Go or Go runtime code. In other words, the part of /cpu/classes/total:cpu-seconds that was unused. This metric is an overestimate, and not directly comparable to system CPU time measurements. Compare only -with other /cpu/classes metrics. +with other /cpu/classes metrics. Sourced from /cpu/classes/idle:cpu-seconds - **go_cpu_classes_scavenge_assist_cpu_seconds_total:** Estimated total CPU time spent returning unused memory to the underlying platform in response -eagerly in response to memory pressure. This metric is an overestimate, -and not directly comparable to system CPU time measurements. Compare only -with other /cpu/classes metrics. +eagerly in response to memory pressure. This metric is an overestimate, and not +directly comparable to system CPU time measurements. Compare only with other +/cpu/classes metrics. Sourced from /cpu/classes/scavenge/assist:cpu-seconds - **go_cpu_classes_scavenge_background_cpu_seconds_total:** Estimated total CPU time spent performing background tasks to return unused memory to the underlying platform. This metric is an overestimate, and not directly comparable to system CPU time measurements. Compare only with other -/cpu/classes metrics. -- **go_cpu_classes_scavenge_total_cpu_seconds_total:** Estimated total -CPU time spent performing tasks that return unused memory to the underlying -platform. This metric is an overestimate, and not directly comparable to system -CPU time measurements. Compare only with other /cpu/classes metrics. Sum of -all metrics in /cpu/classes/scavenge. +/cpu/classes metrics. Sourced from /cpu/classes/scavenge/background:cpu-seconds +- **go_cpu_classes_scavenge_total_cpu_seconds_total:** Estimated total CPU +time spent performing tasks that return unused memory to the underlying +platform. This metric is an overestimate, and not directly comparable +to system CPU time measurements. Compare only with other /cpu/classes +metrics. Sum of all metrics in /cpu/classes/scavenge. Sourced from +/cpu/classes/scavenge/total:cpu-seconds - **go_cpu_classes_total_cpu_seconds_total:** Estimated total available CPU time for user Go code or the Go runtime, as defined by GOMAXPROCS. In other words, GOMAXPROCS integrated over the wall-clock duration this process has been executing for. This metric is an overestimate, and not directly comparable to system CPU time measurements. Compare only with other /cpu/classes metrics. Sum -of all metrics in /cpu/classes. +of all metrics in /cpu/classes. Sourced from /cpu/classes/total:cpu-seconds - **go_cpu_classes_user_cpu_seconds_total:** Estimated total CPU time spent -running user Go code. This may also include some small amount of time spent -in the Go runtime. This metric is an overestimate, and not directly comparable -to system CPU time measurements. Compare only with other /cpu/classes metrics. +running user Go code. This may also include some small amount of time spent in +the Go runtime. This metric is an overestimate, and not directly comparable +to system CPU time measurements. Compare only with other /cpu/classes +metrics. Sourced from /cpu/classes/user:cpu-seconds - **go_gc_cycles_automatic_gc_cycles_total:** Count of completed GC cycles -generated by the Go runtime. +generated by the Go runtime. Sourced from /gc/cycles/automatic:gc-cycles - **go_gc_cycles_forced_gc_cycles_total:** Count of completed GC cycles -forced by the application. -- **go_gc_cycles_total_gc_cycles_total:** Count of all completed GC cycles. -- **go_gc_duration_seconds:** A summary of the pause duration of garbage -collection cycles. +forced by the application. Sourced from /gc/cycles/forced:gc-cycles +- **go_gc_cycles_total_gc_cycles_total:** Count of all completed GC +cycles. Sourced from /gc/cycles/total:gc-cycles +- **go_gc_duration_seconds:** A summary of the wall-time pause (stop-the-world) +duration in garbage collection cycles. - **go_gc_gogc_percent:** Heap size target percentage configured by the user, otherwise 100. This value is set by the GOGC environment variable, -and the runtime/debug.SetGCPercent function. +and the runtime/debug.SetGCPercent function. Sourced from /gc/gogc:percent - **go_gc_gomemlimit_bytes:** Go runtime memory limit configured by the user, otherwise math.MaxInt64. This value is set by the GOMEMLIMIT environment -variable, and the runtime/debug.SetMemoryLimit function. +variable, and the runtime/debug.SetMemoryLimit function. Sourced from +/gc/gomemlimit:bytes - **go_gc_heap_allocs_by_size_bytes:** Distribution of heap allocations by approximate size. Bucket counts increase monotonically. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, -only tiny blocks. +only tiny blocks. Sourced from /gc/heap/allocs-by-size:bytes - **go_gc_heap_allocs_bytes_total:** Cumulative sum of memory allocated to -the heap by the application. +the heap by the application. Sourced from /gc/heap/allocs:bytes - **go_gc_heap_allocs_objects_total:** Cumulative count of heap allocations triggered by the application. Note that this does not include tiny objects -as defined by /gc/heap/tiny/allocs:objects, only tiny blocks. +as defined by /gc/heap/tiny/allocs:objects, only tiny blocks. Sourced from +/gc/heap/allocs:objects - **go_gc_heap_frees_by_size_bytes:** Distribution of freed heap allocations by approximate size. Bucket counts increase monotonically. Note that this does not include tiny objects as defined by /gc/heap/tiny/allocs:objects, -only tiny blocks. +only tiny blocks. Sourced from /gc/heap/frees-by-size:bytes - **go_gc_heap_frees_bytes_total:** Cumulative sum of heap memory freed by -the garbage collector. +the garbage collector. Sourced from /gc/heap/frees:bytes - **go_gc_heap_frees_objects_total:** Cumulative count of heap allocations -whose storage was freed by the garbage collector. Note that this does -not include tiny objects as defined by /gc/heap/tiny/allocs:objects, only -tiny blocks. -- **go_gc_heap_goal_bytes:** Heap size target for the end of the GC cycle. +whose storage was freed by the garbage collector. Note that this does not +include tiny objects as defined by /gc/heap/tiny/allocs:objects, only tiny +blocks. Sourced from /gc/heap/frees:objects +- **go_gc_heap_goal_bytes:** Heap size target for the end of the GC +cycle. Sourced from /gc/heap/goal:bytes - **go_gc_heap_live_bytes:** Heap memory occupied by live objects that were -marked by the previous GC. +marked by the previous GC. Sourced from /gc/heap/live:bytes - **go_gc_heap_objects_objects:** Number of objects, live or unswept, -occupying heap memory. +occupying heap memory. Sourced from /gc/heap/objects:objects - **go_gc_heap_tiny_allocs_objects_total:** Count of small allocations that are packed together into blocks. These allocations are counted separately from other allocations because each individual allocation is not tracked by the runtime, only their block. Each block is already accounted for in -allocs-by-size and frees-by-size. +allocs-by-size and frees-by-size. Sourced from /gc/heap/tiny/allocs:objects - **go_gc_limiter_last_enabled_gc_cycle:** GC cycle the last time the GC CPU limiter was enabled. This metric is useful for diagnosing the root cause of an out-of-memory error, because the limiter trades memory for CPU time when the GC's CPU time gets too high. This is most likely to occur with use of SetMemoryLimit. The first GC cycle is cycle 1, so a value of 0 indicates -that it was never enabled. +that it was never enabled. Sourced from /gc/limiter/last-enabled:gc-cycle - **go_gc_pauses_seconds:** Deprecated. Prefer the identical -/sched/pauses/total/gc:seconds. +/sched/pauses/total/gc:seconds. Sourced from /gc/pauses:seconds - **go_gc_scan_globals_bytes:** The total amount of global variable space -that is scannable. -- **go_gc_scan_heap_bytes:** The total amount of heap space that is scannable. +that is scannable. Sourced from /gc/scan/globals:bytes +- **go_gc_scan_heap_bytes:** The total amount of heap space that is +scannable. Sourced from /gc/scan/heap:bytes - **go_gc_scan_stack_bytes:** The number of bytes of stack that were scanned -last GC cycle. +last GC cycle. Sourced from /gc/scan/stack:bytes - **go_gc_scan_total_bytes:** The total amount space that is scannable. Sum -of all metrics in /gc/scan. -- **go_gc_stack_starting_size_bytes:** The stack size of new goroutines. -- **go_godebug_non_default_behavior_asynctimerchan_events_total:** The number -of non-default behaviors executed by the time package due to a non-default -GODEBUG=asynctimerchan=... setting. -- **go_godebug_non_default_behavior_execerrdot_events_total:** The number of -non-default behaviors executed by the os/exec package due to a non-default -GODEBUG=execerrdot=... setting. -- **go_godebug_non_default_behavior_gocachehash_events_total:** The number -of non-default behaviors executed by the cmd/go package due to a non-default -GODEBUG=gocachehash=... setting. -- **go_godebug_non_default_behavior_gocachetest_events_total:** The number -of non-default behaviors executed by the cmd/go package due to a non-default -GODEBUG=gocachetest=... setting. -- **go_godebug_non_default_behavior_gocacheverify_events_total:** The number -of non-default behaviors executed by the cmd/go package due to a non-default -GODEBUG=gocacheverify=... setting. -- **go_godebug_non_default_behavior_gotypesalias_events_total:** The number -of non-default behaviors executed by the go/types package due to a non-default -GODEBUG=gotypesalias=... setting. -- **go_godebug_non_default_behavior_http2client_events_total:** The number of -non-default behaviors executed by the net/http package due to a non-default -GODEBUG=http2client=... setting. -- **go_godebug_non_default_behavior_http2server_events_total:** The number of -non-default behaviors executed by the net/http package due to a non-default -GODEBUG=http2server=... setting. +of all metrics in /gc/scan. Sourced from /gc/scan/total:bytes +- **go_gc_stack_starting_size_bytes:** The stack size of new +goroutines. Sourced from /gc/stack/starting-size:bytes +- **go_godebug_non_default_behavior_asynctimerchan_events_total:** +The number of non-default behaviors executed by the time package due +to a non-default GODEBUG=asynctimerchan=... setting. Sourced from +/godebug/non-default-behavior/asynctimerchan:events +- **go_godebug_non_default_behavior_execerrdot_events_total:** +The number of non-default behaviors executed by the os/exec package +due to a non-default GODEBUG=execerrdot=... setting. Sourced from +/godebug/non-default-behavior/execerrdot:events +- **go_godebug_non_default_behavior_gocachehash_events_total:** +The number of non-default behaviors executed by the cmd/go package +due to a non-default GODEBUG=gocachehash=... setting. Sourced from +/godebug/non-default-behavior/gocachehash:events +- **go_godebug_non_default_behavior_gocachetest_events_total:** +The number of non-default behaviors executed by the cmd/go package +due to a non-default GODEBUG=gocachetest=... setting. Sourced from +/godebug/non-default-behavior/gocachetest:events +- **go_godebug_non_default_behavior_gocacheverify_events_total:** +The number of non-default behaviors executed by the cmd/go package +due to a non-default GODEBUG=gocacheverify=... setting. Sourced from +/godebug/non-default-behavior/gocacheverify:events +- **go_godebug_non_default_behavior_gotypesalias_events_total:** +The number of non-default behaviors executed by the go/types package +due to a non-default GODEBUG=gotypesalias=... setting. Sourced from +/godebug/non-default-behavior/gotypesalias:events +- **go_godebug_non_default_behavior_http2client_events_total:** +The number of non-default behaviors executed by the net/http package +due to a non-default GODEBUG=http2client=... setting. Sourced from +/godebug/non-default-behavior/http2client:events +- **go_godebug_non_default_behavior_http2server_events_total:** +The number of non-default behaviors executed by the net/http package +due to a non-default GODEBUG=http2server=... setting. Sourced from +/godebug/non-default-behavior/http2server:events - **go_godebug_non_default_behavior_httplaxcontentlength_events_total:** -The number of non-default behaviors executed by the net/http package due to -a non-default GODEBUG=httplaxcontentlength=... setting. -- **go_godebug_non_default_behavior_httpmuxgo121_events_total:** The number -of non-default behaviors executed by the net/http package due to a non-default -GODEBUG=httpmuxgo121=... setting. +The number of non-default behaviors executed by the net/http package due +to a non-default GODEBUG=httplaxcontentlength=... setting. Sourced from +/godebug/non-default-behavior/httplaxcontentlength:events +- **go_godebug_non_default_behavior_httpmuxgo121_events_total:** +The number of non-default behaviors executed by the net/http package +due to a non-default GODEBUG=httpmuxgo121=... setting. Sourced from +/godebug/non-default-behavior/httpmuxgo121:events - **go_godebug_non_default_behavior_httpservecontentkeepheaders_events_total:** The number of non-default behaviors executed by the net/http package due to -a non-default GODEBUG=httpservecontentkeepheaders=... setting. -- **go_godebug_non_default_behavior_installgoroot_events_total:** The number -of non-default behaviors executed by the go/build package due to a non-default -GODEBUG=installgoroot=... setting. +a non-default GODEBUG=httpservecontentkeepheaders=... setting. Sourced from +/godebug/non-default-behavior/httpservecontentkeepheaders:events +- **go_godebug_non_default_behavior_installgoroot_events_total:** +The number of non-default behaviors executed by the go/build package +due to a non-default GODEBUG=installgoroot=... setting. Sourced from +/godebug/non-default-behavior/installgoroot:events - **go_godebug_non_default_behavior_multipartmaxheaders_events_total:** The number of non-default behaviors executed by the mime/multipart package -due to a non-default GODEBUG=multipartmaxheaders=... setting. -- **go_godebug_non_default_behavior_multipartmaxparts_events_total:** The -number of non-default behaviors executed by the mime/multipart package due -to a non-default GODEBUG=multipartmaxparts=... setting. -- **go_godebug_non_default_behavior_multipathtcp_events_total:** The number -of non-default behaviors executed by the net package due to a non-default -GODEBUG=multipathtcp=... setting. -- **go_godebug_non_default_behavior_netedns0_events_total:** The number -of non-default behaviors executed by the net package due to a non-default -GODEBUG=netedns0=... setting. -- **go_godebug_non_default_behavior_panicnil_events_total:** The number of -non-default behaviors executed by the runtime package due to a non-default -GODEBUG=panicnil=... setting. -- **go_godebug_non_default_behavior_randautoseed_events_total:** The number of -non-default behaviors executed by the math/rand package due to a non-default -GODEBUG=randautoseed=... setting. -- **go_godebug_non_default_behavior_tarinsecurepath_events_total:** The -number of non-default behaviors executed by the archive/tar package due to -a non-default GODEBUG=tarinsecurepath=... setting. -- **go_godebug_non_default_behavior_tls10server_events_total:** The number of -non-default behaviors executed by the crypto/tls package due to a non-default -GODEBUG=tls10server=... setting. -- **go_godebug_non_default_behavior_tls3des_events_total:** The number of -non-default behaviors executed by the crypto/tls package due to a non-default -GODEBUG=tls3des=... setting. -- **go_godebug_non_default_behavior_tlsmaxrsasize_events_total:** The -number of non-default behaviors executed by the crypto/tls package due to -a non-default GODEBUG=tlsmaxrsasize=... setting. -- **go_godebug_non_default_behavior_tlsrsakex_events_total:** The number of -non-default behaviors executed by the crypto/tls package due to a non-default -GODEBUG=tlsrsakex=... setting. -- **go_godebug_non_default_behavior_tlsunsafeekm_events_total:** The number of -non-default behaviors executed by the crypto/tls package due to a non-default -GODEBUG=tlsunsafeekm=... setting. +due to a non-default GODEBUG=multipartmaxheaders=... setting. Sourced from +/godebug/non-default-behavior/multipartmaxheaders:events +- **go_godebug_non_default_behavior_multipartmaxparts_events_total:** +The number of non-default behaviors executed by the mime/multipart package +due to a non-default GODEBUG=multipartmaxparts=... setting. Sourced from +/godebug/non-default-behavior/multipartmaxparts:events +- **go_godebug_non_default_behavior_multipathtcp_events_total:** +The number of non-default behaviors executed by the net package +due to a non-default GODEBUG=multipathtcp=... setting. Sourced from +/godebug/non-default-behavior/multipathtcp:events +- **go_godebug_non_default_behavior_netedns0_events_total:** +The number of non-default behaviors executed by the net package +due to a non-default GODEBUG=netedns0=... setting. Sourced from +/godebug/non-default-behavior/netedns0:events +- **go_godebug_non_default_behavior_panicnil_events_total:** The +number of non-default behaviors executed by the runtime package +due to a non-default GODEBUG=panicnil=... setting. Sourced from +/godebug/non-default-behavior/panicnil:events +- **go_godebug_non_default_behavior_randautoseed_events_total:** +The number of non-default behaviors executed by the math/rand package +due to a non-default GODEBUG=randautoseed=... setting. Sourced from +/godebug/non-default-behavior/randautoseed:events +- **go_godebug_non_default_behavior_tarinsecurepath_events_total:** +The number of non-default behaviors executed by the archive/tar package +due to a non-default GODEBUG=tarinsecurepath=... setting. Sourced from +/godebug/non-default-behavior/tarinsecurepath:events +- **go_godebug_non_default_behavior_tls10server_events_total:** The +number of non-default behaviors executed by the crypto/tls package +due to a non-default GODEBUG=tls10server=... setting. Sourced from +/godebug/non-default-behavior/tls10server:events +- **go_godebug_non_default_behavior_tls3des_events_total:** The +number of non-default behaviors executed by the crypto/tls package +due to a non-default GODEBUG=tls3des=... setting. Sourced from +/godebug/non-default-behavior/tls3des:events +- **go_godebug_non_default_behavior_tlsmaxrsasize_events_total:** +The number of non-default behaviors executed by the crypto/tls package +due to a non-default GODEBUG=tlsmaxrsasize=... setting. Sourced from +/godebug/non-default-behavior/tlsmaxrsasize:events +- **go_godebug_non_default_behavior_tlsrsakex_events_total:** The +number of non-default behaviors executed by the crypto/tls package +due to a non-default GODEBUG=tlsrsakex=... setting. Sourced from +/godebug/non-default-behavior/tlsrsakex:events +- **go_godebug_non_default_behavior_tlsunsafeekm_events_total:** The +number of non-default behaviors executed by the crypto/tls package +due to a non-default GODEBUG=tlsunsafeekm=... setting. Sourced from +/godebug/non-default-behavior/tlsunsafeekm:events - **go_godebug_non_default_behavior_winreadlinkvolume_events_total:** -The number of non-default behaviors executed by the os package due to a -non-default GODEBUG=winreadlinkvolume=... setting. -- **go_godebug_non_default_behavior_winsymlink_events_total:** The number -of non-default behaviors executed by the os package due to a non-default -GODEBUG=winsymlink=... setting. -- **go_godebug_non_default_behavior_x509keypairleaf_events_total:** The -number of non-default behaviors executed by the crypto/tls package due to -a non-default GODEBUG=x509keypairleaf=... setting. -- **go_godebug_non_default_behavior_x509negativeserial_events_total:** The -number of non-default behaviors executed by the crypto/x509 package due to -a non-default GODEBUG=x509negativeserial=... setting. -- **go_godebug_non_default_behavior_x509sha1_events_total:** The number of -non-default behaviors executed by the crypto/x509 package due to a non-default -GODEBUG=x509sha1=... setting. +The number of non-default behaviors executed by the os package due +to a non-default GODEBUG=winreadlinkvolume=... setting. Sourced from +/godebug/non-default-behavior/winreadlinkvolume:events +- **go_godebug_non_default_behavior_winsymlink_events_total:** +The number of non-default behaviors executed by the os package +due to a non-default GODEBUG=winsymlink=... setting. Sourced from +/godebug/non-default-behavior/winsymlink:events +- **go_godebug_non_default_behavior_x509keypairleaf_events_total:** +The number of non-default behaviors executed by the crypto/tls package +due to a non-default GODEBUG=x509keypairleaf=... setting. Sourced from +/godebug/non-default-behavior/x509keypairleaf:events +- **go_godebug_non_default_behavior_x509negativeserial_events_total:** +The number of non-default behaviors executed by the crypto/x509 package +due to a non-default GODEBUG=x509negativeserial=... setting. Sourced from +/godebug/non-default-behavior/x509negativeserial:events +- **go_godebug_non_default_behavior_x509sha1_events_total:** The +number of non-default behaviors executed by the crypto/x509 package +due to a non-default GODEBUG=x509sha1=... setting. Sourced from +/godebug/non-default-behavior/x509sha1:events - **go_godebug_non_default_behavior_x509usefallbackroots_events_total:** -The number of non-default behaviors executed by the crypto/x509 package due -to a non-default GODEBUG=x509usefallbackroots=... setting. -- **go_godebug_non_default_behavior_x509usepolicies_events_total:** The -number of non-default behaviors executed by the crypto/x509 package due to -a non-default GODEBUG=x509usepolicies=... setting. -- **go_godebug_non_default_behavior_zipinsecurepath_events_total:** The -number of non-default behaviors executed by the archive/zip package due to -a non-default GODEBUG=zipinsecurepath=... setting. +The number of non-default behaviors executed by the crypto/x509 package +due to a non-default GODEBUG=x509usefallbackroots=... setting. Sourced from +/godebug/non-default-behavior/x509usefallbackroots:events +- **go_godebug_non_default_behavior_x509usepolicies_events_total:** +The number of non-default behaviors executed by the crypto/x509 package +due to a non-default GODEBUG=x509usepolicies=... setting. Sourced from +/godebug/non-default-behavior/x509usepolicies:events +- **go_godebug_non_default_behavior_zipinsecurepath_events_total:** +The number of non-default behaviors executed by the archive/zip package +due to a non-default GODEBUG=zipinsecurepath=... setting. Sourced from +/godebug/non-default-behavior/zipinsecurepath:events - **go_goroutines:** Number of goroutines that currently exist. - **go_info:** Information about the Go environment. - **go_memory_classes_heap_free_bytes:** Memory that is completely free and eligible to be returned to the underlying system, but has not been. This metric is the runtime's estimate of free address space that is backed by -physical memory. -- **go_memory_classes_heap_objects_bytes:** Memory occupied by live objects -and dead objects that have not yet been marked free by the garbage collector. +physical memory. Sourced from /memory/classes/heap/free:bytes +- **go_memory_classes_heap_objects_bytes:** Memory occupied by live +objects and dead objects that have not yet been marked free by the garbage +collector. Sourced from /memory/classes/heap/objects:bytes - **go_memory_classes_heap_released_bytes:** Memory that is completely free and has been returned to the underlying system. This metric is the runtime's -estimate of free address space that is still mapped into the process, but -is not backed by physical memory. -- **go_memory_classes_heap_stacks_bytes:** Memory allocated from the -heap that is reserved for stack space, whether or not it is currently -in-use. Currently, this represents all stack memory for goroutines. It also -includes all OS thread stacks in non-cgo programs. Note that stacks may be -allocated differently in the future, and this may change. -- **go_memory_classes_heap_unused_bytes:** Memory that is reserved for heap -objects but is not currently used to hold heap objects. -- **go_memory_classes_metadata_mcache_free_bytes:** Memory that is reserved -for runtime mcache structures, but not in-use. +estimate of free address space that is still mapped into the process, but is +not backed by physical memory. Sourced from /memory/classes/heap/released:bytes +- **go_memory_classes_heap_stacks_bytes:** Memory allocated from the heap that +is reserved for stack space, whether or not it is currently in-use. Currently, +this represents all stack memory for goroutines. It also includes all OS thread +stacks in non-cgo programs. Note that stacks may be allocated differently in +the future, and this may change. Sourced from /memory/classes/heap/stacks:bytes +- **go_memory_classes_heap_unused_bytes:** Memory that is reserved for +heap objects but is not currently used to hold heap objects. Sourced from +/memory/classes/heap/unused:bytes +- **go_memory_classes_metadata_mcache_free_bytes:** Memory that is +reserved for runtime mcache structures, but not in-use. Sourced from +/memory/classes/metadata/mcache/free:bytes - **go_memory_classes_metadata_mcache_inuse_bytes:** Memory that is occupied -by runtime mcache structures that are currently being used. -- **go_memory_classes_metadata_mspan_free_bytes:** Memory that is reserved -for runtime mspan structures, but not in-use. +by runtime mcache structures that are currently being used. Sourced from +/memory/classes/metadata/mcache/inuse:bytes +- **go_memory_classes_metadata_mspan_free_bytes:** Memory that is +reserved for runtime mspan structures, but not in-use. Sourced from +/memory/classes/metadata/mspan/free:bytes - **go_memory_classes_metadata_mspan_inuse_bytes:** Memory that is occupied -by runtime mspan structures that are currently being used. -- **go_memory_classes_metadata_other_bytes:** Memory that is reserved for -or used to hold runtime metadata. +by runtime mspan structures that are currently being used. Sourced from +/memory/classes/metadata/mspan/inuse:bytes +- **go_memory_classes_metadata_other_bytes:** Memory that is +reserved for or used to hold runtime metadata. Sourced from +/memory/classes/metadata/other:bytes - **go_memory_classes_os_stacks_bytes:** Stack memory allocated by the underlying operating system. In non-cgo programs this metric is currently -zero. This may change in the future.In cgo programs this metric includes OS -thread stacks allocated directly from the OS. Currently, this only accounts -for one stack in c-shared and c-archive build modes, and other sources of -stacks from the OS are not measured. This too may change in the future. +zero. This may change in the future.In cgo programs this metric includes +OS thread stacks allocated directly from the OS. Currently, this only +accounts for one stack in c-shared and c-archive build modes, and other +sources of stacks from the OS are not measured. This too may change in the +future. Sourced from /memory/classes/os-stacks:bytes - **go_memory_classes_other_bytes:** Memory used by execution trace buffers, structures for debugging the runtime, finalizer and profiler specials, -and more. -- **go_memory_classes_profiling_buckets_bytes:** Memory that is used by the -stack trace hash map used for profiling. +and more. Sourced from /memory/classes/other:bytes +- **go_memory_classes_profiling_buckets_bytes:** Memory that is +used by the stack trace hash map used for profiling. Sourced from +/memory/classes/profiling/buckets:bytes - **go_memory_classes_total_bytes:** All memory mapped by the Go runtime into the current process as read-write. Note that this does not include memory mapped by code called via cgo or via the syscall package. Sum of all -metrics in /memory/classes. -- **go_memstats_alloc_bytes:** Number of bytes allocated and still in use. -- **go_memstats_alloc_bytes_total:** Total number of bytes allocated, even -if freed. +metrics in /memory/classes. Sourced from /memory/classes/total:bytes +- **go_memstats_alloc_bytes:** Number of bytes allocated in heap and currently +in use. Equals to /memory/classes/heap/objects:bytes. +- **go_memstats_alloc_bytes_total:** Total number of bytes allocated in heap +until now, even if released already. Equals to /gc/heap/allocs:bytes. - **go_memstats_buck_hash_sys_bytes:** Number of bytes used by the profiling -bucket hash table. -- **go_memstats_frees_total:** Total number of frees. +bucket hash table. Equals to /memory/classes/profiling/buckets:bytes. +- **go_memstats_frees_total:** Total number of heap objects frees. Equals +to /gc/heap/frees:objects + /gc/heap/tiny/allocs:objects. - **go_memstats_gc_sys_bytes:** Number of bytes used for garbage collection -system metadata. -- **go_memstats_heap_alloc_bytes:** Number of heap bytes allocated and still -in use. -- **go_memstats_heap_idle_bytes:** Number of heap bytes waiting to be used. -- **go_memstats_heap_inuse_bytes:** Number of heap bytes that are in use. -- **go_memstats_heap_objects:** Number of allocated objects. -- **go_memstats_heap_released_bytes:** Number of heap bytes released to OS. -- **go_memstats_heap_sys_bytes:** Number of heap bytes obtained from system. +system metadata. Equals to /memory/classes/metadata/other:bytes. +- **go_memstats_heap_alloc_bytes:** Number of heap bytes allocated +and currently in use, same as go_memstats_alloc_bytes. Equals to +/memory/classes/heap/objects:bytes. +- **go_memstats_heap_idle_bytes:** Number of heap bytes waiting +to be used. Equals to /memory/classes/heap/released:bytes + +/memory/classes/heap/free:bytes. +- **go_memstats_heap_inuse_bytes:** Number of heap bytes that +are in use. Equals to /memory/classes/heap/objects:bytes + +/memory/classes/heap/unused:bytes +- **go_memstats_heap_objects:** Number of currently allocated objects. Equals +to /gc/heap/objects:objects. +gauge. Equals to /gc/heap/allocs:objects + /gc/heap/tiny/allocs:objects. +- **go_memstats_heap_released_bytes:** Number of heap bytes released to +OS. Equals to /memory/classes/heap/released:bytes. +- **go_memstats_heap_sys_bytes:** Number of heap bytes obtained +from system. Equals to /memory/classes/heap/objects:bytes + +/memory/classes/heap/unused:bytes + /memory/classes/heap/released:bytes + +/memory/classes/heap/free:bytes. - **go_memstats_last_gc_time_seconds:** Number of seconds since 1970 of last garbage collection. -- **go_memstats_lookups_total:** Total number of pointer lookups. -- **go_memstats_mallocs_total:** Total number of mallocs. +- **go_memstats_mallocs_total:** Total number of heap objects allocated, both +live and gc-ed. Semantically a counter version for go_memstats_heap_objects +gauge. Equals to /gc/heap/allocs:objects + /gc/heap/tiny/allocs:objects. - **go_memstats_mcache_inuse_bytes:** Number of bytes in use by mcache -structures. +structures. Equals to /memory/classes/metadata/mcache/inuse:bytes. - **go_memstats_mcache_sys_bytes:** Number of bytes used for mcache structures -obtained from system. +obtained from system. Equals to /memory/classes/metadata/mcache/inuse:bytes + +/memory/classes/metadata/mcache/free:bytes. - **go_memstats_mspan_inuse_bytes:** Number of bytes in use by mspan -structures. +structures. Equals to /memory/classes/metadata/mspan/inuse:bytes. - **go_memstats_mspan_sys_bytes:** Number of bytes used for mspan structures -obtained from system. +obtained from system. Equals to /memory/classes/metadata/mspan/inuse:bytes + +/memory/classes/metadata/mspan/free:bytes. - **go_memstats_next_gc_bytes:** Number of heap bytes when next garbage -collection will take place. +collection will take place. Equals to /gc/heap/goal:bytes. - **go_memstats_other_sys_bytes:** Number of bytes used for other system -allocations. -- **go_memstats_stack_inuse_bytes:** Number of bytes in use by the stack -allocator. -- **go_memstats_stack_sys_bytes:** Number of bytes obtained from system for -stack allocator. -- **go_memstats_sys_bytes:** Number of bytes obtained from system. +allocations. Equals to /memory/classes/other:bytes. +- **go_memstats_stack_inuse_bytes:** Number of bytes obtained +from system for stack allocator in non-CGO environments. Equals to +/memory/classes/heap/stacks:bytes. +- **go_memstats_stack_sys_bytes:** Number of bytes obtained from system +for stack allocator. Equals to /memory/classes/heap/stacks:bytes + +/memory/classes/os-stacks:bytes. +- **go_memstats_sys_bytes:** Number of bytes obtained from system. Equals +to /memory/classes/total:byte. - **go_sched_gomaxprocs_threads:** The current runtime.GOMAXPROCS setting, or the number of operating system threads that can execute user-level Go -code simultaneously. -- **go_sched_goroutines_goroutines:** Count of live goroutines. +code simultaneously. Sourced from /sched/gomaxprocs:threads +- **go_sched_goroutines_goroutines:** Count of live goroutines. Sourced +from /sched/goroutines:goroutines - **go_sched_latencies_seconds:** Distribution of the time goroutines have spent in the scheduler in a runnable state before actually running. Bucket -counts increase monotonically. +counts increase monotonically. Sourced from /sched/latencies:seconds - **go_sched_pauses_stopping_gc_seconds:** Distribution of individual GC-related stop-the-world stopping latencies. This is the time it takes from deciding to stop the world until all Ps are stopped. This is a subset of the total GC-related stop-the-world time (/sched/pauses/total/gc:seconds). During -this time, some threads may be executing. Bucket counts increase monotonically. +this time, some threads may be executing. Bucket counts increase +monotonically. Sourced from /sched/pauses/stopping/gc:seconds - **go_sched_pauses_stopping_other_seconds:** Distribution of individual non-GC-related stop-the-world stopping latencies. This is the time it takes from deciding to stop the world until all Ps are stopped. This is a subset of the total non-GC-related stop-the-world time -(/sched/pauses/total/other:seconds). During this time, some threads may be -executing. Bucket counts increase monotonically. +(/sched/pauses/total/other:seconds). During this time, some threads +may be executing. Bucket counts increase monotonically. Sourced from +/sched/pauses/stopping/other:seconds - **go_sched_pauses_total_gc_seconds:** Distribution of individual GC-related stop-the-world pause latencies. This is the time from deciding to stop the world until the world is started again. Some of this time is spent getting all threads to stop (this is measured directly in -/sched/pauses/stopping/gc:seconds), during which some threads may still be -running. Bucket counts increase monotonically. +/sched/pauses/stopping/gc:seconds), during which some threads may +still be running. Bucket counts increase monotonically. Sourced from +/sched/pauses/total/gc:seconds - **go_sched_pauses_total_other_seconds:** Distribution of individual non-GC-related stop-the-world pause latencies. This is the time from deciding to stop the world until the world is started again. Some of -this time is spent getting all threads to stop (measured directly in -/sched/pauses/stopping/other:seconds). Bucket counts increase monotonically. +this time is spent getting all threads to stop (measured directly +in /sched/pauses/stopping/other:seconds). Bucket counts increase +monotonically. Sourced from /sched/pauses/total/other:seconds - **go_sync_mutex_wait_total_seconds_total:** Approximate cumulative time goroutines have spent blocked on a sync.Mutex, sync.RWMutex, or -runtime-internal lock. This metric is useful for identifying global changes -in lock contention. Collect a mutex or block profile using the runtime/pprof -package for more detailed contention data. +runtime-internal lock. This metric is useful for identifying global +changes in lock contention. Collect a mutex or block profile using the +runtime/pprof package for more detailed contention data. Sourced from +/sync/mutex/wait/total:seconds - **go_threads:** Number of OS threads created. #### Hidden Metrics @@ -666,6 +742,10 @@ package for more detailed contention data. - **process_cpu_seconds_total:** Total user and system CPU time spent in seconds. - **process_max_fds:** Maximum number of open file descriptors. +- **process_network_receive_bytes_total:** Number of bytes received by the +process over the network. +- **process_network_transmit_bytes_total:** Number of bytes sent by the +process over the network. - **process_open_fds:** Number of open file descriptors. - **process_resident_memory_bytes:** Resident memory size in bytes. - **process_start_time_seconds:** Start time of the process since unix epoch diff --git a/go.mod b/go.mod index 3981a35308a..0c03e7dc49c 100644 --- a/go.mod +++ b/go.mod @@ -43,8 +43,8 @@ require ( github.com/onsi/gomega v1.34.1 github.com/osrg/gobgp/v3 v3.29.0 github.com/pkg/sftp v1.13.6 - github.com/prometheus/client_golang v1.19.1 - github.com/prometheus/common v0.55.0 + github.com/prometheus/client_golang v1.20.4 + github.com/prometheus/common v0.59.1 github.com/sirupsen/logrus v1.9.3 github.com/spf13/afero v1.11.0 github.com/spf13/cobra v1.8.1 @@ -167,8 +167,9 @@ require ( github.com/josharian/native v1.1.0 // indirect github.com/json-iterator/go v1.1.12 // indirect github.com/k-sone/critbitgo v1.4.0 // indirect - github.com/klauspost/compress v1.16.0 // indirect + github.com/klauspost/compress v1.17.9 // indirect github.com/kr/fs v0.1.0 // indirect + github.com/kylelemons/godebug v1.1.0 // indirect github.com/liggitt/tabwriter v0.0.0-20181228230101-89fcab3d43de // indirect github.com/magiconair/properties v1.8.7 // indirect github.com/mailru/easyjson v0.7.7 // indirect diff --git a/go.sum b/go.sum index 424031fd578..cd44b5394d3 100644 --- a/go.sum +++ b/go.sum @@ -476,8 +476,8 @@ github.com/kisielk/errcheck v1.2.0/go.mod h1:/BMXB+zMLi60iA8Vv6Ksmxu/1UDYcXs4uQL github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8= github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck= github.com/kisielk/sqlstruct v0.0.0-20201105191214-5f3e10d3ab46/go.mod h1:yyMNCyc/Ib3bDTKd379tNMpB/7/H5TjM2Y9QJ5THLbE= -github.com/klauspost/compress v1.16.0 h1:iULayQNOReoYUe+1qtKOqw9CwJv3aNQu8ivo7lw1HU4= -github.com/klauspost/compress v1.16.0/go.mod h1:ntbaceVETuRiXiv4DpjP66DpAtAGkEQskQzEyD//IeE= +github.com/klauspost/compress v1.17.9 h1:6KIumPrER1LHsvBVuDa0r5xaG0Es51mhhB9BQB2qeMA= +github.com/klauspost/compress v1.17.9/go.mod h1:Di0epgTjJY877eYKx5yC51cX2A2Vl2ibi7bDH9ttBbw= github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= github.com/kr/fs v0.1.0 h1:Jskdu9ieNAYnjxsi0LbQp1ulIKZV1LAFgK1tWhpZgl8= github.com/kr/fs v0.1.0/go.mod h1:FFnZGqtBN9Gxj7eW1uZ42v5BccTP0vu6NEaFoC2HwRg= @@ -491,6 +491,8 @@ github.com/kr/pty v1.1.5/go.mod h1:9r2w37qlBe7rQ6e1fg1S/9xpWHSnaqNdHD3WcMdbPDA= github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= +github.com/kylelemons/godebug v1.1.0 h1:RPNrshWIDI6G2gRW9EHilWtl7Z6Sb1BR0xunSBf0SNc= +github.com/kylelemons/godebug v1.1.0/go.mod h1:9/0rRGxNHcop5bhtWyNeEfOS8JIWk580+fNqagV/RAw= github.com/liggitt/tabwriter v0.0.0-20181228230101-89fcab3d43de h1:9TO3cAIGXtEhnIaL+V+BEER86oLrvS+kWobKpbJuye0= github.com/liggitt/tabwriter v0.0.0-20181228230101-89fcab3d43de/go.mod h1:zAbeS9B/r2mtpb6U+EI2rYA5OAXxsYw6wTamcNW+zcE= github.com/lithammer/dedent v1.1.0 h1:VNzHMVCBNG1j0fh3OrsFRkVUwStdDArbgBWoPAffktY= @@ -637,8 +639,8 @@ github.com/prometheus/client_golang v0.9.1/go.mod h1:7SWBe2y4D6OKWSNQJUaRYU/AaXP github.com/prometheus/client_golang v0.9.3/go.mod h1:/TN21ttK/J9q6uSwhBd54HahCDft0ttaMvbicHlPoso= github.com/prometheus/client_golang v1.0.0/go.mod h1:db9x61etRT2tGnBNRi70OPL5FsnadC4Ky3P0J6CfImo= github.com/prometheus/client_golang v1.4.0/go.mod h1:e9GMxYsXl05ICDXkRhurwBS4Q3OK1iX/F2sw+iXX5zU= -github.com/prometheus/client_golang v1.19.1 h1:wZWJDwK+NameRJuPGDhlnFgx8e8HN3XHQeLaYJFJBOE= -github.com/prometheus/client_golang v1.19.1/go.mod h1:mP78NwGzrVks5S2H6ab8+ZZGJLZUq1hoULYBAYBw1Ho= +github.com/prometheus/client_golang v1.20.4 h1:Tgh3Yr67PaOv/uTqloMsCEdeuFTatm5zIq5+qNN23vI= +github.com/prometheus/client_golang v1.20.4/go.mod h1:PIEt8X02hGcP8JWbeHyeZ53Y/jReSnHgO035n//V5WE= github.com/prometheus/client_model v0.0.0-20180712105110-5c3871d89910/go.mod h1:MbSGuTsp3dbXC40dX6PRTWyKYBIrTGTE9sqQNg2J8bo= github.com/prometheus/client_model v0.0.0-20190129233127-fd36f4220a90/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= @@ -649,8 +651,8 @@ github.com/prometheus/common v0.0.0-20181113130724-41aa239b4cce/go.mod h1:daVV7q github.com/prometheus/common v0.4.0/go.mod h1:TNfzLD0ON7rHzMJeJkieUDPYmFC7Snx/y86RQel1bk4= github.com/prometheus/common v0.4.1/go.mod h1:TNfzLD0ON7rHzMJeJkieUDPYmFC7Snx/y86RQel1bk4= github.com/prometheus/common v0.9.1/go.mod h1:yhUN8i9wzaXS3w1O07YhxHEBxD+W35wd8bs7vj7HSQ4= -github.com/prometheus/common v0.55.0 h1:KEi6DK7lXW/m7Ig5i47x0vRzuBsHuvJdi5ee6Y3G1dc= -github.com/prometheus/common v0.55.0/go.mod h1:2SECS4xJG1kd8XF9IcM1gMX6510RAEL65zxzNImwdc8= +github.com/prometheus/common v0.59.1 h1:LXb1quJHWm1P6wq/U824uxYi4Sg0oGvNeUm1z5dJoX0= +github.com/prometheus/common v0.59.1/go.mod h1:GpWM7dewqmVYcd7SmRaiWVe9SSqjf0UrwnYnpEZNuT0= github.com/prometheus/procfs v0.0.0-20181005140218-185b4288413d/go.mod h1:c3At6R/oaqEKCNdg8wHV1ftS6bRYblBhIjjI8uT2IGk= github.com/prometheus/procfs v0.0.0-20190507164030-5867b95ac084/go.mod h1:TjEm7ze935MbeOT/UhFTIMYKhuLP4wbCsTZCD3I8kEA= github.com/prometheus/procfs v0.0.2/go.mod h1:TjEm7ze935MbeOT/UhFTIMYKhuLP4wbCsTZCD3I8kEA=