Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Kube-controller-manager metrics and dashboard

Última atualização: Oct 15, 2026

Visualize as métricas de workqueue, recursos e Kube API do kube-controller-manager no painel de monitoramento.

Conceitos principais

Workqueue

Terminologia da Workqueue

Os controllers gerenciados pelo kube-controller-manager, como Node Controller, StatefulSet Controller e Deployment Controller, usam uma Workqueue para processar atualizações de recursos. Quando ocorre um evento, como criação, atualização ou exclusão de Pod, o controller insere o identificador do recurso (por exemplo, nome e namespace do Pod) na Workqueue. Um loop de trabalho recupera e processa esses identificadores.

Antes de começar

Acessar o painel

Consulte Visualize monitoring dashboards for cluster control plane components.

Lista de métricas

A tabela a seguir lista as métricas do kube-controller-manager.

Métrica

Tipo

Descrição

workqueue_adds_total

Counter

Total de eventos adicionados à Workqueue.

workqueue_depth

Gauge

Profundidade atual da Workqueue. Um valor alto persistente indica que o controller não processa tarefas com rapidez suficiente, causando acúmulo.

workqueue_queue_duration_seconds_bucket

Histogram

Tempo de espera de um item na Workqueue. Limiares dos buckets: {10-8, 10-7, 10-6, 10-5, 10-4, 10-3, 10-2, 10-1, 1, 10}. Unidade: segundos.

memory_utilization_byte

Gauge

Utilização de memória. Unidade: bytes.

cpu_utilization_core

Gauge

Utilização de CPU. Unidade: núcleos.

resource_utilization_level

Gauge

Nível de utilização de recursos.

  • resource: tipo de recurso. Valores válidos: cpu e memory.

  • utilization_level: nível de utilização. Valores válidos: high (utilização ≥ 80%) e normal (utilização < 80%).

  • container: container de destino. Valores válidos: kube-apiserver, kube-scheduler, kube-controller-manager, cloud-controller-manager e etcd.

rest_client_requests_total

Counter

Total de requisições HTTP por código de status, método e host.

rest_client_request_duration_seconds_bucket

Histogram

Latência de requisições HTTP por verbo e URL.

Nota

As seguintes métricas de utilização de recursos estão descontinuadas. Remova alertas ou regras de monitoramento que dependam delas:

  • cpu_utilization_ratio: utilização de CPU.

  • memory_utilization_ratio: utilização de memória.

Uso do painel

Configure o quantile da requisição e o interval de amostragem PromQL no painel. As seções a seguir descrevem cada gráfico e sua consulta PromQL correspondente.

Workqueue

Visualização do painelkcm1

Gráficos

Nome

PromQL

Descrição

Workqueue Add Rate

sum(rate(workqueue_adds_total{job="ack-kube-controller-manager"}[$interval])) by (name)

Taxa de eventos adicionados à Workqueue.

Workqueue Depth

sum(rate(workqueue_depth{job="ack-kube-controller-manager"}[$interval])) by (name)

Taxa média de variação da profundidade da Workqueue.

Workqueue Processing Latency

histogram_quantile($quantile, sum(rate(workqueue_queue_duration_seconds_bucket{job="ack-kube-controller-manager"}[5m])) by (name, le))

Tempo de espera de um item na Workqueue.

Recursos

Visualização do painel

image

Gráficos

Nome do gráfico

PromQL

Descrição

Memory Utilization

memory_utilization_byte{container="kube-controller-manager"}

Utilização de memória. Unidade: bytes.

CPU Utilization

cpu_utilization_core{container="kube-controller-manager"}*1000

Utilização de CPU. Unidade: milinúcleos.

Memory Resource Utilization Level

  • resource_utilization_level{resource="memory",container="kube-controller-manager",utilization_level="high"}

  • resource_utilization_level{resource="memory",container="kube-controller-manager",utilization_level="normal"}

  • Se resource_utilization_level{utilization_level="high",...} for 1, o nível de utilização de recursos do container é ≥ 80%.

  • Se resource_utilization_level{utilization_level="normal",...} for 1, o nível de utilização de recursos do container é < 80%.

CPU Resource Utilization Level

  • resource_utilization_level{resource="cpu",container="kube-controller-manager",utilization_level="high"}

  • resource_utilization_level{resource="cpu",container="kube-controller-manager",utilization_level="normal"}

Kube API

Visualização do painelkcm3

Gráficos

Nome do gráfico

PromQL

Descrição

Kube API Request QPS

  • sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"2.."}[$interval])) by (method,code)

  • sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"3.."}[$interval])) by (method,code)

  • sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"4.."}[$interval])) by (method,code)

  • sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"5.."}[$interval])) by (method,code)

QPS de requisições HTTP do kube-controller-manager para o kube-apiserver, por método e código de status.

Kube API Request Latency

histogram_quantile($quantile, sum(rate(rest_client_request_duration_seconds_bucket{job="ack-kube-controller-manager"}[$interval])) by (verb,url,le))

Latência de requisições HTTP do kube-controller-manager para o kube-apiserver, por verbo e URL.

Referências

Para métricas e painéis de outros componentes do plano de controle, consulte Monitoring metrics for the kube-apiserver component, Monitoring metrics for the etcd component, Monitoring metrics for the kube-scheduler component e Monitoring metrics for the cloud-controller-manager component.