View a markdown version of this page

Integrar o Amazon EKS - Amazon CloudWatch

Integrar o Amazon EKS

Um coletor do Prometheus gerenciado pelo Amazon CloudWatch extrai métricas compatíveis com o Prometheus. Para obter mais informações sobre as métricas compatíveis com o Prometheus, consulte O que são métricas compatíveis com o Prometheus?. Os clusters do Amazon EKS expõem métricas para o servidor da API. Clusters do Amazon EKS na versão 1.28 ou superior do Kubernetes também expõem métricas para o kube-scheduler e o kube-controller-manager. Para obter mais informações, consulte Obter as métricas brutas do ambiente de gerenciamento no formato do Prometheus no Guia do usuário do Amazon EKS.

O Guia do usuário do Amazon Managed Service for Prometheus fornece instruções detalhadas de configuração. Para obter instruções sobre como configurar clusters do Amazon EKS, entradas de acesso e o ConfigMap, consulte Configurar coletores gerenciados para o Amazon EKS.

nota

O coletor enriquece cada métrica do Amazon EKS com atributos que identificam sua origem: o escopo da instrumentação, a conta e a região da AWS, uma unidade inferida e o nome e o ARN do cluster. Você pode filtrar e agrupar nesses atributos ao consultar suas métricas com o PromQL.

Criar um extrator com o destino do CloudWatch

Você pode usar GetDefaultScraperConfiguration para recuperar uma configuração de extrator de uso geral ou fornecer a sua própria.

AWS API

Use a operação da API CreateScraper para criar um extrator com um destino do CloudWatch. Substitua as informações da conta da AWS, do grupo de segurança, da sub-rede, do cluster do Amazon EKS e do conjunto de dados por seus próprios valores.

POST /scrapers HTTP/1.1 { "alias": "eks-metrics-scraper", "source": { "eksConfiguration": { "clusterArn": "arn:aws:eks:us-west-2:123456789012:cluster/my-cluster", "securityGroupIds": ["sg-security-group-id"], "subnetIds": ["subnet-subnet-id-1", "subnet-subnet-id-2"] } }, "destination": { "cloudWatchConfiguration": { "datasetArn": "arn:aws:cloudwatch:us-west-2:123456789012:dataset/default" } }, "scrapeConfiguration": { "configurationBlob": "base64-encoded-blob" } }
AWS CLI

Use o comando create-scraper para criar um extrator com um destino do CloudWatch. Substitua as informações da conta da AWS, do grupo de segurança, da sub-rede, do cluster do Amazon EKS e do conjunto de dados por seus próprios valores.

aws amp create-scraper \ --alias "eks-metrics-scraper" \ --source eksConfiguration="{clusterArn='arn:aws:eks:us-west-2:123456789012:cluster/my-cluster', \ securityGroupIds=['sg-security-group-id'], \ subnetIds=['subnet-subnet-id-1','subnet-subnet-id-2']}" \ --scrape-configuration configurationBlob=$(cat eks-config.yaml | base64 -w 0) \ --destination cloudWatchConfiguration="{datasetArn='arn:aws:cloudwatch:us-west-2:123456789012:dataset/default'}"

Visualizar o painel automático

Depois que o coletor começa a entregar suas métricas do Amazon EKS para o CloudWatch, o console do CloudWatch fornece um painel automático chamado EKS OTel. Para abri-lo, consulte ESK OTel ou faça login no Console de Gerenciamento da AWS, abra o console do CloudWatch, escolha Painéis no painel de navegação, depois Painéis automáticos e então ESK OTel. Você pode começar a monitorar seus clusters sem criar widgets ou painéis por conta própria.

Se o painel automático atender às suas necessidades, você poderá usá-lo como está. Para criar uma experiência de monitoramento personalizada, você pode adicionar qualquer um de seus widgets a um painel personalizado. Para obter mais informações sobre painéis personalizados, consulte Usar painéis do CloudWatch.

Observabilidade entre contas

Para o monitoramento entre contas do Amazon EKS, recomendamos usar a centralização de métricas do Amazon CloudWatch. Para obter mais informações, consulte Centralização de métricas do CloudWatch.

Para configurações alternativas de extratores entre contas, consulte Extratores entre contas no Guia do usuário do Amazon Managed Service for Prometheus.