# Etiquetado de los recursos de Amazon ECS Como ayuda para administrar los recursos de Amazon ECS, puede asignar sus propios metadatos a cada recurso mediante *etiquetas*. Cada *etiqueta* consta de una *clave* y un *valor* opcional. Puede utilizar etiquetas para clasificar los recursos de Amazon ECS de diversas maneras, por ejemplo, según su finalidad, propietario o entorno. Esto es útil cuando se tienen muchos recursos del mismo tipo. Puede identificar rápidamente un recurso específico según las etiquetas que le haya asignado. Por ejemplo, podría definir un conjunto de etiquetas para las instancias de contenedor de Amazon ECS de su cuenta. Esto le permite realizar un seguimiento del propietario y el nivel de la pila de cada instancia. Puede utilizar etiquetas para sus informes de costo y uso. Puede utilizar estos informes para analizar el costo y el uso de los recursos de Amazon ECS. Para obtener más información, consulte [Informes de uso de Amazon ECS](usage-reports.md). **aviso** Hay muchas API que devuelven las claves de las etiquetas y sus valores. Denegar el acceso a `DescribeTags` no deniega automáticamente el acceso a etiquetas devueltas por otras API. Como práctica recomendada, no debe incluir datos confidenciales en las etiquetas. Recomendamos que idee un conjunto de claves de etiqueta que cumpla sus necesidades para cada tipo de recurso. Puede utilizar un conjunto coherente de claves de etiquetas para administrar los recursos más fácilmente. Puede buscar y filtrar los recursos en función de las etiquetas que agregue. Las etiquetas no tienen ningún significado semántico para Amazon ECS, por lo que se interpretan estrictamente como cadenas de caracteres. Puede editar las claves y los valores de las etiquetas y también puede eliminar etiquetas de un recurso en cualquier momento. Puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Si agrega una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al anterior. Cuando elimina un recurso, también se eliminarán las etiquetas asignadas a dicho recurso. Si utiliza AWS Identity and Access Management (IAM), puede controlar qué usuarios de su cuenta de AWS tienen permiso para administrar etiquetas. ## Cómo se etiquetan los recursos Hay varias formas de etiquetar las tareas, los servicios, las definiciones de tareas y los clústeres de Amazon ECS: + El usuario etiqueta manualmente un recurso con la Consola de administración de AWS, la API de Amazon ECS, la AWS CLI o un AWS SDK. + El usuario crea un servicio o ejecuta una tarea independiente y selecciona la opción de etiquetas administradas por Amazon ECS. Amazon ECS etiqueta automáticamente todas las tareas recién lanzadas. Para obtener más información, consulte [Etiquetas administradas por Amazon ECS](#managed-tags). + El usuario crea un recurso con la consola. La consola etiqueta automáticamente los recursos. Estas etiquetas se devuelven en la AWS CLI y las respuestas del SDK de AWS se muestran en la consola. No se pueden modificar ni eliminar. Para obtener información sobre las etiquetas agregadas, consulte la columna **Etiquetas agregadas automáticamente por la consola** en la tabla **Compatibilidad de etiquetado para los recursos de Amazon ECS**. Si especifica etiquetas al crear un recurso y las etiquetas no se pueden aplicar, Amazon ECS revierte el proceso de creación. Esto garantiza que los recursos se creen con etiquetas o, de lo contrario, no se creen y que ningún recurso se quede jamás sin etiquetar. Al etiquetar los recursos en el momento de su creación, ya no es necesario ejecutar scripts de etiquetado personalizados después de la creación del recurso. En la siguiente tabla se describen los recursos de Amazon ECS que admiten etiquetas. | Recurso | Admite etiquetas | Admite la propagación de etiquetas | Etiquetas agregadas automáticamente por la consola | | --- | --- | --- | --- | | Tareas de Amazon ECS | Sí | Sí, desde la definición de tarea. | Clave: aws:ecs:clusterName *Valor*: `cluster-name` | | Servicios de Amazon ECS | Sí | Sí, ya sea desde la definición de tareas o el servicio a las tareas del servicio. | Clave: ecs:service:stackId *Valor*: `arn:aws:cloudformation:arn` | | Conjuntos de tareas de Amazon ECS | Sí | No | N/A | | Definiciones de tareas de Amazon ECS | Sí | No | Clave: ecs:taskDefinition:createdFrom *Valor*: `ecs-console-v2` | | Clústeres de Amazon ECS | Sí | No | Clave: aws:cloudformation:logical-id *Valor*: `ECSCluster` Clave: aws:cloudformation:stack-id*Valor*: `arn:aws:cloudformation:arn`*Clave*: `aws:cloudformation:stack-name`*Valor*: `ECS-Console-V2-Cluster-EXAMPLE` | | Instancias de contenedor de Amazon ECS | Sí | Sí, desde la instancia de Amazon EC2. Para obtener más información, consulte [Adición de etiquetas a una instancia de contenedor de Amazon EC2 para Amazon ECS](instance-details-tags.md). | N/A | | Instancias externas de Amazon ECS | Sí | No | N/A | | Proveedor de capacidad de Amazon ECS | Sí. No se pueden etiquetar los proveedores de capacidad predefinidos `FARGATE` ni `FARGATE_SPOT`. | Sí, solo de proveedores de capacidad para instancias administradas de Amazon ECS. Puede propagar etiquetas desde el proveedor de capacidad para instancias administradas de Amazon ECS a todos los recursos administrados por el proveedor, como las instancias de Amazon EC2, la plantilla de lanzamiento, las interfaces de red elásticas y los volúmenes. | N/A | ## Etiquetado de recursos durante la creación Los recursos siguientes admiten el etiquetado en el momento de la creación mediante la API de Amazon ECS, la AWS CLI o el AWS SDK: + Tareas de Amazon ECS + Servicios de Amazon ECS + Definición de tarea de Amazon ECS + Conjuntos de tareas de Amazon ECS + Clústeres de Amazon ECS + Instancias de contenedor de Amazon ECS + Proveedores de capacidad de Amazon ECS Amazon ECS tiene la opción de utilizar la autorización de etiquetado para la creación de recursos. Cuando la Cuenta de AWS se configura para autorizar el etiquetado, los usuarios deben tener permisos para llevar a cabo las acciones que crean el recurso, como `ecsCreateCluster`. Si indica las etiquetas en la acción de creación de recursos, AWS hace otra autorización para verificar que los usuarios o roles tengan permisos para crear etiquetas. Por lo tanto, usted debe conceder permisos explícitos para utilizar la acción `ecs:TagResource`. Para obtener más información, consulte [Conceder permisos para etiquetar recursos durante la creación](supported-iam-actions-tagging.md). Para obtener información acerca de cómo configurar la opción, consulte [Autorización de etiquetado](ecs-account-settings.md#tag-resources-setting). ## Restricciones Se aplican las siguientes restricciones a las etiquetas: + Se puede asociar un máximo de 50 etiquetas a un recurso. + Las claves de etiquetas no se pueden repetir para un recurso. Cada clave de etiqueta debe ser única y solo puede tener un valor. + Las claves pueden tener hasta 128 caracteres en UTF-8. + Los valores pueden tener hasta 256 caracteres en UTF-8. + Si hay múltiples Servicios de AWS y los recursos usan su esquema de etiquetado, limite los tipos de caracteres que usa. Algunos servicios pueden tener restricciones en cuanto a los caracteres permitidos. En general, los caracteres permitidos son letras, números, espacios y los siguientes caracteres: `+` `-` `=` `.` `_` `:` `/` `@`. + Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. + No puede utilizar `aws:`, `AWS:`, ni ninguna combinación de mayúsculas o minúsculas de dichas letras como prefijo para claves ni valores. Estos están reservados solo para la utilización de AWS. Las claves y valores de etiquetas que tienen este prefijo no se pueden editar. Las etiquetas con este prefijo no cuentan para el límite de etiquetas por recurso. ## Etiquetas administradas por Amazon ECS Cuando se utilizan las etiquetas administradas por Amazon ECS, dicho servicio etiqueta automáticamente todas las tareas que se acaban de lanzar y los volúmenes de Amazon EBS adjuntos a las tareas con la información del clúster y las etiquetas de definición de tareas agregadas por el usuario o las etiquetas de servicio. A continuación, se describen las etiquetas agregadas: + Tareas independientes: una etiqueta con una *clave* como `aws:ecs:clusterName` y un *valor* establecidos en el nombre del clúster. Todas las etiquetas de definición de tareas que agregaron los usuarios. Un volumen de Amazon EBS adjunto a una tarea independiente recibirá la etiqueta con una *clave* como `aws:ecs:clusterName` y un *valor* establecidos en el nombre del clúster. Para obtener más información sobre el etiquetado de volúmenes de Amazon EBS, consulte [Tagging Amazon EBS volumes](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging). + Tareas que forman parte de un servicio: una etiqueta con una *clave* como `aws:ecs:clusterName` y un *valor* establecidos en el nombre del clúster. Una etiqueta con una *clave* como `aws:ecs:serviceName` y un *valor* establecidos en el nombre del servicio. Etiquetas de alguno de los recursos siguientes: + Definiciones de tareas: todas las etiquetas de definiciones de tareas que agregaron los usuarios. + Servicios: todas las etiquetas de servicios que agregaron los usuarios. Un volumen de Amazon EBS asociado a una tarea que forma parte de un servicio recibirá una etiqueta con una *clave* como `aws:ecs:clusterName` y un *valor* establecidos en el nombre del clúster, y una etiqueta con una *clave* como `aws:ecs:serviceName` y un *valor* establecidos en el nombre del servicio. Para obtener más información sobre el etiquetado de volúmenes de Amazon EBS, consulte [Tagging Amazon EBS volumes](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging). Se requieren las siguientes opciones para esta función: + Debe optar incluir los nuevos formatos de nombre de recurso de Amazon (ARN) e identificador (ID) de recursos. Para obtener más información, consulte [Nombres de recursos de Amazon (ARN) e ID](ecs-account-settings.md#ecs-resource-ids). + Cuando usa las API para crear un servicio o ejecutar una tarea, debe configurar `enableECSManagedTags` a `true` para `run-task` y `create-service`. Para obtener más información, consulte [create-service](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) y [run-task](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) en la *Referencia de la API AWS Command Line Interface*. + Amazon ECS utiliza etiquetas administradas para determinar cuándo están habilitadas algunas características, por ejemplo, el escalado automático de clústeres. Recomendamos no modificar las etiquetas manualmente para que Amazon ECS pueda administrar las características de forma eficaz. ## Uso de etiquetas para facturación AWS proporciona una herramienta de elaboración de informes llamada Cost Explorer, que puede utilizar para analizar el coste y la utilización de los recursos de Amazon ECS. Puede utilizar Cost Explorer para ver gráficos sobre el uso y los costes. Puede ver los datos de los últimos 13 meses y predecir la cantidad que probablemente va a gastar durante los tres meses siguientes. Cost Explorer se puede utilizar para observar patrones de lo que se gasta en recursos de AWS a lo largo del tiempo. Por ejemplo, se puede utilizar para identificar aspectos que deben estudiarse más a fondo y observar tendencias que pueden ayudar a comprender los costos. También puede especificar intervalos de tiempo para los datos y ver los datos temporales por día o por mes. Puede utilizar etiquetas administradas por Amazon ECS o agregadas por el usuario para su informe de costo y uso. Para obtener más información, consulte [Informes de uso de Amazon ECS](usage-reports.md). Para ver el costo de los recursos combinados, puede organizar la información de facturación basada en los recursos que tienen los mismos valores de clave de etiqueta. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación específico y luego organizar su información de facturación para ver los costos totales de la aplicación en distintos servicios. Para obtener más información acerca de la configuración de un informe de asignación de costos con etiquetas, consulte [Informe de asignación de costos mensual](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) en la *Guía del usuario de AWS Billing*. Además, puede activar los *Datos de asignación de costos divididos* para incluir datos de uso de CPU y memoria a nivel de tarea en sus informes de costos y uso. Para obtener más información, consulte [Informes sobre costo y uso de nivel de tarea](usage-reports.md#task-cur). **nota** Si ha habilitado los informes, puede que los datos correspondientes al mes actual demoren hasta 24 horas en estar disponibles para su visualización. # Adición de etiquetas a los recursos de Amazon ECS Puede etiquetar tareas, servicios, definiciones de tareas y clústeres nuevos o existentes. Para obtener más información sobre el etiquetado de instancias de contenedor, consulte [Adición de etiquetas a una instancia de contenedor de Amazon EC2 para Amazon ECS](instance-details-tags.md). **aviso** No agregue información de identificación personal (PII) ni otra información confidencial en las etiquetas. Las etiquetas son accesibles para muchos servicios de AWS, incluida la facturación. Las etiquetas no se han diseñado para usarse con información privada o confidencial. Puede utilizar los siguientes recursos para especificar etiquetas al crear el recurso. | Tarea | Consola | AWS CLI | Acción API | | --- | --- | --- | --- | | Ejecute una o varias tareas. | [Ejecución de una aplicación como tarea de Amazon ECS](standalone-task-create.md) | [run-task](https://docs.aws.amazon.com/cli/latest/reference/ecs/run-task.html) | [RunTask](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) | | Cree un servicio. | [Creación de una implementación de actualización continua de Amazon ECS](create-service-console-v2.md) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-service.html) | [CreateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) | | Cree un conjunto de tareas. | [Implementación de los servicios de Amazon ECS mediante un controlador de terceros](deployment-type-external.md) | [create-task-set](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-task-set.html) | [CreateTaskSet](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html) | | Registre una definición de tareas. | [Creación de una definición de tareas de Amazon ECS mediante la consola](create-task-definition.md) | [register-task-definition](https://docs.aws.amazon.com/cli/latest/reference/ecs/register-task-definition.html) | [RegisterTaskDefinition](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RegisterTaskDefinition.html) | | Cree un clúster. | [Creación de un clúster de Amazon ECS para cargas de trabajo de Fargate](create-cluster-console-v2.md) | [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-cluster.html) | [CreateCluster](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html) | | Ejecute una o más instancias de contenedor. | [Lanzamiento de una instancia de contenedor de Linux de Amazon ECS](launch_container_instance.md) | [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) | [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) | | Cree un proveedor de capacidad para instancias administradas de Amazon ECS. | [Creación de un proveedor de capacidad de instancias administradas de Amazon ECS](create-capacity-provider-managed-instances.md) | [create-capacity-provider](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-capacity-provider.html) | [CreateCapacityProvider](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html) | ## Adición de etiquetas a los recursos existentes (consola de Amazon ECS) Puede agregar o eliminar las etiquetas asociadas a los clústeres, servicios, tareas y definiciones de tareas directamente desde la página del recurso. **Para modificar una etiqueta de un recurso individual** 1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2). 1. En la barra de navegación, elija la Región de AWS a utilizar. 1. En el panel de navegación, seleccione un tipo de recurso (por ejemplo, **Clusters [Clústeres]**). 1. Seleccione el recurso de la lista de recursos, elija la pestaña **Tags** (Etiquetas) y, luego, elija **Manage tags** (Administrar etiquetas). 1. Configure sus etiquetas. [Agregar una etiqueta] Seleccione **Add tag** (Agregar etiqueta), y, a continuación, haga lo siguiente: + En **Clave**, escriba el nombre de la clave. + En **Valor**, escriba el valor de la clave. 1. Seleccione **Save**. ## Adición de etiquetas a los recursos existentes (AWS CLI) Puede agregar o sobrescribir una o varias etiquetas mediante la AWS CLI o una API. **nota** Puede utilizar puntos de conexión de servicio de doble pila para interactuar con Amazon ECS desde la AWS CLI, los SDK y la API de Amazon ECS a través de IPv4 e IPv6. Para obtener más información, consulte [Uso de puntos de conexión de doble pila en Amazon ECS](dual-stack-endpoint.md). + AWS CLI - [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/ecs/tag-resource.html) + Acción de API: [TagResource](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html) # Etiquetas para instancias administradas de Amazon ECS Instancias administradas de Amazon ECS admite una combinación de etiquetas personalizadas y etiquetas agregadas por AWS que se pueden utilizar para optimizar los costos. Para obtener más información acerca del uso de etiquetas para la facturación, consulte [Uso de etiquetas para facturación](ecs-using-tags.md#tag-resources-for-billing). ## Etiquetas agregadas por AWS AWS agrega las siguientes etiquetas a cada instancia administrada de Amazon ECS creada por el proveedor de capacidad: + Amazon ECS agrega automáticamente las etiquetas reservadas `AmazonECSCreated` y `AmazonECSManaged` a instancias administradas de Amazon ECS. + Amazon ECS agrega las siguientes etiquetas de sistema a cada instancia: + Una etiqueta con una *clave* como `aws:ecs:clusterName` y un *valor* establecidos en el nombre del clúster. + Una etiqueta con una *clave* como `aws:ecs:capacityProviderName` y un *valor* establecidos en el nombre del proveedor de capacidad. + Una etiqueta con una *clave* como `aws:ecs:containerInstanceId` y un *valor* como ID de instancia de contenedor para la instancia administrada de Amazon ECS. + Amazon EC2 agrega la etiqueta del sistema `aws:ec2:managed-launch` con el valor `ecs-managed-instances`. Además, Amazon EC2 agrega etiquetas de sistema que indican la plantilla de lanzamiento que se utilizó para crear la instancia administrada y la flota de Amazon EC2 de la que forma parte la instancia administrada. ## Etiquetas personalizadas Para agregar etiquetas personalizadas adicionales a instancias administradas de Amazon ECS, agregue etiquetas al proveedor de capacidad y habilite la propagación de etiquetas mediante la propiedad `propagateTags`. Las etiquetas del proveedor de capacidad se propagan a las instancias administradas que lanza el proveedor de capacidad. El siguiente ejemplo de definición de proveedor de capacidad muestra cómo se pueden especificar y propagar las etiquetas desde el proveedor de capacidad al crear el proveedor de capacidad utilizando el valor `CAPACITY_PROVIDER` para `propagateTags`. ``` { "name": "my-cluster-managed-instances-cp", "cluster": "my-cluster", "tags": [ { "key":"tag_key", "value":"tag_value" } ], "managedInstancesProvider": { "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole", "propagateTags": "CAPACITY_PROVIDER", "instanceLaunchTemplate": { "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile", "networkConfiguration": { "subnets": [ "subnet-abcdef01234567", "subnet-bcdefa98765432" ], "securityGroups": [ "sg-0123456789abcdef" ] } } } } ``` **nota** Al agregar etiquetas nuevas a un proveedor de capacidad, las etiquetas recién agregadas no se propagarán a las instancias existentes, sino que se propagarán a las instancias recién creadas. Los clientes pueden agregar etiquetas de forma directa a las instancias de EC2, pero esas etiquetas no se propagan de nuevo al proveedor de capacidad También puede etiquetar o quitar la etiqueta del proveedor de capacidad mediante [Adición de etiquetas a los recursos existentes (AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) o [Adición de etiquetas a los recursos existentes (consola de Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags) Para obtener más información sobre los proveedores de capacidad de instancias administradas de Amazon ECS, consulte [Proveedores de capacidad de instancias administradas de Amazon ECS](managed-instances-capacity-providers-concept.md). # Adición de etiquetas a una instancia de contenedor de Amazon EC2 para Amazon ECS Para asociar etiquetas con las instancias de contenedor de Amazon EC2 para Amazon ECS, utilice uno de los siguientes métodos: + Método 1: al crear su instancia de contenedor desde la API de Amazon EC2, la CLI o la consola, especifique las etiquetas pasando los datos del usuario a la instancia mediante el parámetro de configuración del agente de contenedor `ECS_CONTAINER_INSTANCE_TAGS`. Esto crea etiquetas que están asociadas solo a la instancia de contenedor de Amazon ECS, y no pueden enumerar mediante la API de Amazon EC2. Para obtener más información, consulte [Arranque de instancias de contenedor de Linux de Amazon ECS para la transferencia de datos](bootstrap_container_instance.md). **importante** Si inicia las instancias de contenedor mediante un grupo de Amazon EC2 Auto Scaling, debe utilizar el parámetro de configuración del agente ECS\$1CONTAINER\$1INSTANCE\$1TAGS para agregar etiquetas. Esto se debe a la forma en que se agregan las etiquetas a las instancias de Amazon EC2 que se lanzan mediante grupos de Auto Scaling. A continuación, se muestra un ejemplo de un script de datos de usuario que asocia etiquetas con su instancia de contenedor: ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=MyCluster ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"} EOF ``` + Método 2: al crear su instancia de contenedor desde la API de Amazon EC2, la CLI o la consola, especifique primero las etiquetas mediante el parámetro `TagSpecification.N`. A continuación, transfiera los datos de usuario a la instancia mediante el parámetro de configuración del agente de contenedor `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM`. Al hacerlo, se propaga desde Amazon EC2 a Amazon ECS. A continuación, se muestra un ejemplo de un script de datos de usuario que propaga las etiquetas que están asociadas a una instancia de Amazon EC2, además de registrar la instancia en un clúster con el nombre `MyCluster`. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=MyCluster ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance EOF ``` Para proporcionar acceso y permitir que las etiquetas de instancia de contenedor se propaguen de Amazon EC2 a Amazon ECS, agregue manualmente los siguientes permisos como una política insertada al rol de IAM de instancia de contenedor de Amazon ECS. Para obtener más información, consulte [Adición y eliminación de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html). + `ec2:DescribeTags` A continuación, se presenta una política de ejemplo mediante la cual se agregan estos permisos. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:DescribeTags" ], "Resource": "*" } ] } ``` ------ # Adición de etiquetas a instancias de contenedor externas de Amazon ECS Para asociar etiquetas a las instancias de contenedor externas para Amazon ECS, puede utilizar uno de los siguientes métodos. + Método 1: antes de ejecutar el script de instalación para registrar la instancia externa en el clúster, cree o edite el archivo de configuración del agente contenedor de Amazon ECS en `/etc/ecs/ecs.config` y agregue el parámetro de configuración del agente de contenedor `ECS_CONTAINER_INSTANCE_TAGS`. De esto modo, se crean etiquetas que están asociadas a la instancia externa. A continuación, se muestra un ejemplo sintaxis . ``` ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"} ``` + Método 2: una vez que la instancia externa se registra en el clúster, puede usar Consola de administración de AWS para agregar etiquetas. Para obtener más información, consulte [Adición de etiquetas a los recursos existentes (consola de Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags). # Informes de uso de Amazon ECS AWS proporciona una herramienta de elaboración de informes llamada Cost Explorer, que puede utilizar para analizar el coste y la utilización de los recursos de Amazon ECS. Puede utilizar Cost Explorer para ver gráficos sobre el uso y los costes. Puede ver los datos de los últimos 13 meses y predecir la cantidad que probablemente va a gastar durante los tres meses siguientes. Cost Explorer se puede utilizar para observar patrones de lo que se gasta en recursos de AWS a lo largo del tiempo. Por ejemplo, se puede utilizar para identificar aspectos que deben estudiarse más a fondo y observar tendencias que pueden ayudar a comprender los costos. También puede especificar intervalos de tiempo para los datos y ver los datos temporales por día o por mes. Los datos de medición del informe de uso y costos muestran el uso en todas las tareas de Amazon ECS. Los datos de medición incluyen el uso de CPU como `vCPU-Hours` y el uso de memoria como `GB-Hours` de cada tarea que se ejecutó. La forma de presentación de los datos depende de la opción de computación de la tarea. Para las tareas que utilizan Fargate, la columna `lineItem/Operation` muestra `FargateTask`, y verá el costo asociado a cada tarea. Para las tareas que utilizan EC2, la columna `lineItem/Operation` muestra `ECSTask-EC2`, y las tareas no tendrán un costo directo asociado a ellas. Los datos de medición que se muestran en el informe, como la utilización de memoria, representan el total de recursos que reservó la tarea durante el período de facturación indicado. Puede utilizar estos datos para determinar el coste del clúster subyacente de instancias de Amazon EC2. Los datos de costo y uso de las instancias de Amazon EC2 se mostrarán por separado en el servicio de Amazon EC2. También puede usar las etiquetas administradas por Amazon ECS para identificar el servicio o el clúster al que pertenece cada tarea. Para obtener más información, consulte [Uso de etiquetas para facturación](ecs-using-tags.md#tag-resources-for-billing). **importante** Solo se pueden ver datos de medición de tareas lanzadas a partir del 16 de noviembre de 2018. Las tareas lanzadas antes de esta fecha no muestran datos de medición. A continuación, se muestra un ejemplo con algunos de los campos que puede utilizar para ordenar los datos de asignación de costes mediante el Explorador de costes. + Nombre de clúster + Nombre del servicio + Etiquetas de recursos + Tipo de lanzamiento + Región de AWS + Tipo de uso Para obtener más información acerca de cómo crear un Informe de uso y costos de AWS, consulte [Informe de uso y costos de AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html) en la *Guía del usuario de AWS Billing*. ## Informes sobre costo y uso de nivel de tarea AWS Cost Management puede proporcionar datos de uso de CPU y memoria en AWS Cost and Usage Report para cada tarea de Amazon ECS, incluidas las tareas de Fargate y las de EC2. Estos datos se denominan *datos de asignación de costos divididos*. Puede utilizar estos datos para analizar los costos y el uso de las aplicaciones. Además, puede dividir y asignar los costos a unidades de negocio y equipos individuales con etiquetas de asignación de costos y categorías de costos. Para obtener más información acerca de los *datos de asignación de costos divididos*, consulte [Understanding split cost allocation data](https://docs.aws.amazon.com/cur/latest/userguide/split-cost-allocation-data.html) en la Guía del usuario de AWS Cost and Usage Report. Puede activar los *datos de asignación de costos divididos* de nivel de tarea para la cuenta en la AWS Cost Management Console. Si tiene una cuenta de administración (pagadora), puede optar por aplicar esta configuración desde la cuenta de pagador a todas las cuentas vinculadas. Tras configurar los *datos de asignación de costos divididos*, habrá columnas adicionales bajo el encabezado **SplitLineItem** del informe. Para obtener más información, consulte [Split line item details](https://docs.aws.amazon.com/cur/latest/userguide/split-line-item-columns.html) en la Guía del usuario de AWS Cost and Usage Report En el caso de las tareas de EC2, estos datos dividen el costo de la instancia de EC2 en función del uso o las reservas de los recursos y de los recursos restantes de la instancia. A continuación, se muestran los requisitos previos: + Establezca el parámetro de configuración de agente `ECS_DISABLE_METRICS` de Amazon ECS en `false`. Cuando esta configuración es `false`, el agente de Amazon ECS envía métricas a Amazon CloudWatch. En Linux, esta configuración es `false` de manera predeterminada y las métricas se envían a CloudWatch. En Windows, esta configuración es `true` de manera predeterminada, por lo que debe cambiarla a `false` para enviar las métricas a CloudWatch para que AWS Cost Management las utilice. Para obtener más información sobre la configuración del agente de ECS, consulte [Configuración del agente de contenedor de Amazon ECS](ecs-agent-config.md). + La versión mínima de Docker para obtener métricas fiables es la versión de Docker v20.10.13 y versiones posteriores, que se incluyen en la AMI 20220607 optimizada para Amazon ECS y versiones posteriores. Para utilizar los *datos de asignación de costos divididos*, debe crear un informe y seleccionar los **datos de asignación de costos divididos**. Para obtener más información, consulte [Creating Cost and Usage Reports](https://docs.aws.amazon.com/cur/latest/userguide/cur-create.html) en la Guía del usuario de AWS Cost and Usage Report. AWS Cost Management calcula los *datos de asignación de costos divididos* con el uso de memoria y CPU de la tarea. AWS Cost Management puede utilizar la reserva de CPU y memoria de la tarea en lugar del uso, si este no está disponible. Si ve que el CUR utiliza las reservas, compruebe que las instancias de contenedor cumplen los requisitos previos y que las métricas de uso de los recursos de la tarea aparecen en CloudWatch.