diff --git a/pkg/audit/metrics.go b/pkg/audit/metrics.go index 6c51d1385..88d4154e8 100644 --- a/pkg/audit/metrics.go +++ b/pkg/audit/metrics.go @@ -29,6 +29,14 @@ const ( subsystem = "apiserver_audit" ) +/* + * By default, all the following metrics are defined as falling under + * ALPHA stability level https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes) + * + * Promoting the stability level of the metric is a responsibility of the component owner, since it + * involves explicitly acknowledging support for the metric across multiple releases, in accordance with + * the metric stability policy. + */ var ( eventCounter = metrics.NewCounter( &metrics.CounterOpts{ diff --git a/pkg/authentication/request/x509/x509.go b/pkg/authentication/request/x509/x509.go index 364ac2d94..d45c86340 100644 --- a/pkg/authentication/request/x509/x509.go +++ b/pkg/authentication/request/x509/x509.go @@ -31,6 +31,14 @@ import ( "k8s.io/component-base/metrics/legacyregistry" ) +/* + * By default, the following metric is defined as falling under + * ALPHA stability level https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes) + * + * Promoting the stability level of the metric is a responsibility of the component owner, since it + * involves explicitly acknowledging support for the metric across multiple releases, in accordance with + * the metric stability policy. + */ var clientCertificateExpirationHistogram = metrics.NewHistogram( &metrics.HistogramOpts{ Namespace: "apiserver", diff --git a/pkg/endpoints/filters/authentication.go b/pkg/endpoints/filters/authentication.go index 17b456a03..1b4de1899 100644 --- a/pkg/endpoints/filters/authentication.go +++ b/pkg/endpoints/filters/authentication.go @@ -32,6 +32,14 @@ import ( "k8s.io/klog" ) +/* + * By default, all the following metrics are defined as falling under + * ALPHA stability level https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes) + * + * Promoting the stability level of the metric is a responsibility of the component owner, since it + * involves explicitly acknowledging support for the metric across multiple releases, in accordance with + * the metric stability policy. + */ var ( authenticatedUserCounter = metrics.NewCounterVec( &metrics.CounterOpts{ diff --git a/pkg/endpoints/metrics/metrics.go b/pkg/endpoints/metrics/metrics.go index 429496456..30ce24a4b 100644 --- a/pkg/endpoints/metrics/metrics.go +++ b/pkg/endpoints/metrics/metrics.go @@ -52,6 +52,14 @@ const ( APIServerComponent string = "apiserver" ) +/* + * By default, all the following metrics are defined as falling under + * ALPHA stability level https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes) + * + * Promoting the stability level of the metric is a responsibility of the component owner, since it + * involves explicitly acknowledging support for the metric across multiple releases, in accordance with + * the metric stability policy. + */ var ( // TODO(a-robinson): Add unit tests for the handling of these metrics once // the upstream library supports it. diff --git a/pkg/storage/cacher/cacher.go b/pkg/storage/cacher/cacher.go index f27db4e9d..822615fb6 100644 --- a/pkg/storage/cacher/cacher.go +++ b/pkg/storage/cacher/cacher.go @@ -45,6 +45,14 @@ import ( utiltrace "k8s.io/utils/trace" ) +/* + * By default, all the following metrics are defined as falling under + * ALPHA stability level https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes) + * + * Promoting the stability level of the metric is a responsibility of the component owner, since it + * involves explicitly acknowledging support for the metric across multiple releases, in accordance with + * the metric stability policy. + */ var ( initCounter = metrics.NewCounterVec( &metrics.CounterOpts{ diff --git a/pkg/storage/etcd3/metrics/metrics.go b/pkg/storage/etcd3/metrics/metrics.go index c32326c04..32210db16 100644 --- a/pkg/storage/etcd3/metrics/metrics.go +++ b/pkg/storage/etcd3/metrics/metrics.go @@ -24,6 +24,14 @@ import ( "k8s.io/component-base/metrics/legacyregistry" ) +/* + * By default, all the following metrics are defined as falling under + * ALPHA stability level https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes) + * + * Promoting the stability level of the metric is a responsibility of the component owner, since it + * involves explicitly acknowledging support for the metric across multiple releases, in accordance with + * the metric stability policy. + */ var ( etcdRequestLatency = compbasemetrics.NewHistogramVec( &compbasemetrics.HistogramOpts{ diff --git a/pkg/storage/value/metrics.go b/pkg/storage/value/metrics.go index 179d2b98e..f35994688 100644 --- a/pkg/storage/value/metrics.go +++ b/pkg/storage/value/metrics.go @@ -32,6 +32,14 @@ const ( subsystem = "storage" ) +/* + * By default, all the following metrics are defined as falling under + * ALPHA stability level https://github.com/kubernetes/enhancements/blob/master/keps/sig-instrumentation/20190404-kubernetes-control-plane-metrics-stability.md#stability-classes) + * + * Promoting the stability level of the metric is a responsibility of the component owner, since it + * involves explicitly acknowledging support for the metric across multiple releases, in accordance with + * the metric stability policy. + */ var ( transformerLatencies = metrics.NewHistogramVec( &metrics.HistogramOpts{