Repolode
kubernetes-sigs

kubernetes-sigs/metrics-server

Fonte escalável de métricas de CPU e memória dos recursos de contêineres para autoscaling no Kubernetes, disponibilizada pela Metrics API.

Estrelas
6,763
Forks
2,054
Issues abertas
68
Último commit
há 9 dias

O que é?

O Metrics Server coleta métricas de recursos dos Kubelets e as expõe pelo apiserver do Kubernetes via Metrics API. O Horizontal Pod Autoscaler e o Vertical Pod Autoscaler usam esses dados para tomar decisões de escalabilidade, e o kubectl top consulta a mesma API para exibir o uso de recursos de pods e nós.

O projeto foi criado exclusivamente para autoscaling, não para monitoramento geral. Para encaminhar dados a um sistema de monitoramento, o projeto recomenda coletar as métricas diretamente do endpoint /metrics/resource do Kubelet. O Metrics Server foi projetado para uma única implantação leve, com solicitações de recursos padrão adequadas a clusters de até cerca de 100 nós e orientações para escalar além desse limite.

O cluster precisa habilitar a camada de agregação do apiserver e a autenticação e autorização via webhook do Kubelet. Também é necessário que o certificado do Kubelet seja assinado pela CA do cluster ou usar explicitamente a flag insecure-TLS. A instalação está disponível por meio de um manifesto YAML ou do chart oficial do Helm, com modo de alta disponibilidade para clusters com vários nós.

Recursos principais

  • 01Coleta o uso de CPU e memória dos Kubelets a cada 15 segundos.
  • 02Expõe métricas de pods e nós pela Metrics API padrão do Kubernetes.
  • 03Fornece dados para as decisões do Horizontal Pod Autoscaler e do Vertical Pod Autoscaler.
  • 04Permite usar kubectl top para consultar rapidamente o uso de recursos.
  • 05Oferece modo de alta disponibilidade com várias réplicas.
  • 06Permite configurar os tipos de endereço do Kubelet e as opções de TLS.

Casos de uso

  • Escalar Deployments horizontalmente com base no uso de CPU ou memória.
  • Obter sugestões de dimensionamento vertical para as solicitações de recursos dos contêineres.
  • Depurar o comportamento do autoscaling com kubectl top.
  • Executar uma fonte leve de métricas em clusters Kubernetes de médio porte.

Início rápido

  1. 1

    Instale a versão mais recente a partir do manifesto components.yaml

    kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml
  2. 2

    Verifique as métricas com kubectl top (após aguardar um pouco)

    kubectl top pods

Antes de usar

  • Requer uma configuração específica do cluster, como uma camada de agregação habilitada e certificados do kubelet assinados pela CA do cluster.
  • Foi desenvolvido apenas para escalonamento automático; o README diz para não usá-lo como fonte de métricas de monitoramento.
  • As solicitações de recursos padrão são ajustadas para até cerca de 100 nós; clusters maiores precisam de mais recursos.

Em coleções

Tópicos

Perguntas frequentes

O que é metrics-server?
Fonte escalável de métricas de CPU e memória dos recursos de contêineres para autoscaling no Kubernetes, disponibilizada pela Metrics API. O Metrics Server coleta métricas de recursos dos Kubelets e as expõe pelo apiserver do Kubernetes via Metrics API. O Horizontal Pod Autoscaler e o Vertical Pod Autoscaler usam esses dados para tomar decisões de escalabilidade, e o kubectl top consulta a mesma API para exibir o uso de recursos de pods e nós.
metrics-server é gratuito? Qual é a licença?
metrics-server é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
metrics-server ainda é mantido?
Manutenção ativa. O último commit de metrics-server foi em 16 de out. de 2026.
Para que posso usar metrics-server?
Escalar Deployments horizontalmente com base no uso de CPU ou memória. Obter sugestões de dimensionamento vertical para as solicitações de recursos dos contêineres. Depurar o comportamento do autoscaling com kubectl top. Executar uma fonte leve de métricas em clusters Kubernetes de médio porte.
Como instalar metrics-server?
Instale a versão mais recente a partir do manifesto components.yaml: kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml Verifique as métricas com kubectl top (após aguardar um pouco): kubectl top pods
Onde consigo metrics-server?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kubernetes-sigs/metrics-server

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados