kubernetes: k8s.io/kubernetes/pkg/scheduler/metrics Index | Files | Directories

package metrics

import "k8s.io/kubernetes/pkg/scheduler/metrics"

Index

Package Files

metric_recorder.go metrics.go profile_metrics.go

Constants

const (
    // SchedulerSubsystem - subsystem name used by scheduler
    SchedulerSubsystem = "scheduler"

    // PrioritizingExtender - prioritizing extender operation label value
    PrioritizingExtender = "prioritizing_extender"
    // Binding - binding operation label value
    Binding = "binding"
)

Variables

var (
    SchedulingAlgorithmLatency = metrics.NewHistogram(
        &metrics.HistogramOpts{
            Subsystem:      SchedulerSubsystem,
            Name:           "scheduling_algorithm_duration_seconds",
            Help:           "Scheduling algorithm latency in seconds",
            Buckets:        metrics.ExponentialBuckets(0.001, 2, 15),
            StabilityLevel: metrics.ALPHA,
        },
    )
    PreemptionVictims = metrics.NewHistogram(
        &metrics.HistogramOpts{
            Subsystem: SchedulerSubsystem,
            Name:      "preemption_victims",
            Help:      "Number of selected preemption victims",

            Buckets:        metrics.LinearBuckets(5, 5, 10),
            StabilityLevel: metrics.ALPHA,
        })
    PreemptionAttempts = metrics.NewCounter(
        &metrics.CounterOpts{
            Subsystem:      SchedulerSubsystem,
            Name:           "preemption_attempts_total",
            Help:           "Total preemption attempts in the cluster till now",
            StabilityLevel: metrics.ALPHA,
        })

    SchedulerGoroutines = metrics.NewGaugeVec(
        &metrics.GaugeOpts{
            Subsystem:      SchedulerSubsystem,
            Name:           "scheduler_goroutines",
            Help:           "Number of running goroutines split by the work they do such as binding.",
            StabilityLevel: metrics.ALPHA,
        }, []string{"work"})

    PodSchedulingDuration = metrics.NewHistogramVec(
        &metrics.HistogramOpts{
            Subsystem: SchedulerSubsystem,
            Name:      "pod_scheduling_duration_seconds",
            Help:      "E2e latency for a pod being scheduled which may include multiple scheduling attempts.",

            Buckets:        metrics.ExponentialBuckets(0.01, 2, 20),
            StabilityLevel: metrics.ALPHA,
        },
        []string{"attempts"})

    PodSchedulingAttempts = metrics.NewHistogram(
        &metrics.HistogramOpts{
            Subsystem:      SchedulerSubsystem,
            Name:           "pod_scheduling_attempts",
            Help:           "Number of attempts to successfully schedule a pod.",
            Buckets:        metrics.ExponentialBuckets(1, 2, 5),
            StabilityLevel: metrics.ALPHA,
        })

    FrameworkExtensionPointDuration = metrics.NewHistogramVec(
        &metrics.HistogramOpts{
            Subsystem: SchedulerSubsystem,
            Name:      "framework_extension_point_duration_seconds",
            Help:      "Latency for running all plugins of a specific extension point.",

            Buckets:        metrics.ExponentialBuckets(0.0001, 2, 12),
            StabilityLevel: metrics.ALPHA,
        },
        []string{"extension_point", "status", "profile"})

    PluginExecutionDuration = metrics.NewHistogramVec(
        &metrics.HistogramOpts{
            Subsystem: SchedulerSubsystem,
            Name:      "plugin_execution_duration_seconds",
            Help:      "Duration for running a plugin at a specific extension point.",

            Buckets:        metrics.ExponentialBuckets(0.00001, 1.5, 20),
            StabilityLevel: metrics.ALPHA,
        },
        []string{"plugin", "extension_point", "status"})

    SchedulerQueueIncomingPods = metrics.NewCounterVec(
        &metrics.CounterOpts{
            Subsystem:      SchedulerSubsystem,
            Name:           "queue_incoming_pods_total",
            Help:           "Number of pods added to scheduling queues by event and queue type.",
            StabilityLevel: metrics.ALPHA,
        }, []string{"queue", "event"})

    PermitWaitDuration = metrics.NewHistogramVec(
        &metrics.HistogramOpts{
            Subsystem:      SchedulerSubsystem,
            Name:           "permit_wait_duration_seconds",
            Help:           "Duration of waiting on permit.",
            Buckets:        metrics.ExponentialBuckets(0.001, 2, 15),
            StabilityLevel: metrics.ALPHA,
        },
        []string{"result"})

    CacheSize = metrics.NewGaugeVec(
        &metrics.GaugeOpts{
            Subsystem:      SchedulerSubsystem,
            Name:           "scheduler_cache_size",
            Help:           "Number of nodes, pods, and assumed (bound) pods in the scheduler cache.",
            StabilityLevel: metrics.ALPHA,
        }, []string{"type"})
)

