参考 on Kueue

标签和注解

Thu, 19 Mar 2026 00:00:00 +0000

本页面作为 Kueue 中所有标签和注解的参考。

kueue.x-k8s.io/admission-gated-by

Type: Annotation

Example: kueue.x-k8s.io/admission-gated-by: "example.com/mygate,example.com/mygate2"

Used on: Kueue-managed Jobs.

This annotation requires the AdmissionGatedBy feature that is disabled by default.

When it contains a value, the annotation prevents the Job from entering the Quota Reservation phase of Kueue’s Admission Flow. The annotation value is a comma-separated list of 1 or more gate names and can only be added during Job creation. After creation, the annotation may only be deleted or modified to remove 1 or more gates.

Prometheus 指标

Mon, 14 Feb 2022 00:00:00 +0000

Note

要启用指标抓取，请参阅设置 Prometheus。

Kueue 暴露了 prometheus 指标来监控系统的健康状况和 ClusterQueues 以及 LocalQueues 的状态。

Kueue 健康状态

使用以下指标来监控 kueue 控制器的健康状况：

指标名称	类型	描述	标签
`kueue_admission_attempt_duration_seconds`	直方图	一次准入尝试的延迟。标签 ‘result’ 可以有以下值： - ‘success’ 表示至少有一个工作负载被接纳， - ‘inadmissible’ 表示没有工作负载被接纳。	`result`: 可能的值为 `success` 或 `inadmissible` `replica_role`: 可以为 `leader`、`follower` 或 `standalone`
`kueue_admission_attempts_total`	计数器	尝试接纳工作负载的总次数。每次接纳尝试可能尝试接纳多于一个工作负载。标签 ‘result’ 可以有以下值： - ‘success’ 表示至少有一个工作负载被接纳， - ‘inadmissible’ 表示没有工作负载被接纳。	`result`: 可能的值为 `success` 或 `inadmissible` `replica_role`: 可以为 `leader`、`follower` 或 `standalone`

ClusterQueue 状态

使用以下指标来监控你的 ClusterQueues 的状态：

Kueue API

Mon, 01 Jan 0001 00:00:00 +0000

Resource Types

`AdmissionCheck`

Appears in:

AdmissionCheck is the Schema for the admissionchecks API

Kueue Configuration v1beta1 API

Mon, 01 Jan 0001 00:00:00 +0000

资源类型

Configuration

`Configuration`

Configuration 是 kueueconfigurations API 的 Schema

字段	描述
`apiVersion` string	`config.kueue.x-k8s.io/v1beta1`
`kind` string	`Configuration`
`namespace` [必需] `string`	Namespace 是 Kueue 部署的命名空间。它用作 Webhook Service 的 DNSName 的一部分。如果未设置，该值将从文件 /var/run/secrets/kubernetes.io/serviceaccount/namespace 中设置如果文件不存在，默认值为 kueue-system。