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 en la Referencia de comandos de AWS CLI o la operación de la API GetMetricData en la Referencia de la API de Amazon CloudWatch.
Temas
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 esAWS/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 esGlobal
, 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.-
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.-
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.-
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.-
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.-
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.-
Nombre de métrica:
504ErrorRate
-
Estadística válida:
Average
-
Unidad:
Percent
-
- Bytes descargados
-
La cantidad total de bytes descargados por los espectadores para las solicitudes
GET
,HEAD
yOPTIONS
.-
Nombre de métrica:
BytesDownloaded
-
Estadística válida:
Sum
-
Unidad:
None
-
- Bytes cargados
-
La cantidad total de bytes que los lectores cargaron en su origen con CloudFront mediante las solicitudes
POST
yPUT
.-
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
yPUT
, así como los errores, no se consideran solicitudes almacenables en caché. Para obtener esta métrica, primero debe activar métricas adicionales.-
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.
-
Nombre de métrica:
OriginLatency
-
Estadística válida:
Percentile
-
Unidad:
Milliseconds
nota
Para obtener la estadística de
Percentile
desde la API de CloudWatch, use el parámetroExtendedStatistics
, noStatistics
. Para obtener más información, consulte GetMetricStatistics en la Referencia de la API de Amazon CloudWatch o la documentación de referencia de los SDK de AWS -
- 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
o5xx
.-
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
-