All the histogram based metrics have 1ms as size for the smallest bucket.

func ActivePods Uses

func ActivePods() metrics.GaugeMetric

ActivePods returns the pending pods metrics with the label active

func BackoffPods Uses

func BackoffPods() metrics.GaugeMetric

BackoffPods returns the pending pods metrics with the label backoff

func GetGather Uses

func GetGather() metrics.Gatherer

GetGather returns the gatherer. It used by test case outside current package.

func PodScheduleError Uses

func PodScheduleError(profile string, duration float64)

PodScheduleError can records a scheduling attempt that had an error and the duration since `start`.

func PodScheduled Uses

func PodScheduled(profile string, duration float64)

PodScheduled can records a successful scheduling attempt and the duration since `start`.

func PodUnschedulable Uses

func PodUnschedulable(profile string, duration float64)

PodUnschedulable can records a scheduling attempt for an unschedulable pod and the duration since `start`.

func Register Uses

func Register()

Register all metrics.

func RegisterMetrics Uses

func RegisterMetrics(extraMetrics ...metrics.Registerable)

RegisterMetrics registers a list of metrics. This function is exported because it is intended to be used by out-of-tree plugins to register their custom metrics.

func SinceInSeconds Uses

func SinceInSeconds(start time.Time) float64

SinceInSeconds gets the time since the specified start in seconds.

func UnschedulablePods Uses

func UnschedulablePods() metrics.GaugeMetric

UnschedulablePods returns the pending pods metrics with the label unschedulable

type MetricRecorder Uses

type MetricRecorder interface {
    Inc()
    Dec()
    Clear()
}

MetricRecorder represents a metric recorder which takes action when the metric Inc(), Dec() and Clear()

type PendingPodsRecorder Uses

type PendingPodsRecorder struct {
    // contains filtered or unexported fields
}

PendingPodsRecorder is an implementation of MetricRecorder

func NewActivePodsRecorder Uses

func NewActivePodsRecorder() *PendingPodsRecorder

NewActivePodsRecorder returns ActivePods in a Prometheus metric fashion

func NewBackoffPodsRecorder Uses

func NewBackoffPodsRecorder() *PendingPodsRecorder

NewBackoffPodsRecorder returns BackoffPods in a Prometheus metric fashion

func NewUnschedulablePodsRecorder Uses

func NewUnschedulablePodsRecorder() *PendingPodsRecorder

NewUnschedulablePodsRecorder returns UnschedulablePods in a Prometheus metric fashion

func (*PendingPodsRecorder) Clear Uses

func (r *PendingPodsRecorder) Clear()

Clear set a metric counter to 0, in an atomic way

func (*PendingPodsRecorder) Dec Uses

func (r *PendingPodsRecorder) Dec()

Dec decreases a metric counter by 1, in an atomic way

func (*PendingPodsRecorder) Inc Uses

func (r *PendingPodsRecorder) Inc()

Inc increases a metric counter by 1, in an atomic way

Directories

PathSynopsis
resourcesPackage resources provides a metrics collector that reports the resource consumption (requests and limits) of the pods in the cluster as the scheduler and kubelet would interpret it.

Package metrics imports 5 packages (graph) and is imported by 183 packages. Updated 2021-01-04. Refresh now. Tools for package owners.