# Tipos de métricas para CloudFront
<a name="programming-cloudwatch-metrics"></a>

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
<a name="cloudfront-metrics-global-values"></a>

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
<a name="cloudfront-metrics-distribution-values"></a>

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
<a name="cloudfront-metrics-function-values"></a>

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`