# Configuraciones de métricas de CloudWatch
Con las métricas de solicitudes de Amazon CloudWatch para Amazon S3, puede obtener métricas de CloudWatch de 1 minuto, configurar alarmas de CloudWatch y acceder a paneles de control de CloudWatch para ver las operaciones y el rendimiento de su almacenamiento de Amazon S3 en tiempo real. Para las aplicaciones que dependen del almacenamiento en la nube, estas métricas le permiten identificar rápidamente los problemas operativos y actuar en consecuencia. Cuando se activan, estas métricas de 1 minuto están disponibles en el nivel del bucket de Amazon S3 de forma predeterminada.
Si desea obtener las métricas de solicitudes de CloudWatch para los objetos de un bucket, debe crear una configuración de métricas para el bucket. Para obtener más información, consulte [Creación de una configuración de métricas de CloudWatch para todos los objetos del bucket](configure-request-metrics-bucket.md).
También puede usar un prefijo compartido, una etiqueta de objeto o un punto de acceso para definir las métricas recopiladas. Este método de definición de un filtro le permite crear distintos filtros de métricas para aplicaciones empresariales, organizaciones internas o flujos de trabajo o específicos. Para obtener más información, consulte [Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso](metrics-configurations-filter.md). Para obtener más información sobre las métricas de CloudWatch disponibles y las diferencias entre las métricas de almacenamiento y de solicitudes, consulte [Monitorización de métricas con Amazon CloudWatch](cloudwatch-monitoring.md).
Tenga en cuenta las siguientes consideraciones al utilizar configuraciones de métricas:
+ Puede tener un máximo de 1000 configuraciones de métricas por cada bucket.
+ Puede seleccionar qué objetos de un bucket quiere incluir en las configuraciones de métricas mediante el uso de filtros. Puede filtrar con un prefijo compartido, una etiqueta de objeto o punto de acceso para alinear los filtros de métricas a aplicaciones empresariales, flujos de trabajo u organizaciones internas específicos. Para solicitar métricas de la totalidad del bucket, cree una configuración de métricas sin filtro.
+ Las configuraciones de métricas solo son necesarias para habilitar las métricas de solicitudes. Las métricas diarias de almacenamiento en el nivel de bucket siempre están activadas y se facilitan sin costo adicional. En la actualidad no es posible obtener métricas diarias de almacenamiento para un subconjunto filtrado de objetos.
+ Cada configuración de métricas habilita el conjunto completo de [métricas de solicitudes disponibles](metrics-dimensions.md#s3-request-cloudwatch-metrics). Las métricas específicas de operaciones (como `PostRequests`) solo se generan si hay solicitudes de ese tipo para el bucket o el filtro.
+ Se generan métricas de solicitudes para las operaciones de objetos. También se generan para las operaciones que enumeran el contenido de un bucket, como [GET Bucket (List Objects)](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html), [GET Bucket Object Versions](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETVersion.html) y [List Multipart Uploads](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html), pero no se generan para otras operaciones con los buckets.
+ Las métricas de solicitudes admiten el filtrado por prefijo, etiquetas de objeto o puntos de acceso, pero no las métricas de almacenamiento.
**Entrega de métricas de CloudWatch en la medida de lo posible**
Las métricas de CloudWatch se entregan en la medida que es posible. La mayoría de solicitudes de un objeto de Amazon S3 que tienen métricas de solicitudes se derivan en el envío de un punto de datos a CloudWatch.
La integridad y la puntualidad de las métricas no están garantizadas. Es posible que el punto de datos de una solicitud determinada se envíe con una marca temporal posterior al momento en el que la solicitud se ha procesado realmente. Es posible que el punto de datos durante un minuto se retrase antes de estar disponible a través de CloudWatch, o puede que no se entregue en absoluto. Las métricas de solicitudes de CloudWatch le dan una idea de la naturaleza del tráfico al que se enfrenta su bucket en tiempo casi real. No pretende ser un recuento completo de todas las solicitudes.
Dado que esta característica funciona en la medida de lo posible, los informes disponibles en el [panel de Administración de facturación y costos](https://console.aws.amazon.com/billing/home?#/) podrían incluir una o varias solicitudes de acceso que no aparecen en las métricas del bucket.
Para obtener más información sobre cómo trabajar con métricas de CloudWatch en Amazon S3, consulte los siguientes temas.
**Topics**
+ [
# Creación de una configuración de métricas de CloudWatch para todos los objetos del bucket
](configure-request-metrics-bucket.md)
+ [
# Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso
](metrics-configurations-filter.md)
+ [
# Eliminación de un filtro de métricas
](delete-request-metrics-filter.md)
# Creación de una configuración de métricas de CloudWatch para todos los objetos del bucket
Cuando configura métricas de solicitud, puede crear una configuración de métricas de CloudWatch para todos los objetos del bucket o puede filtrar por prefijo, etiqueta de objeto o punto de acceso. A través de los procedimientos de este tema, se muestra cómo crear una configuración para todos los objetos del bucket. Para crear una configuración que filtra por etiqueta de objeto, prefijo o punto de acceso, consulte [Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso](metrics-configurations-filter.md).
Existen tres tipos de métricas de Amazon CloudWatch para Amazon S3: métricas de almacenamiento, métricas de solicitud y métricas de replicación. Las métricas de almacenamiento se informan una vez al día y se entregan a todos los clientes sin costo adicional. Las métricas de solicitudes están disponibles en intervalos de un minuto después de un breve periodo de latencia para procesarlas. Las métricas de solicitud se facturan según la tarifa de CloudWatch estándar. Debe incluir métricas de solicitudes configurándolas en la consola o con la API de Amazon S3. Las [métricas de replicación de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/viewing-replication-metrics.html) proporcionan métricas detalladas para las reglas de replicación en la configuración de la misma. Con las métricas de replicación, puede monitorizar su progreso minuto a minuto mediante el seguimiento de los bytes pendientes, las operaciones que no se han replicado y la latencia de replicación.
Para obtener más información acerca de las métricas de CloudWatch para Amazon S3, consulte [Monitorización de métricas con Amazon CloudWatch](cloudwatch-monitoring.md).
Puede agregar configuraciones de métricas a un bucket mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) o la API de REST de Amazon S3.
## Uso de la consola de S3
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Buckets de uso general**.
1. En la lista de buckets, elija el nombre del bucket que contiene los objetos para los que desea obtener métricas de solicitudes.
1. Elija la pestaña **Metrics (Métricas)**.
1. En **Bucket metrics (Métricas de bucket)**, seleccione **View additional charts (Ver gráficos adicionales)**.
1. Seleccione la pestaña **Request metrics (Métricas de solicitud)**.
1. Elija **Create Filter (Crear filtro)**.
1. En el cuadro **Filter name (Nombre del filtro)**, escriba el nombre del filtro.
Los nombres solo pueden incluir letras, números, puntos, guiones y guiones bajos. Se recomienda utilizar el nombre `EntireBucket` si el filtro se aplica a todos los objetos.
1. En **Filter scope (Alcance del filtro)**, elija **This filter applies to all objects in the bucket (Este filtro se aplica a todos los objetos del bucket)**.
También puede definir un filtro para que las métricas solo se recopilen y comuniquen en un subconjunto de objetos en el bucket. Para obtener más información, consulte [Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso](metrics-configurations-filter.md).
1. Elija **Save changes (Guardar cambios)**.
1. En la pestaña **Request metrics** (Métricas de solicitud), bajo **Filters** (Filtros), elija el filtro que acaba de crear.
Después de unos 15 minutos, CloudWatch comienza a hacer el seguimiento de estas métricas de solicitud. Puede verlas en la pestaña **Request metrics (Solicitar métricas)**. Puede ver gráficos de las métricas en la consola de Amazon S3 o de CloudWatch. Las métricas de solicitud se facturan según la tarifa de CloudWatch estándar. Para obtener más información, consulte los [precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
## Uso de la API de REST
También puede añadir configuraciones de métricas mediante programación con la API de REST de Amazon S3. Para obtener más información acerca de cómo agregar y trabajar con configuraciones de métricas, consulte los siguientes temas en la *Referencia de API de Amazon Simple Storage Service*:
+ [PUT Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [GET Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [List Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTListBucketMetricsConfiguration.html)
+ [DELETE Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTDeleteBucketMetricsConfiguration.html)
## Mediante AWS CLI
1. Instale y configure la AWS CLI. Para obtener instrucciones, consulte [Instalación, actualización y desinstalación de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) en la *Guía del usuario de AWS Command Line Interface*.
1. Abra un terminal.
1. Ejecute el siguiente comando para agregar una configuración de métricas.
```
aws s3api put-bucket-metrics-configuration --endpoint https://s3.us-west-2.amazonaws.com --bucket bucket-name --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id"}'
```
# Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso
Existen tres tipos de métricas de Amazon CloudWatch para Amazon S3: métricas de almacenamiento, métricas de solicitud y métricas de replicación. Las métricas de almacenamiento se informan una vez al día y se entregan a todos los clientes sin costo adicional. Las métricas de solicitudes están disponibles en intervalos de un minuto después de un breve periodo de latencia para procesarlas. Las métricas de solicitud se facturan según la tarifa de CloudWatch estándar. Debe incluir métricas de solicitudes configurándolas en la consola o con la API de Amazon S3. Las [métricas de replicación de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/viewing-replication-metrics.html) proporcionan métricas detalladas para las reglas de replicación en la configuración de la misma. Con las métricas de replicación, puede monitorizar su progreso minuto a minuto mediante el seguimiento de los bytes pendientes, las operaciones que no se han replicado y la latencia de replicación.
Para obtener más información acerca de las métricas de CloudWatch para Amazon S3, consulte [Monitorización de métricas con Amazon CloudWatch](cloudwatch-monitoring.md).
Cuando configura las métricas de CloudWatch, puede crear un filtro para todos los objetos del bucket o puede filtrar la configuración en grupos de objetos relacionados dentro de un solo bucket. Puede filtrar los objetos de un bucket para incluirlos en una configuración de métricas en función de uno o varios de los siguientes tipos de filtro:
+ **Prefijo de nombre de clave de objeto**: aunque el modelo de datos de Amazon S3 es una estructura plana, puede inferir la jerarquía con un prefijo. La consola de Amazon S3 admite estos prefijos con el concepto de carpetas. Si filtra por prefijo, los objetos que tengan el mismo prefijo se incluyen en la configuración de métricas. Para obtener más información acerca de los prefijos, consulte [Organizar objetos con prefijos](using-prefixes.md).
+ **Etiqueta**: puede añadir etiquetas, que son pares de nombre de clave-valor, a los objetos. Las etiquetas le permiten encontrar y organizar los objetos fácilmente. También puede utilizar las etiquetas como filtro para las configuraciones de métricas. Para obtener más información acerca de las etiquetas de objeto, consulte [Categorización de los objetos mediante etiquetas](object-tagging.md).
+ **Punto de acceso**: los puntos de acceso de S3 se denominan puntos de enlace de red que se adjunta a los buckets y simplifican la administración del acceso a los datos a escala para los conjuntos de datos compartidos en S3. Cuando crea un filtro de punto de acceso, Amazon S3 incluye solicitudes al punto de acceso que especifique en la configuración de métricas. Para obtener más información, consulte [Monitorización y registro de puntos de acceso](access-points-monitoring-logging.md).
**nota**
Al crear una configuración de métricas que filtra por punto de acceso, debe utilizar el Nombre de recurso de Amazon (ARN) del punto de acceso, no el alias del punto de acceso. Asegúrese de utilizar el ARN para el punto de acceso en sí, no el ARN para un objeto específico. Para obtener más información acerca de los ARN de puntos de acceso, consulte [Uso de los puntos de acceso de Amazon S3 para buckets de propósito general](using-access-points.md).
Si especifica un filtro, únicamente las solicitudes que operen en objetos únicos pueden coincidir con el filtro e incluirse entre las métricas de las que se informa. Las solicitudes como [https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html](https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html) y `ListObjects` no devuelven métricas para las configuraciones con filtros.
Para solicitar un filtrado más complejo, seleccione dos o más elementos. Solo los objetos que tengan todos estos elementos se incluirán en la configuración de métricas. Si no configura filtros, todos los objetos del bucket se incluirán en la configuración de métricas.
## Uso de la consola de S3
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Buckets de uso general**.
1. En la lista de buckets, elija el nombre del bucket que contiene los objetos para los que desea obtener métricas de solicitudes.
1. Elija la pestaña **Metrics (Métricas)**.
1. En **Bucket metrics (Métricas de bucket)**, seleccione **View additional charts (Ver gráficos adicionales)**.
1. Seleccione la pestaña **Request metrics (Métricas de solicitud)**.
1. Elija **Create Filter (Crear filtro)**.
1. En el cuadro **Filter name** (Nombre del filtro), escriba el nombre del filtro.
Los nombres solo pueden incluir letras, números, puntos, guiones y guiones bajos.
1. En **Filter scope (Alcance del filtro)**, elija **Limit the scope of this filter using a prefix, object tags, and an S3 Access Point, or a combination of all three (Limitar el alcance de este filtro usando un prefijo, etiquetas de objeto y un Punto de acceso de S3, o una combinación de las tres)**.
1. En **Filter type (Tipo de filtro)**, elija al menos un tipo de filtro: **Prefix (Prefijo)**, **Object tags (Etiquetas de objeto)** o **Access Point (Punto de acceso)**.
1. Para definir un filtro de prefijo y limitar el alcance del filtro a una ruta individual, en el cuadro **Prefix (Prefijo)**, ingrese un prefijo.
1. Para definir un filtro de etiquetas de objeto, en **Object tags (Etiquetas de objeto)**, elija **Add tag (Agregar etiqueta)** y, luego, ingrese una etiqueta **Key (Clave)** y **Value (Valor)**.
1. Para definir un filtro de punto de acceso, en el campo **Punto de acceso de S3**, introduzca el ARN del punto de acceso o elija **Examinar S3** para desplazarse hasta el punto de acceso.
**importante**
No se puede introducir un alias de punto de acceso. Debe introducir el ARN para el punto de acceso en sí, no el ARN para un objeto específico.
1. Seleccione **Save changes (Guardar cambios)**.
Amazon S3 crea un filtro que usa el prefijo, etiquetas o punto de acceso especificados.
1. En la pestaña **Request metrics** (Métricas de solicitud), bajo **Filters** (Filtros), elija el filtro que acaba de crear.
Ahora ha creado un filtro que limita el alcance de las métricas de solicitud por prefijo, etiquetas de objeto o punto de acceso. Aproximadamente 15 minutos después de que CloudWatch comience a realizar el seguimiento de estas métricas de solicitudes, puede ver gráficos para las métricas en las consolas de Amazon S3 y CloudWatch. Las métricas de solicitud se facturan según la tarifa de CloudWatch estándar. Para obtener más información, consulte los [precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
También puede configurar métricas de solicitud en el nivel de bucket. Para obtener información, consulte [Creación de una configuración de métricas de CloudWatch para todos los objetos del bucket](configure-request-metrics-bucket.md).
## Mediante AWS CLI
1. Instale y configure la AWS CLI. Para obtener instrucciones, consulte [Instalación, actualización y desinstalación de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) en la *Guía del usuario de AWS Command Line Interface*.
1. Abra un terminal.
1. Ejecute uno de los siguientes comandos para agregar una configuración de métricas:
**Example : para filtrar por prefijo**
```
aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} '
```
**Example : para filtrar por etiquetas**
```
aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} '
```
**Example : para filtrar por punto de acceso**
```
aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} '
```
**Example : para filtrar por prefijo, etiquetas y punto de acceso**
```
aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '
{
"Id": "metrics-config-id",
"Filter": {
"And": {
"Prefix": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"AccessPointArn": "arn:aws:s3:Region:account-id:accesspoint/access-point-name"
}
}
}'
```
## Uso de la API de REST
También puede añadir configuraciones de métricas mediante programación con la API de REST de Amazon S3. Para obtener más información acerca de cómo agregar y trabajar con configuraciones de métricas, consulte los siguientes temas en la *Referencia de API de Amazon Simple Storage Service*:
+ [PUT Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [GET Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [List Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTListBucketMetricsConfiguration.html)
+ [DELETE Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTDeleteBucketMetricsConfiguration.html)
# Eliminación de un filtro de métricas
Puede eliminar un filtro de métricas de solicitud de Amazon CloudWatch si ya no lo necesita. Al eliminar un filtro, ya no se le aplicarán cargos por las métricas de solicitud que utilicen ese *filtro específico*. Sin embargo, se le seguirá cobrando por cualquier otra configuración de filtro que exista.
Cuando elimina un filtro, ya no puede usar el filtro para las métricas de solicitud. La eliminación de un filtro no se puede deshacer.
Para obtener información acerca de cómo crear un filtro de métricas de solicitud, consulte los siguientes temas:
+ [Creación de una configuración de métricas de CloudWatch para todos los objetos del bucket](configure-request-metrics-bucket.md)
+ [Creación de una configuración de métricas que filtra por prefijo, etiqueta de objeto o punto de acceso](metrics-configurations-filter.md)
## Uso de la consola de S3
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Buckets de uso general**.
1. En la lista de buckets, elija el nombre del bucket que contiene los objetos para los que desea obtener métricas de solicitudes.
1. Elija la pestaña **Metrics (Métricas)**.
1. En **Bucket metrics (Métricas de bucket)**, seleccione **View additional charts (Ver gráficos adicionales)**.
1. Seleccione la pestaña **Request metrics (Métricas de solicitud)**.
1. Seleccione **Manage filters (Administrar filtros)**.
1. Elija el filtro.
**importante**
La eliminación de un filtro no se puede deshacer.
1. Elija **Delete (Eliminar)**.
Amazon S3 elimina el filtro.
## Uso de la API de REST
También puede añadir configuraciones de métricas mediante programación con la API de REST de Amazon S3. Para obtener más información acerca de cómo agregar y trabajar con configuraciones de métricas, consulte los siguientes temas en la *Referencia de API de Amazon Simple Storage Service*:
+ [PUT Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [GET Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [List Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTListBucketMetricsConfiguration.html)
+ [DELETE Bucket Metric Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTDeleteBucketMetricsConfiguration.html)