Reference on Kueue

Labels and Annotations

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

This page serves as a reference for all labels and annotations in 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 Metrics

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

Note

To enable metrics scraping, see Setup Prometheus.

Kueue exposes prometheus metrics to monitor the health of the system and the status of ClusterQueues and LocalQueues.

Kueue health

Use the following metrics to monitor the health of the kueue controllers:

Kueue Configuration v1beta1 API

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

Resource Types

Configuration

`Configuration`

Configuration is the Schema for the kueueconfigurations API

Field Description

apiVersion
string config.kueue.x-k8s.io/v1beta1

kind
string Configuration

namespace [Required]
string

Namespace is the namespace in which kueue is deployed. It is used as part of DNSName of the webhook Service. If not set, the value is set from the file /var/run/secrets/kubernetes.io/serviceaccount/namespace If the file doesn't exist, default value is kueue-system.

Kueue Configuration v1beta2 API

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

Resource Types

Configuration

`Configuration`

Configuration is the Schema for the kueueconfigurations API

Field Description

apiVersion
string config.kueue.x-k8s.io/v1beta2

kind
string Configuration

namespace [Required]
string

Kueue v1beta1 API

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

Resource Types

`AdmissionCheck`

Appears in:

Kueue v1beta2 API

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

Resource Types

`AdmissionCheck`

Appears in: