Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# CloudWatch Agente de Amazon
El CloudWatch agente de Amazon en Amazon EMR es una herramienta que puede supervisar las instancias de Amazon EC2 de su clúster de EMR. Puede almacenar y ver las métricas que recopila con el CloudWatch agente. CloudWatch Para obtener más información sobre el CloudWatch agente, consulta la [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html).
**nota**
Incurrirás en cargos adicionales si utilizas otros Servicios de AWS para publicar, consultar o ver las estadísticas de los CloudWatch agentes de Amazon. Para obtener más información, consulte las páginas siguientes sobre precios.
[ CloudWatch Precios de Amazon](https://aws.amazon.com/cloudwatch/pricing/)
[Amazon Managed Service para precios de Prometheus](https://aws.amazon.com/prometheus/pricing/)
[Precios de Amazon Managed Grafana](https://aws.amazon.com/grafana/pricing/)
Estas métricas son independientes de las métricas gratuitas que Amazon EMR proporciona en el espacio de `AWS/ElasticMapReduce` nombres de. CloudWatch Para obtener más información sobre las métricas que el CloudWatch agente no publica, consulte [Supervisión de las métricas de Amazon EMR](https://docs.aws.amazon.com/emr/latest/ManagementGuide/UsingEMR_ViewingMetrics.html) con. CloudWatch
Con Amazon EMR 7.0 y versiones posteriores, puede instalar una versión personalizada del CloudWatch agente de Amazon en su clúster para recopilar métricas de su clúster de EMR. CloudWatchAgent es compatible con los clústeres de roles en tiempo de ejecución para EMR 7.6 y versiones posteriores. El agente recopila las métricas de todos los nodos en el clúster, las reúne en el nodo principal y las publica desde ese nodo en la nube.
Puede instalar el agente al crear un nuevo clúster en la consola o al utilizar la API `create-cluster`. Para obtener más información, consulte [Cree un clúster de EMR que utilice Amazon Agent CloudWatch](AmazonCloudWatchAgent-create.md). De forma predeterminada, un clúster de Amazon EMR que ejecuta la serie 7.x publica [34 métricas a nivel de sistema CloudWatch en intervalos de](AmazonCloudWatchAgent-metrics.md) 60 segundos, pero puede configurar el agente para que publique métricas diferentes. Otra opción es que publique métricas en Amazon Managed Service para Prometheus y puede elegir qué métricas desea que publique también. Para distintos casos de uso y configuraciones, puede configurar el agente para que vea y consulte las métricas en la CloudWatch consola, en Grafana gestionada por Amazon o a través APIs del for CloudWatch o Amazon Managed Service for Prometheus. Se aplican cargos de Servicios de AWS cuando se utilizan para almacenar y consultar métricas.
El CloudWatch agente de Amazon EMR puede publicar métricas del sistema y métricas de JMX para los siguientes servicios en su clúster de Amazon EMR.
+ Hadoop DataNode
+ Hadoop NameNode
+ Hilo NodeManager
+ Hilo ResourceManager
+ HBase Master: solo Amazon EMR 7.1\$1
+ HBase RegionServer — Amazon EMR 7.1\$1 únicamente
+ HBase ThriftServer — Amazon EMR 7.1\$1 únicamente
Para obtener más información sobre las métricas disponibles y sobre cómo configurar el CloudWatch agente en Amazon EMR, consulte [Configuración del CloudWatch agente para Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-config.html).
En la siguiente tabla se muestra la versión AmazonCloudWatchAgent incluida en la última versión de la serie Amazon EMR 7.x, junto con los componentes con los que se instala Amazon EMR. AmazonCloudWatchAgent
[Para ver la versión de los componentes que se incluyen AmazonCloudWatchAgent en esta versión, consulte Versiones de componentes de la versión 7.12.0.](emr-7120-release.md)
**AmazonCloudWatchAgent información sobre la versión de emr-7.12.0**
| Etiqueta de versión de Amazon EMR | AmazonCloudWatchAgent Versión | Componentes instalados con AmazonCloudWatchAgent |
| --- | --- | --- |
| emr-7.12.0 | AmazonCloudWatchAgent 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-hdfs-zkfc, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
**Topics**
+ [Cree un clúster de EMR que utilice Amazon Agent CloudWatch](AmazonCloudWatchAgent-create.md)
+ [Métricas predeterminadas para el CloudWatch agente con Amazon EMR](AmazonCloudWatchAgent-metrics.md)
+ [CloudWatch Agente de configuración para Amazon EMR](AmazonCloudWatchAgent-config.md)
+ [Consideraciones y limitaciones](AmazonCloudWatchAgent-considerations.md)
+ [CloudWatch historial de versiones de los agentes](AmazonCloudWatchAgent-release-history.md)
# Cree un clúster de EMR que utilice Amazon Agent CloudWatch
Los procedimientos de esta sección describen los pasos para crear un clúster en Amazon EMR con un CloudWatch agente de Amazon desde Consola de administración de AWS y desde. AWS CLI
**Topics**
+ [Permisos de IAM necesarios para el agente CloudWatch](#AmazonCloudWatchAgent-permissions)
+ [Punto final CloudWatch de agente obligatorio](#AmazonCloudWatchAgent-endpoints)
+ [Creación de un clúster de EMR](#AmazonCloudWatchAgent-create-cluster)
## Permisos de IAM necesarios para el agente CloudWatch
El CloudWatch agente necesita el `cloudwatch:PutMetricData` permiso AWS Identity and Access Management (IAM) en el perfil de instancia de Amazon EC2 para Amazon EMR. El rol predeterminado de Amazon EMR ya tiene este permiso. Puede crear el rol predeterminado desde aquí. AWS CLI `aws emr create-default-roles` Para más información, consulte [Rol de servicio para instancias de EC2 del clúster (perfil de instancia de EC2)](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-iam-role-for-ec2.html) en la *Guía de administración de Amazon EMR.*
El siguiente ejemplo de política de IAM incluye el permiso `cloudwatch:PutMetricData`:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:PutMetricData"
],
"Resource": [
"*"
],
"Sid": "AllowCLOUDWATCHPutmetricdata"
}
]
}
```
------
## Punto final CloudWatch de agente obligatorio
Para publicar las métricas de un clúster de EMR en una subred privada, cree un punto final de CloudWatch agente y asócielo a la VPC en la que se encuentra la subred privada. CloudWatch
Para obtener más información sobre los CloudWatch puntos de enlace de cada uno Región de AWS, consulta los [ CloudWatch puntos de enlace y las cuotas de Amazon](https://docs.aws.amazon.com/general/latest/gr/cw_region.html) en la Guía de *referencia AWS general*.
## Creación de un clúster de EMR
Una vez que haya configurado los permisos y el punto de conexión necesarios para su uso con el CloudWatch agente, utilice el Consola de administración de AWS o el AWS CLI para crear un nuevo clúster con el agente instalado.
------
#### [ Console ]
**Para crear un clúster con Amazon CloudWatch Agent desde la consola**
1. Vaya a la consola de Amazon EMR.
1. Elija **Create cluster**.
1. En **Nombre y aplicaciones**, elija la versión de Amazon EMR 7.0.0 o posterior.
1. En **Paquete de aplicaciones**, selecciona el paquete o las aplicaciones que deseas instalar en tu clúster e incluye el **CloudWatch agente** entre tus selecciones.
1. Continúe con la creación del clúster que se ajuste a las necesidades del caso de uso.
------
#### [ AWS CLI ]
En AWS CLI, puedes añadir un CloudWatch agente de Amazon a un clúster con el `--applications` parámetro for`create-cluster`.
**Para crear un clúster con un CloudWatch agente de Amazon desde el AWS CLI**
+ Cuando crees un clúster, usa un comando similar al siguiente para incluir el CloudWatch agente de Amazon. Reemplace `myKey` por el nombre del par de claves de EC2.
```
aws emr create-cluster --name "Spark cluster with CloudWatch agent" \
--release-label emr-7.0.0 \
--applications Name=Spark Name=AmazonCloudWatchAgent \
--ec2-attributes KeyName=myKey --instance-type m7g.2xlarge \
--instance-count 3 --use-default-roles
```
Para obtener más información sobre cómo utilizar Amazon EMR con el AWS CLI, consulte la Referencia de [AWS CLI comandos](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/emr/index.html).
------
# Métricas predeterminadas para el CloudWatch agente con Amazon EMR
Al instalar el CloudWatch agente de Amazon en Amazon EMR, la configuración predeterminada publica las siguientes métricas del sistema para todas las instancias del clúster, a menos que [configure el agente](AmazonCloudWatchAgent-config.md) de forma diferente. Para ver las definiciones de cada métrica, consulta [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html) en la *Guía del CloudWatch usuario de Amazon*.
------
#### [ CPU ]
**Métricas de CPU**
+ `cpu_usage_active`
+ `cpu_usage_guest`
+ `cpu_usage_guest_nice`
+ `cpu_usage_idle`
+ `cpu_usage_iowait`
+ `cpu_usage_irq`
+ `cpu_usage_nice`
+ `cpu_usage_softirq`
+ `cpu_usage_steal`
+ `cpu_usage_system`
+ `cpu_usage_user`
------
#### [ Disk ]
**Métricas de disco**
+ `disk_free`
+ `disk_total`
+ `disk_used`
+ `disk_used_percent`
------
#### [ Memory ]
**Métricas de memoria**
+ `mem_active`
+ `mem_available`
+ `mem_available_percent`
+ `mem_free`
+ `mem_inactive`
+ `mem_total`
+ `mem_used`
+ `mem_used_percent`
+ `mem_buffered`
+ `mem_cached`
------
#### [ Network IO ]
**Métricas de E/S de red**
+ `net_bytes_recv`
+ `net_bytes_sent`
+ `net_packets_recv`
+ `net_packets_sent`
------
#### [ Process ]
**Métricas de proceso**
+ `processes_running`
+ `processes_total`
------
#### [ Swap ]
**Métricas de intercambio**
+ `swap_free`
+ `swap_used`
+ `swap_used_percent`
------
De forma predeterminada, el agente publica todas las métricas CloudWatch en el espacio de nombres `CWAgent` personalizado y en el esquema`cluster.id`,,`instance.id`,`node.type`. `service.name` Siga los siguientes pasos para ver estas métricas predeterminadas que el CloudWatch agente publica para Amazon EMR:
1. Ve a la CloudWatch consola de Amazon.
1. Elija la pestaña **Métricas** y, a continuación, **Todas las métricas**.
1. En **Espacios de nombres personalizados**, seleccione **`CWAgent`**. A continuación, seleccione el esquema: **`cluster.id`, `instance.id`, `node.type`, `service.name`**.
1. Siga consultando las métricas desde la CloudWatch interfaz según lo requiera su caso de uso.
Amazon EMR asocia las siguientes etiquetas a cada métrica: `["cluster.id", "instance.id', "node.type", "service.name"]`. Tenga en cuenta lo siguiente con respecto a estas etiquetas:
+ El valor de la etiqueta `cluster.id` es el ID del clúster de EMR que produjo la métrica. Un ejemplo de valor de la etiqueta `cluster.id` es: `j-123456789ABC`.
+ El valor de la etiqueta `instance.id` es el ID de la instancia del clúster de EMR que produjo la métrica. Un ejemplo de valor de la etiqueta `instance.id` es: `i-01bcf5f140f3355777`.
+ El valor de la etiqueta `node.type` representa el tipo de nodo de la instancia del clúster que produjo la métrica. El valor puede ser `master`, `core` o `task`.
+ El valor de la etiqueta `service.name` es el nombre del servicio que produjo la métrica. El valor predeterminado del `service.name` de las métricas predeterminadas del sistema es `system`.
**nota**
La versión 7.0.0 de Amazon EMR utiliza un esquema de etiquetas de métricas ligeramente diferente. `cluster.id` es `jobflow.id` y `node.type` no está disponible. `instance.id` y `service.name` están disponibles.
# CloudWatch Agente de configuración para Amazon EMR
Amazon EMR 7.0.0 y versiones posteriores incluyen el agente de Amazon. CloudWatch En las siguientes secciones, se describe cómo configurar el agente en su clúster de EMR, tal y como se describe en [Cree un clúster de EMR que utilice Amazon Agent CloudWatch](AmazonCloudWatchAgent-create.md).
**Topics**
+ [Configurar el CloudWatch agente para Amazon EMR 7.1.0](AmazonCloudWatchAgent-config-710.md)
+ [Configurar el CloudWatch agente para Amazon EMR 7.0.0](AmazonCloudWatchAgent-config-700.md)
# Configurar el CloudWatch agente para Amazon EMR 7.1.0
A partir de Amazon EMR 7.1.0, puede configurar el CloudWatch agente de Amazon para que utilice métricas de sistema adicionales, añada métricas de aplicación y cambie el destino de las métricas mediante la API de configuración de Amazon EMR. Para obtener más información sobre cómo usar la API de configuración de EMR para configurar las aplicaciones del clúster, consulte [Configuración de aplicaciones](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps.html).
**nota**
7.1.0 solo admite el tipo de reconfiguración `OVERWRITE`. Para obtener más información sobre los tipos de reconfiguración, consulte [Consideraciones a la hora de reconfigurar un grupo de instancias](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps-running-cluster.html#emr-configure-apps-running-cluster-considerations).
**Topics**
+ [Esquema de configuración](#AmazonCloudWatchAgent-config-710-config-schema)
+ [Ejemplos de configuraciones de métricas del sistema](#AmazonCloudWatchAgent-config-710-system-examples)
+ [Ejemplos de configuraciones de métricas de aplicación](#AmazonCloudWatchAgent-config-710-application-examples)
+ [Amazon Managed Service para Prometheus](#AmazonCloudWatchAgent-config-710-prometheus-examples)
## Esquema de configuración
`emr-metrics` tiene las siguientes clasificaciones:
+ `emr-system-metrics`: configura las métricas del sistema, como CPU, disco y memoria.
+ `emr-hadoop-hdfs-datanode-metrics`— configurar las métricas JMX de Hadoop DataNode
+ `emr-hadoop-hdfs-namenode-metrics`— configurar las métricas de Hadoop JMX NameNode
+ `emr-hadoop-yarn-nodemanager-metrics`— configurar las métricas de Yarn JMX NodeManager
+ `emr-hadoop-yarn-resourcemanager-metrics`— configurar las métricas de Yarn ResourceManager JMX
+ `emr-hbase-master-metrics`— configurar las métricas de HBase Master JMX
+ `emr-hbase-region-server-metrics`— configurar las métricas HBase JMX de Region Server
+ `emr-hbase-rest-server-metrics`— configurar las métricas HBase JMX del servidor REST
+ `emr-hbase-thrift-server-metrics`— configurar las métricas JMX de HBase Thrift Server
Las tablas siguientes describen las propiedades y configuraciones disponibles para todas y cada una de las clasificaciones.
**propiedades de emr-metrics**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics\$1destination | Opcional | Determina si las métricas del clúster se publican en Amazon CloudWatch o en Amazon Managed Service for Prometheus. | "CLOUDWATCH" | "CLOUDWATCH", "PROMETHEUS" | Esta propiedad no distingue entre mayúsculas y minúsculas. Por ejemplo, “Cloudwatch” es lo mismo que “CLOUDWATCH”. |
| prometheus\$1endpoint | Opcional | Si metrics\$1destination se establece en «PROMETHEUS», esta propiedad configura el CloudWatch agente para enviar métricas al punto final de escritura remota de Amazon Managed Service for Prometheus proporcionado. | N/A | Cualquier URL de escritura remota de Amazon Managed Service para Prometheus. El formato de URL de escritura remota es https://aps-workspaces..amazonaws.com/workspaces//api/v1/remote_write
| Este campo solo se obligatorio si metrics\$1destination está establecido en "PROMETHEUS". El aprovisionamiento fallará si no proporciona una clave o si el valor es una cadena vacía. |
**emr-system-metrics propiedades**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics\$1collection\$1interval | Opcional | La frecuencia en cuestión de segundos que el agente recopila y publica las métricas. CloudWatch | "60" | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Puede anular esta propiedad con la propiedad metrics\$1collection\$1interval de grupos de métricas individuales. |
**emr-system-metrics configuraciones**
------
#### [ cpu ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de la CPU que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de la CPU válidos con o sin el prefijo cpu\$1, como usage\$1active y cpu\$1time\$1idle. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publica ninguna métrica de la CPU. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas de la CPU que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad del metrics\$1collection\$1interval global solo para las métricas de la CPU. |
| drop\$1original\$1metrics | Opcional | Lista de métricas de la CPU para las que no se deben publicar métricas no agregadas. | No se ha publicado ninguna métrica de CPU no agregada. | Una lista separada por comas de métricas de la CPU que también se especifican en la propiedad de métricas. Una cadena vacía indica que se publican todas las métricas de la CPU. | El CloudWatch agente agrega todas las métricas por ID de clúster, ID de instancia, tipo de nodo y nombre de servicio. De forma predeterminada, el CloudWatch agente no publica las métricas por recurso de las métricas con varios recursos. |
| resources | Opcional | Determina si el agente publicará las métricas por núcleo. | "\$1" | "\$1" habilita las métricas por núcleo. "" deshabilita las métricas por núcleo. | El CloudWatch agente solo publica las métricas por núcleo para las métricas de CPU que no se incluyen. drop\$1original\$1metrics |
------
#### [ disk ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de disco que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de disco válidos con o sin el prefijo disk\$1, como disk\$1total y used\$1percent. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publicará ninguna métrica de disco. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas del disco que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad de metrics\$1collection\$1interval global solo para las métricas de disco. |
| drop\$1original\$1metrics | Opcional | Lista de métricas de disco para las que no se deben publicar métricas no agregadas. | No se ha publicado ninguna métrica de disco no agregada. | Una lista separada por comas de métricas de disco que también se especifican en la propiedad de métricas. Una cadena vacía indica que se publican todas las métricas del disco. | El CloudWatch agente agrega todas las métricas por ID de clúster, ID de instancia, tipo de nodo y nombre de servicio. De forma predeterminada, el CloudWatch agente no publica las métricas por recurso de las métricas con varios recursos. |
| resources | Opcional | Determina si el agente publicará per-mount-point las métricas. | "\$1" | "\$1" significa todos los puntos de montaje, "" significa que no hay puntos de montaje o se trata de una lista de puntos de montaje separados por comas. Por ejemplo, "/,/emr". | El CloudWatch agente solo publica per-mount-point las métricas de disco que no se incluyendrop\$1original\$1metrics. |
------
#### [ diskio ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de E/S de disco que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de E/S de disco válidos con o sin el prefijodiskio\$1, como diskio\$1reads y writes. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publicará ninguna métrica de E/S del disco. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas de E/S del disco que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad de metrics\$1collection\$1interval global solo para las métricas de E/S del disco. |
| drop\$1original\$1metrics | Opcional | Lista de métricas de E/S del disco para las que no se deben publicar métricas no agregadas. | No se ha publicado ninguna métrica de E/S del disco no agregada. | Una lista separada por comas de métricas de E/S del disco que también se especifican en la propiedad de métricas. Una cadena vacía indica que se publican todas las métricas de E/S del disco. | El CloudWatch agente agrega todas las métricas por ID de clúster, ID de instancia, tipo de nodo y nombre de servicio. De forma predeterminada, el CloudWatch agente no publica las métricas por recurso de las métricas con varios recursos. |
| resources | Opcional | Determina si el agente publicará las métricas por dispositivo. | "\$1" | "\$1" significa todos los dispositivos de almacenamiento, "" significa que no hay dispositivos de almacenamiento o se trata de una lista de nombres de dispositivos separados por comas. Por ejemplo, "nvme0n1,nvme1n1". | El CloudWatch agente solo publica las métricas por dispositivo para las métricas de E/S de disco que no se incluyen. drop\$1original\$1metrics |
------
#### [ mem ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de memoria que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de memoria válidos con o sin el prefijo mem\$1, como mem\$1available y available\$1percent. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publica ninguna métrica de memoria. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas de memoria que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad de metrics\$1collection\$1interval global solo para las métricas de memoria. |
------
#### [ net ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de red que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de red válidos con o sin el prefijonet\$1, como net\$1packets\$1sent y packets\$1recv. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publica ninguna métrica de red. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas de red que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad de metrics\$1collection\$1interval global solo para las métricas de red. |
| drop\$1original\$1metrics | Opcional | Lista de métricas de red para las que no se deben publicar métricas no agregadas. | No se ha publicado ninguna métrica de red no agregada. | Una lista separada por comas de métricas de red que también se especifican en la propiedad de métricas. Una cadena vacía indica que se publican todas las métricas de red. | El CloudWatch agente agrega todas las métricas por ID de clúster, ID de instancia, tipo de nodo y nombre de servicio. De forma predeterminada, el CloudWatch agente no publica las métricas por recurso de las métricas con varios recursos. |
| resources | Opcional | Determina si el agente publicará las métricas por interfaz. | "\$1" | "\$1" se refiere a todas las interfaces de red, "" significa que no hay interfaces de red o se trata de una lista de nombres de interfaces separados por comas. Por ejemplo, "eth0,eth1". | El CloudWatch agente solo publica las métricas por interfaz para las métricas de red que no se incluyen. drop\$1original\$1metrics |
------
#### [ netstat ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de estadísticas de red que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de memoria válidos con o sin el prefijo netstat\$1, como tcp\$1listen y netstat\$1udp\$1socket. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publica ninguna métrica estadística de red. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas estadísticas de red que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad de metrics\$1collection\$1interval global solo para las métricas estadísticas de red. |
------
#### [ processes ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de proceso que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de memoria válidos con o sin el prefijo processes\$1, como processes\$1running y total. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publica ninguna métrica del proceso. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas del proceso del sistema que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad de metrics\$1collection\$1interval global solo para las métricas de los procesos del sistema. |
------
#### [ swap ]
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles | Notas |
| --- | --- | --- | --- | --- | --- |
| metrics | Opcional | La lista de métricas de intercambio que debe recopilar el agente. | Consulte [las métricas predeterminadas CloudWatch del agente con Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/AmazonCloudWatchAgent-metrics.html) | Una lista separada por comas de nombres de métricas de memoria válidos con o sin el prefijo swap\$1, como swap\$1free y used\$1percent. Consulte [las métricas recopiladas por el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/metrics-collected-by-CloudWatch-agent.html#linux-metrics-enabled-by-CloudWatch-agent) para ver las métricas válidas. | Si se especifica una cadena vacía, no se publica ninguna métrica de intercambio. |
| metrics\$1collection\$1interval | Opcional | La frecuencia en segundos acerca de la recopilación y publicación de las métricas de intercambio que debe realizar el agente. | El valor del metrics\$1collection\$1interval global. | Una cadena que especifica el número de segundos. Solo acepta números enteros. | Este valor anula la propiedad de metrics\$1collection\$1interval global solo para las métricas de intercambio. |
------
**emr-hadoop-hdfs-datanode-Propiedades de métricas**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, comoHadoop:service=DataNode,name=DataNodeActivity. Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, BlocksCached,BlocksRead. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan las métricas de Hadoop. DataNode | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
**emr-hadoop-hdfs-namenode-propiedades de métricas**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, comoHadoop:service=NameNode,name=FSNamesystem. Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, BlockCapacity,CapacityUsedGB. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan las métricas de Hadoop. NameNode | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
**emr-hadoop-yarn-nodemanager-propiedades de métricas**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, comoHadoop:service=NodeManager,name=NodeManagerMetrics. Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, MaxCapacity,AllocatedGB. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan las métricas de Hadoop YARN. NodeManager | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
**emr-hadoop-yarn-resourcemanager-propiedades de métricas**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, comoHadoop:service=ResourceManager,name=PartitionQueueMetrics. Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, MaxCapacity,MaxCapacityVCores. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan las métricas de Hadoop YARN. ResourceManager | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
**emr-hbase-master-metrics propiedades**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, como. Hadoop:service=HBase,name=Master,sub=AssignmentManager Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, AssignFailedCount,AssignSubmittedCount. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan HBase las métricas maestras. | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
**emr-hbase-region-server-propiedades de métricas**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, comoHadoop:service=HBase,name=RegionServer,sub=IPC. Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, numActiveHandler,numActivePriorityHandler. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan las métricas de HBase Region Server. | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
**emr-hbase-rest-server-propiedades de métricas**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, comoHadoop:service=HBase,name=REST. Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, successfulPut,successfulScanCount. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan las métricas de HBase Rest Server. | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
**emr-hbase-thrift-server-propiedades de métricas**
| Propiedad | Obligatorio | Description (Descripción) | Predeterminado | Valores posibles |
| --- | --- | --- | --- | --- |
| | Opcional | N/A | La fuente de la MBean que el CloudWatch agente debe recopilar las métricas, comoHadoop:service=HBase,name=Thrift,sub=ThriftOne. Puede encontrar MBean los nombres de los ejemplos y sus métricas correspondientes en los [archivos JMX YAML de ejemplo](https://github.com/aws-samples/aws-emr-utilities/tree/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings) para Amazon EMR versión 7.0. | Una cadena que contiene la lista delimitada por comas de las métricas asociadas a. MBean Por ejemplo, BatchGet\$1max,BatchGet\$1mean. |
| otel.metric.export.interval | Opcional | Con qué frecuencia en milisegundos se recopilan las métricas del servidor HBase Thrift. | “60 000” | Una cadena que especifica el número de milisegundos. Solo acepta números enteros. |
## Ejemplos de configuraciones de métricas del sistema
El siguiente ejemplo muestra cómo configurar el CloudWatch agente para que deje de exportar todas las métricas del sistema.
```
[
{
"Classification": "emr-metrics",
"Properties": {},
"Configurations": [
{
"Classification": "emr-system-metrics",
"Properties": {},
"Configurations": []
}
]
}
]
```
El siguiente ejemplo configura el CloudWatch agente para que exporte las métricas del sistema predeterminadas. Hacerlo es una forma rápida de restablecer el agente para que solo exporte las métricas predeterminadas del sistema si ya ha reconfigurado las métricas del sistema al menos una vez. Este restablecimiento también elimina cualquier métrica de la aplicación que se haya reconfigurado anteriormente.
```
[
{
"Classification": "emr-metrics",
"Properties": {},
"Configurations": []
}
]
```
El siguiente ejemplo configura el clúster para exportar las métricas `cpu`, `mem` y `disk`.
```
[
{
"Classification": "emr-metrics",
"Properties": {},
"Configurations": [
{
"Classification": "emr-system-metrics",
"Properties": {
"metrics_collection_interval": "20"
},
"Configurations": [
{
"Classification": "cpu",
"Properties": {
"metrics": "cpu_usage_guest,cpu_usage_idle",
"metrics_collection_interval": "30",
"drop_original_metrics": "cpu_usage_guest"
}
},
{
"Classification": "mem",
"Properties": {
"metrics": "mem_active"
}
},
{
"Classification": "disk",
"Properties": {
"metrics": "disk_used_percent",
"resources": "/,/mnt",
"drop_original_metrics": ""
}
}
]
}
]
}
]
```
La configuración del ejemplo anterior tiene las propiedades siguientes:
+ Cada 30 segundos, el agente recopila la `cpu_guest` métrica para todos CPUs. Puede encontrar la métrica agregada en el espacio de CloudWatch nombres`CWAgent > cluster.id, instance.id, node.type, service.name`.
+ Cada 30 segundos, el agente recopila la `cpu_idle` métrica para todos. CPUs Puede encontrar la métrica agregada en el espacio de CloudWatch nombres`CWAgent > cluster.id, instance.id, node.type, service.name`. El agente también recopila las métricas por CPU. Puede encontrarlas en el mismo espacio de nombres. El agente recopila esta métrica porque la propiedad `drop_original_metrics` no contiene la `cpu_idle`, por lo que el agente no ignora la métrica.
+ Cada 20 segundos, el agente recopila la métrica `mem_active`. Puedes encontrar la métrica agregada en el espacio de nombres. CloudWatch `CWAgent > cluster.id, instance.id, node.type, service.name`
+ Cada 20 segundos, el agente recopila las métricas `disk_used_percent` de los montajes del disco `/` y `/mnt`. Puedes encontrar las métricas agregadas en el espacio de nombres. CloudWatch `CWAgent > cluster.id, instance.id, node.type, service.name` El agente también recopila las métricas por montaje. Puede encontrarlas en el mismo espacio de nombres. El agente recopila esta métrica porque la propiedad `drop_original_metrics` no contiene la `disk_used_percent`, por lo que el agente no ignora la métrica.
## Ejemplos de configuraciones de métricas de aplicación
El siguiente ejemplo configura el CloudWatch agente para que deje de exportar las métricas del servicio Hadoop Nameode.
```
[
{
"Classification": "emr-metrics",
"Properties": {},
"Configurations": [
{
"Classification": "emr-hadoop-hdfs-namenode-metrics",
"Properties": {},
"Configurations": []
}
]
}
]
```
El siguiente ejemplo configura un clúster para exportar las métricas de las aplicaciones de Hadoop.
```
[
{
"Classification": "emr-metrics",
"Properties": {},
"Configurations": [
{
"Classification": "emr-hadoop-hdfs-namenode-metrics",
"Properties": {
"Hadoop:service=NameNode,name=FSNamesystem": "BlockCapacity,CapacityUsedGB",
"otel.metric.export.interval": "20000"
},
"Configurations": []
},
{
"Classification": "emr-hadoop-hdfs-datanode-metrics",
"Properties": {
"Hadoop:service=DataNode,name=JvmMetrics": "MemNonHeapUsedM",
"otel.metric.export.interval": "30000"
},
"Configurations": []
},
{
"Classification": "emr-hadoop-yarn-resourcemanager-metrics",
"Properties": {
"Hadoop:service=ResourceManager,name=CapacitySchedulerMetrics": "AllocateNumOps,NodeUpdateNumOps"
},
"Configurations": []
}
]
}
]
```
El ejemplo anterior tiene las propiedades siguientes:
+ Cada 20 segundos, el agente recopila las métricas `BlockCapacity` y `CapacityUsedGB` de las instancias que ejecutan el servicio Hadoop Namenode.
+ Cada 30 segundos, el agente recopila las métricas `MemNonHeapUsedM` de las instancias que ejecutan el servicio Hadoop Datanode.
+ Cada 30 segundos, el agente recopila las `NodeUpdateNumOps` métricas `AllocateNumOps` y las métricas de las instancias que ejecutan el Hadoop YARN. ResourceManaager
## Amazon Managed Service para Prometheus
El siguiente ejemplo muestra cómo configurar el CloudWatch agente para exportar métricas a Amazon Managed Service for Prometheus.
Si actualmente exporta métricas a Amazon Managed Service para Prometheus y desea reconfigurar las métricas del clúster y seguir exportándolas a Amazon Managed Service para Prometheus, debe incluir las propiedades `metrics_destination` y `prometheus_endpoint`.
```
[
{
"Classification": "emr-metrics",
"Properties": {
"metrics_destination": "prometheus",
"prometheus_endpoint": "http://amp-workspace/api/v1/remote_write"
},
"Configurations": []
}
]
```
Para usar el CloudWatch agente al que exportar las métricas CloudWatch, usa el siguiente ejemplo.
```
[
{
"Classification": "emr-metrics",
"Properties": {
"metrics_destination": "cloudwatch"
},
"Configurations": []
}
]
```
**nota**
El CloudWatch agente tiene un exportador de Prometheus que cambia el nombre de ciertos atributos. Para las etiquetas de métricas predeterminadas, Amazon Managed Service for Prometheus utiliza caracteres de subrayado en lugar de los puntos que utiliza Amazon. CloudWatch Si utiliza Amazon Managed Grafana para visualizar las métricas predeterminadas en Amazon Managed Service para Prometheus, las etiquetas aparecen como `cluster_id`, `instance_id`, `node_type` y `service_name`.
# Configurar el CloudWatch agente para Amazon EMR 7.0.0
Puede configurar el CloudWatch agente de Amazon para que utilice métricas del sistema adicionales a las que proporciona [la configuración de CloudWatch agente predeterminada](AmazonCloudWatchAgent-metrics.md). La configuración de la versión 7.0.0 requiere el uso de acciones de arranque, de las que se ofrecen ejemplos en las siguientes secciones. En una próxima versión, Amazon EMR ofrecerá opciones de configuración adicionales a través de la API de Amazon EMR.
**Topics**
+ [Configuración de métricas de sistema adicionales con Amazon EMR 7.0.0](#AmazonCloudWatchAgent-config-700-add-metrics)
+ [Configuración de las métricas de las aplicaciones con Amazon EMR 7.0.0](#AmazonCloudWatchAgent-config-700-app-metrics)
+ [Configuración de Amazon Managed Service para Prometheus como almacenamiento en la nube para métricas con Amazon EMR 7.0.0](#AmazonCloudWatchAgent-config-700-prometheus)
## Configuración de métricas de sistema adicionales con Amazon EMR 7.0.0
Realice los siguientes pasos para configurar el agente para que utilice un conjunto diferente de métricas del sistema en Amazon EMR 7.0.0:
1. Cree o elija un bucket en su cuenta de Amazon S3 en el que desee almacenar los archivos de configuración que especifican las métricas del CloudWatch agente.
1. Cree el archivo de configuración del `emr-amazon-cloudwatch-agent.json` con las métricas especificadas que prefiera. Para ello, utilice uno de los métodos explicados en [Crear el archivo de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file.html). Para obtener más información sobre la estructura del archivo de configuración del CloudWatch agente, consulte [Crear o editar manualmente el archivo de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html) en la *Guía del CloudWatch usuario de Amazon*.
1. A continuación, navegue hasta el **aws-emr-utilities** repositorio GitHub y descargue los siguientes scripts de métricas del sistema:
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics_launcher.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics_launcher.sh)**: un script que se descarga y luego ejecuta `install_system_metrics.sh` en segundo plano para que el nodo pueda terminar de arrancar.
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics.sh)**: un script que espera a que la instancia en la que se ejecuta termine de arrancar y, a continuación, descarga y aplica la configuración en el archivo JSON.
1. Abra cada archivo SH y reemplace `amzn-s3-demo-bucket` por el nombre del bucket del paso 1.
1. Cargue el archivo JSON y los dos archivos SH en el bucket de S3.
1. Ahora, puede ir a la consola de Amazon EMR y crear un nuevo clúster con el CloudWatch agente. En el panel de navegación izquierdo, en **EMR en EC2**, seleccione **Clústeres** y, a continuación, **Crear clúster**.
1. En la sección **Nombre y aplicaciones**, elija la versión de Amazon EMR 7.0.0 o posterior.
1. En **Paquete de aplicaciones**, selecciona el paquete o las aplicaciones que deseas instalar en tu clúster e incluye **Amazon CloudWatch Agent** entre tus selecciones.
1. En la sección **Acciones de arranque**, seleccione **Agregar**.
+ En **Nombre**, ingrese **install\$1system\$1metrics\$1launcher.sh**.
+ Para la **Ubicación del script**, ingrese **s3://*amzn-s3-demo-bucket*/install\$1system\$1metrics\$1launcher.sh**. Reemplace `amzn-s3-demo-bucket` por la ruta al bucket de S3.
+ Deje el bloque **Argumentos** vacío.
1. Seleccione **Agregar acción de arranque**.
1. Continúe con la creación del clúster para satisfacer las necesidades de la carga de trabajo.
Cuando se lanza el clúster, el CloudWatch agente publica en él las métricas del sistema que especificó en el archivo de configuración CloudWatch.
## Configuración de las métricas de las aplicaciones con Amazon EMR 7.0.0
Puede configurar el CloudWatch agente de Amazon para que publique métricas de aplicaciones para HDFS y YARN además de las métricas del sistema. Realice los pasos siguientes para configurar el agente para que publique métricas de aplicaciones:
1. Cree o elija un bucket en su cuenta de Amazon S3 en el que desee almacenar los archivos de configuración que especifican las métricas del CloudWatch agente.
1. A continuación, navegue hasta el **aws-emr-utilities** repositorio GitHub y descargue los siguientes scripts:
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics_launcher.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics_launcher.sh)**: un script que se descarga y luego ejecuta `install_app_metrics.sh` en segundo plano para que el nodo pueda terminar de arrancar.
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics.sh)**: un script que espera a que la instancia en la que se ejecuta termine de arrancar y, a continuación, descarga y aplica la configuración en los archivos YAML que se descargarán en el paso siguiente.
1. Abra cada archivo y reemplace `amzn-s3-demo-bucket` por el nombre del bucket del paso 1.
1. A continuación, descargue los siguientes archivos de mapeo YAML. Para obtener información sobre cómo están estructurados estos archivos YAML, consulta [https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/jmx-metrics/javaagent](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/jmx-metrics/javaagent)en el *OpenTelemetry Instrumentation for Java* GitHub repositorio.
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/datanode-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/datanode-metrics.yaml)**: la configuración de las métricas de Hadoop DataNode.
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/namenode-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/namenode-metrics.yaml)**: la configuración de las métricas de Hadoop NameNode.
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/nodemanager-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/nodemanager-metrics.yaml)**: la configuración de las métricas de Yarn NodeManager.
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/resourcemanager-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/resourcemanager-metrics.yaml)**: la configuración de las métricas de Yarn ResourceManager.
1. Cargue los dos archivos SH y los cuatro archivos YAML en el bucket de S3.
1. Ahora, puede ir a la consola de Amazon EMR y crear un nuevo clúster con el CloudWatch agente. En el panel de navegación izquierdo, en **EMR en EC2**, seleccione **Clústeres** y, a continuación, **Crear clúster**.
1. En la sección **Nombre y aplicaciones**, elija la versión de Amazon EMR 7.0.0 o posterior.
1. En **Paquete de aplicaciones**, seleccione el paquete o el grupo personalizado de aplicaciones que desee instalar en su clúster e incluya el **CloudWatch agente** en sus selecciones.
1. En la sección **Acciones de arranque**, seleccione **Agregar**.
+ En **Nombre**, ingrese **install\$1app\$1metrics\$1launcher.sh**.
+ Para la **Ubicación del script**, ingrese **s3://*amzn-s3-demo-bucket*/install\$1app\$1metrics\$1launcher.sh**. Reemplace `amzn-s3-demo-bucket` por la ruta al bucket de S3.
+ Deje el bloque **Argumentos** vacío.
1. Seleccione **Agregar acción de arranque**.
1. Continúe con la creación del clúster para satisfacer las necesidades de la carga de trabajo.
Cuando se lanza el clúster, el CloudWatch agente publica las métricas de la aplicación que especificó junto con las métricas del sistema CloudWatch.
## Configuración de Amazon Managed Service para Prometheus como almacenamiento en la nube para métricas con Amazon EMR 7.0.0
Puede configurar el CloudWatch agente de Amazon para que publique las métricas en Amazon Managed Service for Prometheus en lugar de hacerlo. CloudWatch
**nota**
Puedes publicar las métricas del CloudWatch agente de Amazon en Amazon Managed Service for Prometheus o en CloudWatch Amazon, pero no puedes publicar las métricas en ambos servicios para el mismo clúster.
Para configurar el agente para que publique métricas en Amazon Managed Service for Prometheus, debe añadir el permiso (IAM) `aps:RemoteWrite` AWS Identity and Access Management al perfil de instancia de Amazon EC2 para Amazon EMR. El siguiente ejemplo de política contiene los permisos necesarios:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aps:RemoteWrite"
],
"Resource": [
"*"
],
"Sid": "AllowAPSRemotewrite"
}
]
}
```
------
**Usa el CloudWatch agente de un clúster de EMR para publicar métricas en Amazon Managed Service for Prometheus**
Una vez que la política de servicio tenga los permisos correctos, siga los siguientes pasos para lanzar un clúster que utilice el CloudWatch agente para publicar las métricas en Amazon Managed Service for Prometheus.
1. Utilice Consola de administración de AWS o AWS CLI para crear un espacio de trabajo de Amazon Managed Service para Prometheus. Para obtener más información, consulte [Crear un espacio de trabajo](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-onboard-create-workspace.html) en la *Guía del usuario de Amazon Managed Service para Prometheus*.
1. Cree o elija un bucket en la cuenta de Amazon S3 en la que desea almacenar los archivos de lanzamiento que especifican Amazon Managed Service para Prometheus como almacenamiento en la nube.
1. A continuación, navegue hasta el **aws-emr-utilities** repositorio GitHub y descargue los siguientes scripts:
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint_launcher.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint_launcher.sh)**: un script que se descarga y luego ejecuta `add_prometheus_endpoint.sh` en segundo plano para que el nodo pueda terminar de arrancar.
+ **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint.sh)**— Un script que espera a que la instancia en la que se ejecuta termine de arrancarse y, a continuación, configura el CloudWatch agente para que lo publique en el punto final de Amazon Managed Service for Prometheus que usted proporciona como argumento al lanzar el clúster.
1. Abra cada archivo y reemplace `amzn-s3-demo-bucket` por el nombre del bucket del paso 2.
1. Utilice AWS CLI para crear un clúster de EMR con la acción `add_prometheus_endpoint_launcher.sh` bootstrap. En el siguiente comando, reemplace `amzn-s3-demo-bucket` por el bucket que contiene la acción de arranque y reemplace `managedpro-remote-write-workspace-url` por el punto de conexión de escritura remoto del espacio de trabajo de Amazon Managed Service para Prometheus. Asegúrese de especificar una etiqueta de versión de Amazon EMR igual a `emr-7.0.0` o posterior.
```
aws emr create-cluster --name managedpro-cluster \
--release-label emr-7.0.0 \
--applications Name=Hadoop Name=AmazonCloudWatchAgent \
--ec2-attributes KeyName=myKey --instance-type m7g.2xlarge \
--instance-count 3 --use-default-roles
--bootstrap-actions Name='Add Prometheus Endpoint',Path=s3://amzn-s3-demo-bucket/add_prometheus_endpoint_launcher.sh,Args='managedpro-remote-write-workspace-url'
```
Cuando se lanza el clúster, el CloudWatch agente publica las métricas que recopila en Amazon Managed Service for Prometheus.
**Uso de Amazon Managed Service para Prometheus como origen de datos para Amazon Managed Grafana**
Una vez que Amazon EMR haya publicado las métricas del clúster en Amazon Managed Service para Prometheus, puede realizar los siguientes pasos para visualizar las métricas con Amazon Managed Grafana:
1. Úsala Consola de administración de AWS para crear un espacio de trabajo y un usuario de Grafana gestionados por Amazon con los permisos adecuados. Para obtener más información, consulte [Crear un espacio de trabajo](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-create-workspace.html) en la *Guía del usuario de Amazon Managed Grafana*.
1. Agregue Amazon Managed Service para Prometheus como origen de datos para Amazon Managed Grafana. Para obtener más información, consulte [Uso de la configuración de la fuente de datos AWS para agregar Amazon Managed Service para Prometheus como origen de datos](https://docs.aws.amazon.com/grafana/latest/userguide/AMP-adding-AWS-config.html) en la *Guía del usuario de Amazon Managed Grafana*.
**nota**
El CloudWatch agente tiene un exportador de Prometheus que cambia el nombre de ciertos atributos. Para las etiquetas de métricas predeterminadas, Amazon Managed Service for Prometheus utiliza caracteres de subrayado en lugar de los puntos que utiliza Amazon. CloudWatch Por lo tanto, si utiliza Amazon Managed Grafana para visualizar las métricas predeterminadas en Amazon Managed Service para Prometheus, las etiquetas aparecen como `jobflow_id`, `instance_id` y `service_name`.
Además, cualquier métrica de la **aplicación** que el CloudWatch agente publique en Amazon Managed Service for Prometheus utiliza la `job` etiqueta en su lugar. `service_name` Sin embargo, las métricas del **sistema** siguen utilizando la etiqueta `service_name`.
# Consideraciones y limitaciones
+ El CloudWatch agente nativo de Amazon está disponible para los clústeres que cree con las versiones 7.0.0 y posteriores de Amazon EMR.
+ [La configuración del CloudWatch agente en Amazon EMR 7.0.0 requiere el uso de acciones de arranque.](AmazonCloudWatchAgent-config-700.md) En una próxima versión, Amazon EMR ofrecerá opciones de configuración adicionales a través de la API de Amazon EMR.
+ No puede instalar el CloudWatch agente de Amazon EMR si ya lo ha implementado mediante otro método, como CloudWatch Agent (SSM AWS Systems Manager Agent), en la región en la que creó el clúster. Si lo hace, el clúster se cerrará con errores.
+ La CloudWatch GetMetricData API admite hasta 500 métricas por solicitud. **Si su clúster de Amazon EMR contiene más de 250 nodos en un grupo de instancias o una flota, los gráficos correspondientes del panel CloudWatch integrado en EMR aparecerán en blanco con el error **Demasiadas métricas, ya que estas métricas** requieren dos puntos de datos por métrica en el panel de información general del clúster.** Sin embargo, si filtra los paneles **Grupo de instancias principales** o **Grupo de instancias de tareas** (o sus flotas), podrá visualizar los gráficos de hasta 500 nodos por grupo o flota, ya que esas métricas no requieren dos puntos de datos. Si supera los 500 nodos por grupo o flota, también aparecerá el error de **Demasiadas métricas**.
# CloudWatch historial de versiones de los agentes
En la siguiente tabla se muestra la versión AmazonCloudWatchAgent incluida en cada versión de Amazon EMR, junto con los componentes instalados con la aplicación. Para ver las versiones de los componentes de cada versión, consulte la sección Versiones de los componentes en la versión correspondiente de [Versiones de Amazon EMR 7.x](emr-release-7x.md), [Versiones de lanzamiento de Amazon EMR 6.x](emr-release-6x.md) o [Versiones de lanzamiento de Amazon EMR 5.x](emr-release-5x.md).
**AmazonCloudWatchAgent información sobre la versión**
| Etiqueta de versión de Amazon EMR | AmazonCloudWatchAgent Versión | Componentes instalados con AmazonCloudWatchAgent |
| --- | --- | --- |
| emr-7.12.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-hdfs-zkfc, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.11.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-hdfs-zkfc, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.10.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.9.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.8.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.7.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.6.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.5.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.4.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.3.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.2.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.1.0 | 1.300032.2-amzn-0 | adot-java-agent, emrfs, emr-amazon-cloudwatch-agent, emr-ddb, emr-goodies, emr-kinesis, emr-s3-dist-cp, hadoop-client, hadoop-hdfs-datanode, hadoop-hdfs-library, hadoop-hdfs-namenode, hadoop-httpfs-server, hadoop-kms-server, hadoop-mapred, hadoop-yarn-nodemanager, hadoop-yarn-resourcemanager, hadoop-yarn-timeline-server |
| emr-7.0.0 | 1.300031.1-amzn-0 | adot-java-agent, emr-amazon-cloudwatch-agent |