# Integración de Amazon EKS
<a name="managed-prometheus-collectors-eks-setup"></a>

Un recopilador de Prometheus administrado por Amazon CloudWatch extrae métricas que son compatibles con Prometheus. Para obtener más información acerca de las métricas compatibles con Prometheus, consulte [¿Cuáles son las métricas compatibles con Prometheus?](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-prometheus-compatible-metrics.html) Los clústeres de Amazon EKS exponen las métricas del servidor de API. Los clústeres de Amazon EKS de la versión 1.28 y posteriores de Kubernetes también exponen métricas para kube-scheduler y kube-controller-manager. Para obtener más información, consulte [Obtención de métricas sin procesar del plano de control en formato Prometheus](https://docs.aws.amazon.com/eks/latest/userguide/prometheus.html) en la *Guía del usuario de Amazon EKS*.

En la *Guía del usuario de Amazon Managed Service para Prometheus* se proporcionan instrucciones de configuración detalladas. Para obtener instrucciones sobre cómo configurar los clústeres de Amazon EKS, las entradas de acceso y la configuración de ConfigMap, consulte [Configuración de recopiladores administrados para Amazon EKS](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html).

**nota**  
El recopilador enriquece cada métrica de Amazon EKS con atributos que identifican su origen: el alcance de la instrumentación, la cuenta de AWS y la región, una unidad inferida y el nombre y el ARN del clúster. Puede filtrar y agrupar estos atributos cuando consulte sus métricas con PromQL.

## Creación de un extractor con un destino de CloudWatch
<a name="managed-prometheus-collectors-eks-create-scraper"></a>

Puede utilizar [GetDefaultScraperConfiguration](https://docs.aws.amazon.com/prometheus/latest/APIReference/API_GetDefaultScraperConfiguration.html) para recuperar la configuración de un extractor de uso general o proporcionar la suya propia.

------
#### [ AWS API ]

Utilice la operación de la API `CreateScraper` para crear un extractor con un destino de CloudWatch. Sustituya la información de la cuenta de AWS, el grupo de seguridad, la subred, el clúster de Amazon EKS y el conjunto de datos por sus propios 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 ]

Utilice el comando `create-scraper` para crear un extractor con un destino de CloudWatch. Sustituya la información de la cuenta de AWS, el grupo de seguridad, la subred, el clúster de Amazon EKS y el conjunto de datos por sus propios 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'}"
```

------

## Visualización del panel automático
<a name="managed-prometheus-collectors-eks-dashboards"></a>

Cuando el recopilador comienza a enviar las métricas de Amazon EKS a CloudWatch, la consola de CloudWatch proporciona un panel automático denominado **EKS OTel**. Para abrirlo, consulte [EKS OTel](https://console.aws.amazon.com/cloudwatch/home?#dashboards/templates/eks-otel) o inicie sesión en la Consola de administración de AWS, abra la consola de CloudWatch, elija **Paneles** en el panel de navegación, elija **Paneles automáticos** y, a continuación, elija **EKS OTel**. Puede empezar a supervisar sus clústeres sin necesidad de crear ningún widget o panel usted mismo.

Si el panel automático satisface sus necesidades, puede usarlo tal cual. Para crear una experiencia de supervisión personalizada, puede agregar cualquiera de sus widgets a un panel personalizado. Para obtener más información sobre los paneles personalizados, consulte [Uso de paneles de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).

## Observabilidad entre cuentas
<a name="managed-prometheus-collectors-eks-cross-account"></a>

Para la supervisión de Amazon EKS entre cuentas, recomendamos utilizar la centralización de métricas de Amazon CloudWatch. Para obtener más información, consulte [Centralización de métricas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html).

Para ver configuraciones alternativas de extractores multicuenta, consulte [Extractores multicuenta](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-cross-account.html) en la *Guía del usuario de Amazon Managed Service para Prometheus*.