Obtener métricas mediante la API de CloudWatch - Amazon CloudFront

Obtener métricas mediante la API de CloudWatch

Puede utilizar la API o la CLI de Amazon CloudWatch para obtener las métricas de CloudFront en los 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 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 dos dimensiones siguientes:

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.

nota

Para obtener las métricas de CloudFront desde la API de CloudWatch, debe utilizar la región EE. UU. Este (Norte de Virginia) (us-east-1).

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 habilitado 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 habilitar 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 habilitar 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 habilitar 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 habilitar 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 habilitar 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 habilitar 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 y OPTIONS.

  • 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 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 habilitar 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 habilitar 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ámetro ExtendedStatistics, no Statistics. 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 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: Invocations

  • 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: ValidationErrors

  • 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: ExecutionErrors

  • Estadística válida: Sum

  • Unidad: None

Hora de ejecución

La cantidad de tiempo 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. Esta métrica es un número entre 0 y 100.

  • Nombre de métrica: ExecutionTime

  • Estadística válida: Average

  • Unidad: Percent