2019-01-12 04:58:27 +00:00
|
|
|
/*
|
|
|
|
Copyright 2017 The Kubernetes Authors.
|
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
you may not use this file except in compliance with the License.
|
|
|
|
You may obtain a copy of the License at
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
package metrics
|
|
|
|
|
|
|
|
import (
|
|
|
|
"sync"
|
|
|
|
"time"
|
|
|
|
|
|
|
|
"github.com/prometheus/client_golang/prometheus"
|
|
|
|
)
|
|
|
|
|
|
|
|
const kubeProxySubsystem = "kubeproxy"
|
|
|
|
|
|
|
|
var (
|
|
|
|
// SyncProxyRulesLatency is the latency of one round of kube-proxy syncing proxy rules.
|
|
|
|
SyncProxyRulesLatency = prometheus.NewHistogram(
|
2019-04-07 17:07:55 +00:00
|
|
|
prometheus.HistogramOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "sync_proxy_rules_duration_seconds",
|
|
|
|
Help: "SyncProxyRules latency in seconds",
|
|
|
|
Buckets: prometheus.ExponentialBuckets(0.001, 2, 15),
|
|
|
|
},
|
|
|
|
)
|
|
|
|
|
|
|
|
// DeprecatedSyncProxyRulesLatency is the latency of one round of kube-proxy syncing proxy rules.
|
|
|
|
DeprecatedSyncProxyRulesLatency = prometheus.NewHistogram(
|
2019-01-12 04:58:27 +00:00
|
|
|
prometheus.HistogramOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "sync_proxy_rules_latency_microseconds",
|
2019-04-07 17:07:55 +00:00
|
|
|
Help: "(Deprecated) SyncProxyRules latency in microseconds",
|
2019-01-12 04:58:27 +00:00
|
|
|
Buckets: prometheus.ExponentialBuckets(1000, 2, 15),
|
|
|
|
},
|
|
|
|
)
|
2019-04-07 17:07:55 +00:00
|
|
|
|
2019-07-14 07:58:54 +00:00
|
|
|
// SyncProxyRulesLastTimestamp is the timestamp proxy rules were last
|
|
|
|
// successfully synced.
|
|
|
|
SyncProxyRulesLastTimestamp = prometheus.NewGauge(
|
|
|
|
prometheus.GaugeOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "sync_proxy_rules_last_timestamp_seconds",
|
|
|
|
Help: "The last time proxy rules were successfully synced",
|
|
|
|
},
|
|
|
|
)
|
|
|
|
|
2019-04-07 17:07:55 +00:00
|
|
|
// NetworkProgrammingLatency is defined as the time it took to program the network - from the time
|
|
|
|
// the service or pod has changed to the time the change was propagated and the proper kube-proxy
|
|
|
|
// rules were synced. Exported for each endpoints object that were part of the rules sync.
|
|
|
|
// See https://github.com/kubernetes/community/blob/master/sig-scalability/slos/network_programming_latency.md
|
|
|
|
// Note that the metrics is partially based on the time exported by the endpoints controller on
|
|
|
|
// the master machine. The measurement may be inaccurate if there is a clock drift between the
|
|
|
|
// node and master machine.
|
|
|
|
NetworkProgrammingLatency = prometheus.NewHistogram(
|
|
|
|
prometheus.HistogramOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "network_programming_duration_seconds",
|
|
|
|
Help: "In Cluster Network Programming Latency in seconds",
|
|
|
|
// TODO(mm4tt): Reevaluate buckets before 1.14 release.
|
|
|
|
// The last bucket will be [0.001s*2^20 ~= 17min, +inf)
|
|
|
|
Buckets: prometheus.ExponentialBuckets(0.001, 2, 20),
|
|
|
|
},
|
|
|
|
)
|
2019-07-14 07:58:54 +00:00
|
|
|
|
|
|
|
// EndpointChangesPending is the number of pending endpoint changes that
|
|
|
|
// have not yet been synced to the proxy.
|
|
|
|
EndpointChangesPending = prometheus.NewGauge(
|
|
|
|
prometheus.GaugeOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "sync_proxy_rules_endpoint_changes_pending",
|
|
|
|
Help: "Pending proxy rules Endpoint changes",
|
|
|
|
},
|
|
|
|
)
|
|
|
|
|
|
|
|
// EndpointChangesTotal is the number of endpoint changes that the proxy
|
|
|
|
// has seen.
|
|
|
|
EndpointChangesTotal = prometheus.NewCounter(
|
|
|
|
prometheus.CounterOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "sync_proxy_rules_endpoint_changes_total",
|
|
|
|
Help: "Cumulative proxy rules Endpoint changes",
|
|
|
|
},
|
|
|
|
)
|
|
|
|
|
|
|
|
// ServiceChangesPending is the number of pending service changes that
|
|
|
|
// have not yet been synced to the proxy.
|
|
|
|
ServiceChangesPending = prometheus.NewGauge(
|
|
|
|
prometheus.GaugeOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "sync_proxy_rules_service_changes_pending",
|
|
|
|
Help: "Pending proxy rules Service changes",
|
|
|
|
},
|
|
|
|
)
|
|
|
|
|
|
|
|
// ServiceChangesTotal is the number of service changes that the proxy has
|
|
|
|
// seen.
|
|
|
|
ServiceChangesTotal = prometheus.NewCounter(
|
|
|
|
prometheus.CounterOpts{
|
|
|
|
Subsystem: kubeProxySubsystem,
|
|
|
|
Name: "sync_proxy_rules_service_changes_total",
|
|
|
|
Help: "Cumulative proxy rules Service changes",
|
|
|
|
},
|
|
|
|
)
|
2019-01-12 04:58:27 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
var registerMetricsOnce sync.Once
|
|
|
|
|
2019-04-07 17:07:55 +00:00
|
|
|
// RegisterMetrics registers kube-proxy metrics.
|
2019-01-12 04:58:27 +00:00
|
|
|
func RegisterMetrics() {
|
|
|
|
registerMetricsOnce.Do(func() {
|
|
|
|
prometheus.MustRegister(SyncProxyRulesLatency)
|
2019-04-07 17:07:55 +00:00
|
|
|
prometheus.MustRegister(DeprecatedSyncProxyRulesLatency)
|
2019-07-14 07:58:54 +00:00
|
|
|
prometheus.MustRegister(SyncProxyRulesLastTimestamp)
|
2019-04-07 17:07:55 +00:00
|
|
|
prometheus.MustRegister(NetworkProgrammingLatency)
|
2019-07-14 07:58:54 +00:00
|
|
|
prometheus.MustRegister(EndpointChangesPending)
|
|
|
|
prometheus.MustRegister(EndpointChangesTotal)
|
|
|
|
prometheus.MustRegister(ServiceChangesPending)
|
|
|
|
prometheus.MustRegister(ServiceChangesTotal)
|
2019-01-12 04:58:27 +00:00
|
|
|
})
|
|
|
|
}
|
|
|
|
|
|
|
|
// SinceInMicroseconds gets the time since the specified start in microseconds.
|
|
|
|
func SinceInMicroseconds(start time.Time) float64 {
|
|
|
|
return float64(time.Since(start).Nanoseconds() / time.Microsecond.Nanoseconds())
|
|
|
|
}
|
2019-04-07 17:07:55 +00:00
|
|
|
|
|
|
|
// SinceInSeconds gets the time since the specified start in seconds.
|
|
|
|
func SinceInSeconds(start time.Time) float64 {
|
|
|
|
return time.Since(start).Seconds()
|
|
|
|
}
|