https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/Recent content in 可观测性 on KueueHugozh-cnMon, 20 Jul 2026 00:10:19 -0700https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/setup_prometheus/Wed, 04 Feb 2026 00:00:00 +0000https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/setup_prometheus/<p>此页面展示了如何设置 Prometheus 以抓取 Kueue 指标。 对于使用 TLS 保护的指标端点，请参阅<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/productization/prometheus/">使用 TLS 配置 Prometheus</a>。</p> <p>本页面适用于<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/#batch-administrator">批处理管理员</a>。</p> <h2 id="开始之前"> 开始之前 <a href="#%e5%bc%80%e5%a7%8b%e4%b9%8b%e5%89%8d" class="anchor-link"> <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"> <path d="M0 0h24v24H0z" fill="none"></path> <path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"></path> </svg> </a> </h2> <p>确保满足以下条件：</p> <ul> <li>Kubernetes 集群正在运行。</li> <li>kubectl 命令行工具可以与你的集群通信。</li> <li><a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/installation/">Kueue 已安装</a>。</li> <li>Prometheus Operator 已<a href="https://prometheus-operator.dev/docs/getting-started/installation/">安装</a>。</li> </ul> <h2 id="1-设置"> 1. 设置 <a href="#1-%e8%ae%be%e7%bd%ae" class="anchor-link"> <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"> <path d="M0 0h24v24H0z" fill="none"></path> <path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"></path> </svg> </a> </h2> <p>选择与你的 Kueue 安装匹配的设置方法。</p>https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/common_grafana_queries/Tue, 03 Feb 2026 00:00:00 +0000https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/common_grafana_queries/<p>此页面向你展示如何使用常见的 PromQL 查询在 Grafana 中监控 Kueue 指标。</p> <p>此页面的目标读者为<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/#batch-administrator">批处理管理员</a>。</p> <h2 id="开始之前"> 开始之前 <a href="#%e5%bc%80%e5%a7%8b%e4%b9%8b%e5%89%8d" class="anchor-link"> <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"> <path d="M0 0h24v24H0z" fill="none"></path> <path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"></path> </svg> </a> </h2> <p>确保满足以下条件：</p> <ul> <li>Kubernetes 集群正在运行。</li> <li>kubectl 命令行工具能够与你的集群通信。</li> <li><a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/installation/">Kueue 已安装</a>。</li> <li><a href="https://github.com/prometheus-operator/kube-prometheus">kube-prometheus</a> 已安装。</li> <li>Kueue Prometheus 指标已启用（参见<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/setup_prometheus/">设置 Prometheus</a>）。</li> </ul> <h2 id="配额利用率"> 配额利用率 <a href="#%e9%85%8d%e9%a2%9d%e5%88%a9%e7%94%a8%e7%8e%87" class="anchor-link"> <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"> <path d="M0 0h24v24H0z" fill="none"></path> <path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"></path> </svg> </a> </h2> <div class="alert alert-primary" role="alert"> <h4 class="alert-heading">注意</h4> 本部分的查询需要在 Kueue 配置中设置 <code>metrics.enableClusterQueueResources: true</code>。 详情参见<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/installation/#install-a-custom-configured-released-version">安装</a>。 </div> <p>要监控 ClusterQueue 中正在使用的 CPU 配额百分比：</p>https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/configure_custom_metric_labels/Tue, 10 Mar 2026 00:00:00 +0000https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/configure_custom_metric_labels/<p>本页面向你展示如何配置自定义指标标签，这些标签将 Kubernetes 标签或注解从 ClusterQueue、LocalQueue 和 Cohort 提升为额外的 Prometheus 指标标签维度。</p> <p>本页面的目标受众是<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/#batch-administrator">批处理管理员</a>。</p> <h2 id="开始之前"> 开始之前 <a href="#%e5%bc%80%e5%a7%8b%e4%b9%8b%e5%89%8d" class="anchor-link"> <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"> <path d="M0 0h24v24H0z" fill="none"></path> <path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"></path> </svg> </a> </h2> <p>确保满足以下条件：</p> <ul> <li>一个 Kubernetes 集群正在运行。</li> <li>kubectl 命令行工具能够与你的集群通信。</li> <li><a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/installation/">Kueue 已安装</a>。</li> <li>Prometheus 已<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/tasks/manage/observability/setup_prometheus/">设置</a>以抓取 Kueue 指标。</li> </ul> <h2 id="配置自定义标签"> 配置自定义标签 <a href="#%e9%85%8d%e7%bd%ae%e8%87%aa%e5%ae%9a%e4%b9%89%e6%a0%87%e7%ad%be" class="anchor-link"> <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" width="24" height="24" viewBox="0 0 24 24"> <path d="M0 0h24v24H0z" fill="none"></path> <path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"></path> </svg> </a> </h2> <p>自定义指标标签需要 <code>CustomMetricLabels</code> 特性门控，它是 Alpha 级别且默认禁用。 关于如何启用特性门控的详情，请参见<a href="https://kueue.sigs.k8s.io/zh-cn/v0.18/docs/installation/#change-the-feature-gates-configuration">安装</a>。</p>