# Supervisión de métricas de CloudFront con Amazon CloudWatch
Amazon CloudFront está integrado con Amazon CloudWatch y publica automáticamente las métricas operativas para las distribuciones y funciones periféricas ([Lambda@Edge y CloudFront Functions](edge-functions.md)). Puede usar estas métricas para solucionar problemas, realizar un seguimiento y depurar. Muchas de estas métricas se muestran en un conjunto de gráficos en la consola de CloudFront y también se puede acceder a ellos con la API o la CLI de CloudFront. Todas estas métricas están disponibles en la [Consola de CloudWatch](https://console.aws.amazon.com/cloudwatch/home) o mediante la API o la CLI de CloudWatch. Las métricas de CloudFront no se contabilizan en las [cuotas de CloudWatch (antes llamadas límites)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) ni generan ningún coste adicional.
Además de las métricas predeterminadas para distribuciones de CloudFront, puede activar métricas adicionales por un coste adicional. Las métricas adicionales se aplican a distribuciones de CloudFront y deben activarse para cada distribución de forma individual. Para obtener más información sobre el costo, consulte [Estimación del costo de las métricas adicionales de CloudFront](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional-pricing).
También puede establecer alarmas basadas en estas métricas en la consola de CloudFront o en la consola de CloudWatch, la API o la CLI. Por ejemplo, puede configurar una alarma en función de la métrica de `5xxErrorRate`, que representa el porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta está en el rango de `500` a `599`, inclusive. Cuando la tasa de error alcanza un valor determinado durante una determinada cantidad de tiempo, por ejemplo, el 5 % de las solicitudes durante 5 minutos seguidos, se activa la alarma. Especifique el valor de la alarma y su unidad de tiempo al crear la alarma.
**Notas**
Cuando crea una alarma CloudWatch en la consola CloudFront, se crea una para usted en la región Este de EE. UU. (Norte de Virginia) (`us-east-1`). Si crea una alarma desde la consola de CloudWatch, debe usar la misma región. Debido a que CloudFront es un servicio global, las métricas del servicio se envían a Este de EE. UU. (Norte de Virginia).
Al crear alarmas, se aplican los [precios de CloudWatch estándar](https://aws.amazon.com/cloudwatch/pricing/).
**Topics**
+ [Visualización de métricas de funciones periféricas y de CloudFront](viewing-cloudfront-metrics.md)
+ [Creación de alarmas de para métricas de](receiving-notifications.md)
+ [Descarga de datos de métricas en formato CSV](cloudwatch-csv.md)
+ [Tipos de métricas para CloudFront](programming-cloudwatch-metrics.md)
# Visualización de métricas de funciones periféricas y de CloudFront
Puede consultar métricas operativas sobre las distribuciones de CloudFront y [funciones perimetrales](https://aws.amazon.com/cloudfront/features/#Edge_Computing) en la consola de CloudFront.
**Visualización de métricas de funciones periféricas y de CloudFront en CloudFront**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudFront en [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. En el panel de navegación, seleccione **Supervisión**.
1. Para ver gráficos sobre la actividad de una distribución de CloudFront o una función perimetral específica, elija una y, a continuación, elija **View distribution metrics** (Ver las métricas de distribución) o **View metrics (Ver métricas)**.
1. Puede personalizar los gráficos por medio de uno de los siguientes procedimientos:
1. Para cambiar el intervalo de tiempo de la información que se muestra en los gráficos, seleccione 1h (1 hora), 3h (3 horas), u otro rango o especifique un rango personalizado.
1. Para cambiar la frecuencia con la que CloudFront actualiza la información en el gráfico, elija la flecha hacia abajo junto al icono de actualización y, a continuación, seleccione una frecuencia de actualización. El valor predeterminado de actualización es de 1 minuto, pero puede elegir otras opciones.
1. Para ver los gráficos de CloudFront en la consola de CloudWatch, elija **Add to dashboard (Agregar al panel)**. Debe utilizar la región Este de EE. UU. (Norte de Virginia) para ver los gráficos en la consola de CloudWatch.
**Topics**
+ [Métricas de distribución predeterminadas de CloudFront](#monitoring-console.distributions)
+ [Activación de métricas de distribución adicionales de CloudFront](#monitoring-console.distributions-additional)
+ [Métricas de la función de Lambda@Edge predeterminada](#monitoring-console.lambda-at-edge)
+ [Métricas de CloudFront Functions predeterminadas](#monitoring-console.cloudfront-functions)
## Métricas de distribución predeterminadas de CloudFront
Las siguientes métricas predeterminadas se incluyen en todas las distribuciones de CloudFront sin costo adicional:
**Solicitudes**
La cantidad total de solicitudes de lector recibidas por CloudFront, para todos los métodos HTTP y para las solicitudes HTTP y HTTPS.
**Bytes descargados**
La cantidad total de bytes descargados por los lectores para las solicitudes `GET` y `HEAD`.
**Bytes cargados**
La cantidad total de bytes que los lectores cargaron en CloudFront mediante las solicitudes `OPTIONS`, `POST` y `PUT`.
**Tasa de errores 4xx**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `4xx`.
**Tasa de errores 5xx**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `5xx`.
**Tasa de errores total**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `4xx` o `5xx`.
Estas métricas se muestran en gráficos para cada distribución de CloudFront en la página **Supervisión** de la consola de CloudFront. En cada gráfico, los totales se muestran con una granularidad de un minuto. Además de ver los gráficos, también puede [descargar informes de métricas como archivos CSV](cloudwatch-csv.md).
## Activación de métricas de distribución adicionales de CloudFront
Además de las métricas predeterminadas, puede activar métricas adicionales por un coste adicional. Para obtener más información sobre el costo, consulte [Estimación del costo de las métricas adicionales de CloudFront](#monitoring-console.distributions-additional-pricing).
Estas métricas adicionales se deben activar para cada distribución de forma individual:
**Tasa de aciertos de caché**
El porcentaje de todas las solicitudes almacenables en caché para las que CloudFront distribuyó el contenido desde su caché. Las solicitudes HTTP `POST` y `PUT`, así como los errores, no se consideran solicitudes almacenables en caché.
**Latencia de origen**
El tiempo total transcurrido desde que CloudFront recibe una solicitud hasta que comienza a proporcionar una respuesta a la red (no al lector) en las solicitudes que se distribuyen desde el origen, no desde la caché de CloudFront. Esto también se conoce como *latencia de primer byte* o *time-to-first-byte*.
**Tasa de error por código de estado**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es un código particular en el rango de `4xx` o `5xx`. Esta métrica está disponible para todos estos códigos de error: `401`, `403`, `404`, `502`, `503` y `504`.
Puede activar métricas adicionales en la consola de CloudFront, con CloudFormation, AWS Command Line Interface (AWS CLI) o la API de CloudFront.
------
#### [ Console ]
**Activación de métricas adicionales**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudFront en [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. En el panel de navegación, seleccione **Supervisión**.
1. Elija la distribución para la que desea activar métricas adicionales y, a continuación, elija **View distribution metrics** (Ver métricas de distribución).
1. Elija **Manage additional metrics** (Administrar métricas adicionales).
1. En la ventana **Manage additional metrics** (Administrar métricas adicionales), active **Enabled** (Activado). Después de activar las métricas adicionales, puede cerrar la ventana **Manage additional metrics** (Administrar métricas adicionales).
Cuando active las métricas adicionales, se mostrarán en gráficos. En cada gráfico, los totales se muestran con una granularidad de un minuto. Además de ver los gráficos, también puede [descargar informes de métricas como archivos CSV](cloudwatch-csv.md).
------
#### [ CloudFormation ]
Para activar métricas adicionales con CloudFormation, use el tipo de recurso `AWS::CloudFront::MonitoringSubscription`. En el siguiente ejemplo se muestra la sintaxis de plantilla de CloudFormation, en formato YAML, para habilitar métricas adicionales.
```
Type: AWS::CloudFront::MonitoringSubscription
Properties:
DistributionId: EDFDVBD6EXAMPLE
MonitoringSubscription:
RealtimeMetricsSubscriptionConfig:
RealtimeMetricsSubscriptionStatus: Enabled
```
------
#### [ CLI ]
Para administrar métricas adicionales con la AWS Command Line Interface (AWS CLI), utilice uno de los siguientes comandos:
**Para activar métricas adicionales para una distribución**
+ Utilice el comando **create-monitoring-subscription** como se muestra en el ejemplo siguiente. Reemplace *EDFDVBD6EXAMPLE* por el ID de la distribución para la que está habilitando métricas adicionales.
```
aws cloudfront create-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE --monitoring-subscription RealtimeMetricsSubscriptionConfig={RealtimeMetricsSubscriptionStatus=Enabled}
```
**Para ver si las métricas adicionales están activadas para una distribución**
+ Utilice el comando **get-monitoring-subscription** como se muestra en el ejemplo siguiente. Reemplace *EDFDVBD6EXAMPLE* por el ID de la distribución que está comprobando.
```
aws cloudfront get-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
```
**Para desactivar métricas adicionales para una distribución**
+ Utilice el comando **delete-monitoring-subscription** como se muestra en el ejemplo siguiente. Reemplace *EDFDVBD6EXAMPLE* por el ID de la distribución para la que está desactivando métricas adicionales.
```
aws cloudfront delete-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
```
------
#### [ API ]
Para administrar métricas adicionales con la API de CloudFront, utilice una de las siguientes operaciones de la API.
+ Para activar métricas adicionales para una distribución, utilice [CreateMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateMonitoringSubscription.html).
+ Para consultar si las métricas adicionales están activadas para una distribución, utilice [GetMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetMonitoringSubscription.html).
+ Para desactivar métricas adicionales para una distribución, utilice [DeleteMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteMonitoringSubscription.html).
Para obtener más información sobre estas operaciones de la API, consulte la documentación de referencia de la API para el SDK de AWS u otro cliente de la API.
------
### Estimación del costo de las métricas adicionales de CloudFront
Cuando activa métricas adicionales para una distribución, CloudFront envía hasta 8 métricas a CloudWatch en la región Este de EE. UU. (Norte de Virginia). CloudWatch cobra una tarifa fija baja por cada métrica. Esta tarifa se cobra solo una vez al mes por métrica (hasta 8 métricas por distribución). Se trata de una tarifa fija, por lo que el costo sigue siendo el mismo independientemente del número de solicitudes o respuestas que reciba o envíe la distribución de CloudFront. Para conocer la tarifa por métrica, consulte la [página de precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/) y la [calculadora de precios de CloudWatch](https://aws.amazon.com/cloudwatch/pricing/#Pricing_calculator). Se aplican cargos adicionales de la API al recuperar las métricas con la API de CloudWatch.
## Métricas de la función de Lambda@Edge predeterminada
Puede usar métricas de CloudWatch para monitorear, en tiempo real, los problemas con sus funciones de Lambda@Edge. No hay cargo adicional para estas métricas.
Al adjuntar una función de Lambda@Edge a un comportamiento de la caché en una distribución de CloudFront, Lambda comienza a enviar métricas a CloudWatch automáticamente. Las métricas están disponibles para todas las regiones de Lambda, pero para ver las métricas en la consola de CloudWatch u obtener los datos de métricas de la API de CloudWatch, debe utilizar la región Este de EE. UU. (Norte de Virginia) (`us-east-1`). El nombre del grupo de métricas tiene el formato de: `AWS/CloudFront/distribution-ID`, donde *ID-distribución* es el ID de la distribución de CloudFront a la que está asociada la función de Lambda@Edge. Para obtener más información sobre las métricas de CloudWatch, consulte la [Guía del usuario de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
Las siguientes métricas predeterminadas se muestran en gráficos para cada función de Lambda@Edge en la página **Supervisión** de la consola de CloudFront:
+ `5xx`Intervalo de errores de para Lambda@Edge
+ Errores de ejecución de Lambda
+ Respuestas no válidas de Lambda
+ Limitaciones de Lambda
Los gráficos incluyen la cantidad de invocaciones, errores, limitaciones, etc. En cada gráfico, los totales se muestran con una granularidad de un minuto, agrupados por región de AWS.
Si ve un pico de errores que desea investigar, por ejemplo, puede elegir una función y, a continuación, ver los archivos de registro por región de AWS hasta que determine qué función está causando los problemas y en qué región de AWS. Para obtener más información sobre la resolución de errores Lambda@Edge, consulte:
+ [Cómo determinar el tipo de error](lambda-edge-testing-debugging.md#lambda-edge-testing-debugging-failure-type)
+ [Cuatro pasos para depurar su entrega de contenido en AWS](https://aws.amazon.com/blogs/networking-and-content-delivery/four-steps-for-debugging-your-content-delivery-on-aws/)
## Métricas de CloudFront Functions predeterminadas
CloudFront Functions envía métricas operativas a Amazon CloudWatch para que pueda supervisar sus funciones. Ver estas métricas puede ayudarle a solucionar problemas, a realizar un seguimiento y a depurar. CloudFront Functions publica en CloudWatch las siguientes métricas:
+ **Invocaciones** (`FunctionInvocations`): el número de veces que se inició (invocó) la función en un periodo de tiempo determinado.
+ **Errores de validación** (`FunctionValidationErrors`): el número de errores de validación que la función produjo en un periodo de tiempo determinado. Los errores de validación se producen cuando la función se ejecuta correctamente, pero devuelve datos no válidos (un [objeto de evento ](functions-event-structure.md)no válido).
+ **Errores de ejecución** (`FunctionExecutionErrors`): el número de errores de ejecución que se produjeron en un periodo de tiempo determinado. Los errores de ejecución se producen cuando la función no se completa correctamente.
+ **Utilización de cómputo** (`FunctionComputeUtilization`): la cantidad de tiempo que la función tardó en ejecutarse como un porcentaje del tiempo máximo permitido. Por ejemplo, un valor de 35 significa que la función se completó en el 35 % del tiempo máximo permitido. Esta métrica es un número entre 0 y 100.
Si este valor alcanza 100 o está cerca de esa cifra, la función ha utilizado o está cerca de utilizar el tiempo de ejecución permitido y es posible que las solicitudes posteriores se vean limitadas. Si la función se ejecuta al 80 % o más de su utilización, le recomendamos que la revise para reducir el tiempo de ejecución y mejorar la utilización. Por ejemplo, puede que solo desee registrar los errores, simplificar cualquier expresión regular compleja o eliminar el análisis sintáctico de objetos JSON complejos.
+ **Limitaciones** (`FunctionThrottles`): el número de veces que se limitó la función en un periodo de tiempo determinado. Las funciones se pueden limitar por las siguientes razones:
+ La función supera continuamente el tiempo máximo permitido para la ejecución
+ La función produce errores de compilación
+ Hay un número inusualmente elevado de solicitudes por segundo
CloudFront KeyValueStore también envía las siguientes métricas operativas a Amazon CloudWatch:
+ **Solicitudes de lectura** (`KvsReadRequests`): el número de veces que la función leyó correctamente del almacén de clave-valor en un periodo de tiempo determinado.
+ **Errores de lectura** (`KvsReadErrors`): el número de veces que la función no leyó del almacén de clave-valor en un periodo de tiempo determinado.
Todas estas métricas se publican en CloudWatch en la región EE. UU. Este (Norte de Virginia) (`us-east-1`), en el espacio de nombres de CloudFront. También puede verlas en la consola de CloudWatch. En la consola de CloudWatch, puede ver las métricas por función o por función por distribución.
También puede utilizar CloudWatch para establecer alarmas en función de estas métricas. Por ejemplo, puede establecer una alarma en función de la métrica de tiempo de ejecución (`FunctionComputeUtilization`), que representa el porcentaje de tiempo disponible que la función tardó en ejecutarse. Cuando el tiempo de ejecución alcanza un determinado valor durante un tiempo determinado. Por ejemplo, si elige más del 70 % del tiempo disponible durante 15 minutos continuos, la alarma se desencadena. Especifique el valor de las alarmas y su unidad de tiempo al crear la alarma.
**nota**
CloudFront Functions envía métricas a CloudWatch solo para las funciones de la etapa `LIVE` que se ejecutan en respuesta a solicitudes y respuestas de producción. Al [probar una función](test-function.md), CloudFront no envía ninguna métrica a CloudWatch. La salida de prueba contiene información sobre errores, uso de cómputo y registros de funciones (instrucciones `console.log()`), pero esta información no se envía a CloudWatch.
Para obtener información sobre cómo obtener estas métricas con la API de CloudWatch, consulte [Tipos de métricas para CloudFront](programming-cloudwatch-metrics.md).
# Creación de alarmas de para métricas de
En la consola de CloudFront, puede configurar alarmas para que le envíen notificaciones a través de Amazon Simple Notification Service (Amazon SNS) en función de métricas específicas de CloudFront.
**Creación de alarmas para métricas**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudFront en [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. En el panel de navegación, elija **Alarmas**.
1. Elija **Crear alarma**.
1. Para **Detalles**, especifique lo siguiente:
1. **Nombre de alarma**: un nombre para la alarma.
1. **Distribución**: la distribución de CloudFront para la que está creando la alarma.
1. Para **Condición**, especifique lo siguiente:
1. **Métrica**: la métrica para la que está creando la alarma.
1. **"IF" **: el umbral cuando CloudWatch debe desencadenar una alarma y enviar una notificación al tema de Amazon SNS. Por ejemplo, para recibir una notificación cuando el intervalo de error de `5xx` supera el 1 %, especifique lo siguiente:
**Tasa de errores 5xx** **> 1**
1. **Periodos consecutivos "FOR"**: el periodo de tiempo durante el que se debe cumplir la condición antes de desencadenar una alarma. Cuando elija un valor, apunte a un equilibrio adecuado entre un valor que no active la alarma por problemas temporales, pero sí por problemas constantes o reales.
1. (Opcional) **Notificar**: el tema de Amazon SNS al que se envía la notificación si esta métrica desencadena una alarma.
1. Elija **Crear alarma**.
**Notas**
Al ingresar los valores de la condición, utilice números enteros sin signos de puntuación. Por ejemplo, para especificar mil, escriba **1000**.
Para `4xx`, `5xx` y el total de tasas de errores, el valor a especificar es un porcentaje.
Para las solicitudes, los bytes descargados y los bytes cargados, el valor a especificar son unidades. Por ejemplo, 1073742000 bytes.
Para obtener más información acerca de la creación de temas de Amazon SNS, consulte [Creación de un tema de Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*.
# Descarga de datos de métricas en formato CSV
Puede descargar los datos de métricas de CloudWatch para una distribución de CloudFront en formato CSV.
**Descarga de datos de métricas en formato CSV**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudFront en [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. En el panel de navegación, seleccione **Supervisión**.
1. Elija la distribución y, a continuación, elija **Ver métricas de distribución**.
1. Elija **Descargar CSV** y, a continuación, elija el periodo de tiempo, por ejemplo, **Durante el último día (periodo de 1 hora)**.
1. Una vez descargado el archivo, ábralo para ver la siguiente información.
**Topics**
+ [Información acerca del informe](#cloudwatch-csv-header)
+ [Datos del informe de las métricas](#cloudwatch-csv-data)
## Información acerca del informe
Las primeras filas del informe incluyen la siguiente información:
**Versión**
La versión de informes de CloudFront.
**Informe**
El nombre del informe.
**DistributionID**
ID de la distribución para la que ejecutó el informe.
**StartDateUTC**
El principio del intervalo de fechas para el que ha solicitado el informe, en tiempo universal coordinado (UTC).
**EndDateUTC**
El fin del intervalo de fechas para el que ha solicitado el informe, en tiempo universal coordinado (UTC).
**GeneratedTimeUTC**
La fecha y hora en ha solicitado el informe, en tiempo universal coordinado (UTC).
**Grado de detalle**
El periodo de tiempo para cada fila del informe, por ejemplo, `ONE_MINUTE`.
## Datos del informe de las métricas
El informe incluye los siguientes valores:
**DistributionID**
ID de la distribución para la que ejecutó el informe.
**FriendlyName**
Un nombre de dominio alternativos (CNAME) para la distribución, de haberlo. Si una distribución no tiene otros nombres de dominio, la lista incluye un nombre de dominio de origen para la distribución.
**TimeBucket**
La hora o la fecha a la que son aplicables los datos, en tiempo universal coordinado (UTC).
**Solicitudes**
La cantidad total de solicitudes de todos los códigos de estado HTTP (por ejemplo, `200`, `404`, etc.) y todos los métodos (por ejemplo, `GET`, `HEAD`, `POST`, etc.) durante ese periodo de tiempo.
**BytesDownloaded**
La cantidad de bytes que los espectadores han descargado mediante la distribución especificada durante el periodo de tiempo definido.
**BytesUploaded**
La cantidad de bytes que los espectadores han cargado mediante la distribución especificada durante el periodo de tiempo definido.
**TotalErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `4xx` o `5xx` para la distribución especificada durante el periodo de tiempo definido.
**4xxErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `4xx` para la distribución especificada durante el periodo de tiempo definido.
**5xxErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `5xx` para la distribución especificada durante el periodo de tiempo definido.
Si ha [activado métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional) para su distribución, el informe también incluye los siguientes valores adicionales:
**401ErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `401` para la distribución especificada durante el periodo de tiempo definido.
**403ErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `403` para la distribución especificada durante el periodo de tiempo definido.
**404ErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `404` para la distribución especificada durante el periodo de tiempo definido.
**502ErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `502` para la distribución especificada durante el periodo de tiempo definido.
**503ErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `503` para la distribución especificada durante el periodo de tiempo definido.
**504ErrorRatePct**
El porcentaje de solicitudes cuyo código de estado HTTP fue un error de `504` para la distribución especificada durante el periodo de tiempo definido.
**OriginLatency**
El tiempo total empleado en milisegundos desde que CloudFront recibió una solicitud hasta que comenzó a proporcionar una respuesta a la red (no al lector) en las solicitudes que se distribuyeron desde el origen, no desde la caché de CloudFront. Esto también se conoce como *latencia de primer byte* o *time-to-first-byte*.
**CacheHitRate**
El porcentaje de todas las solicitudes almacenables en caché para las que CloudFront distribuyó el contenido desde su caché. Las solicitudes HTTP `POST` y `PUT`, así como los errores, no se consideran solicitudes almacenables en caché.
# Tipos de métricas para CloudFront
Puede usar la API de CloudWatch o AWS Command Line Interface (AWS CLI) para obtener las métricas de CloudFront en programas o aplicaciones que cree. Puede usar los datos sin procesar para crear sus propios paneles personalizados, sus propias herramientas de alarma, etc.
Para obtener más información, consulte [get-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html) en la *Referencia de comandos de AWS CLI* o la operación de la API [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) en la *Referencia de la API de Amazon CloudWatch*.
**Topics**
+ [Valores para todas las métricas de CloudFront](#cloudfront-metrics-global-values)
+ [Valores para las métricas de distribución de CloudFront](#cloudfront-metrics-distribution-values)
+ [Valores para las métricas de funciones de CloudFront](#cloudfront-metrics-function-values)
**nota**
Para obtener las métricas de CloudFront con la API de CloudWatch, debe utilizar la región EE. UU. Este (Norte de Virginia) (`us-east-1`). También necesita conocer ciertos valores y tipos para cada métrica.
## Valores para todas las métricas de CloudFront
Los siguientes valores se aplican a todas las métricas de CloudFront:
**`Namespace`**
El valor para `Namespace` siempre es `AWS/CloudFront`.
**Dimensiones**
Cada métrica de CloudFront tiene las siguientes dimensiones:
**`DistributionId`**
El ID de la distribución de CloudFront para la que desea obtener métricas.
**`FunctionName`**
El nombre de la función (en CloudFront Functions) para la que desea obtener métricas.
Esta dimensión solo se aplica a las funciones.
**`Region`**
El valor de `Region` siempre es `Global`, porque CloudFront es un servicio global.
## Valores para las métricas de distribución de CloudFront
Utilice la información de la siguiente lista para obtener detalles sobre métricas de distribución específicas de CloudFront con la API de CloudWatch. Algunas de estas métricas solo están disponibles si se han activado métricas adicionales para la distribución.
**nota**
Solo se aplica una estadística, `Average` o `Sum`, para cada métrica. La siguiente lista especifica qué estadística se aplica a esa métrica.
**Tasa de errores 4xx**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `4xx`.
+ Nombre de métrica: `4xxErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Tasa de errores 401**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `401`. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `401ErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Tasa de errores 403**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `403`. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `403ErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Tasa de errores 404**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `404`. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `404ErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Tasa de errores 5xx**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `5xx`.
+ Nombre de métrica: `5xxErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Tasa de errores 502**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `502`. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `502ErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Tasa de errores 503**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `503`. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `503ErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Tasa de errores 504**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `504`. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `504ErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Bytes descargados**
La cantidad total de bytes descargados por los lectores para las solicitudes `GET` y `HEAD`.
+ Nombre de métrica: `BytesDownloaded`
+ Estadística válida: `Sum`
+ Unidad: `None`
**Bytes cargados**
La cantidad total de bytes que los lectores cargaron en CloudFront mediante las solicitudes `OPTIONS`, `POST` y `PUT`.
+ Nombre de métrica: `BytesUploaded`
+ Estadística válida: `Sum`
+ Unidad: `None`
**Tasa de aciertos de caché**
El porcentaje de todas las solicitudes almacenables en caché para las que CloudFront distribuyó el contenido desde su caché. Las solicitudes HTTP `POST` y `PUT`, así como los errores, no se consideran solicitudes almacenables en caché. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `CacheHitRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Latencia de origen**
El tiempo total empleado en milisegundos desde que CloudFront recibe una solicitud hasta que comienza a proporcionar una respuesta a la red (no al lector) en las solicitudes que se distribuyeron desde el origen, no desde la caché de CloudFront. Esto también se conoce como *latencia de primer byte* o *time-to-first-byte*. Para obtener esta métrica, primero debe [activar métricas adicionales](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nombre de métrica: `OriginLatency`
+ Estadística válida: `Percentile`
+ Unidad: `Milliseconds`
Para obtener la estadística de `Percentile` desde la API de CloudWatch, use el parámetro `ExtendedStatistics`, no `Statistics`. Para obtener más información, consulte [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html) en la *Referencia de la API de Amazon CloudWatch* o la documentación de referencia de los [SDK de AWS](https://docs.aws.amazon.com/#sdks)
**Solicitudes**
La cantidad total de solicitudes de lector recibidas por CloudFront, para todos los métodos HTTP y para las solicitudes HTTP y HTTPS.
+ Nombre de métrica: `Requests`
+ Estadística válida: `Sum`
+ Unidad: `None`
**Tasa de errores total**
El porcentaje de todas las solicitudes de espectador para las cuales el código de estado HTTP de la respuesta es `4xx` o `5xx`.
+ Nombre de métrica: `TotalErrorRate`
+ Estadística válida: `Average`
+ Unidad: `Percent`
## Valores para las métricas de funciones de CloudFront
Utilice la información de la siguiente lista para obtener detalles sobre métricas específicas de CloudFront con la API de CloudWatch.
**nota**
Solo se aplica una estadística, `Average` o `Sum`, para cada métrica. La siguiente lista especifica qué estadística se aplica a esa métrica.
**Invocaciones**
El número de veces que se inició (invocó) la función en un periodo de tiempo determinado.
+ Nombre de métrica: `FunctionInvocations`
+ Estadística válida: `Sum`
+ Unidad: `None`
**Errores de validación**
El número de errores de validación que produjo la función en un periodo de tiempo determinado. Los errores de validación se producen cuando la función se ejecuta correctamente, pero devuelve datos no válidos (un objeto de evento no válido).
+ Nombre de métrica: `FunctionValidationErrors`
+ Estadística válida: `Sum`
+ Unidad: `None`
**Errores de ejecución**
El número de errores de ejecución que se produjeron en un periodo de tiempo determinado. Los errores de ejecución se producen cuando la función no se completa correctamente.
+ Nombre de métrica: `FunctionExecutionErrors`
+ Estadística válida: `Sum`
+ Unidad: `None`
**Utilización de cómputo**
La cantidad de tiempo (0-100) que la función tardó en ejecutarse como porcentaje del tiempo máximo permitido. Por ejemplo, un valor de 35 significa que la función se completó en el 35 % del tiempo máximo permitido.
+ Nombre de métrica: `FunctionComputeUtilization`
+ Estadística válida: `Average`
+ Unidad: `Percent`
**Limitaciones**
El número de veces que se limitó la función en un periodo de tiempo determinado.
+ Nombre de métrica: `FunctionThrottles`
+ Estadística válida: `Sum`
+ Unidad: `None`