Tipi di metriche per CloudFront

Puoi utilizzare l’API CloudWatch o AWS Command Line Interface (AWS CLI) per ottenere le metriche CloudFront nei programmi o nelle applicazioni create. È possibile utilizzare i dati grezzi per creare dashboard personalizzati, strumenti di avviso e così via.

Per ulteriori informazioni, consulta get-metric-data nel Riferimento ai comandi AWS CLI o l’operazione API GetMetricData nella Documentazione di riferimento delle API di Amazon CloudWatch.

Nota

Per ottenere parametri di CloudFront dall'API CloudWatch, è necessario utilizzare la regione degli Stati Uniti orientali (Virginia settentrionale) (us-east-1). È inoltre necessario conoscere determinati valori e tipi per ogni parametro.

Valori per tutti i parametri CloudFront

I seguenti valori si applicano a tutti i parametri CloudFront:

Namespace

Il valore per Namespace è sempre AWS/CloudFront.

Dimensioni

Ogni metrica CloudFront dispone delle due dimensioni seguenti:

DistributionId

L'ID della distribuzione CloudFront per la quale si desidera ottenere i parametri.

FunctionName

Il nome della funzione (in CloudFront Functions) per la quale si desidera ottenere i parametri.

Questa dimensione si applica solo alle funzioni.

Region

Il valore di Region è sempre Global, perché CloudFront è un servizio globale.

Valori per i parametri di distribuzione CloudFront

Utilizza le informazioni contenute nell'elenco seguente per ottenere dettagli sui parametri di distribuzione specifici di CloudFront dall'API CloudWatch. Alcune di questi parametri sono disponibili solo quando sono stati abilitate parametri aggiuntivi per la distribuzione.

Nota

Per ogni metrica è applicabile una sola statistica, Average o Sum. L'elenco seguente specifica quale statistica è applicabile a tale metrica.

Frequenza di errore 4xx

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 4xx.

• Nome parametro: 4xxErrorRate

• Statistiche valide:: Average

• Unità: Percent

Tasso di errore 401

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 401. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: 401ErrorRate

• Statistiche valide:: Average

• Unità: Percent

Tasso di errore 403

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 403. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: 403ErrorRate

• Statistiche valide:: Average

• Unità: Percent

Tasso di errore 404

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 404. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: 404ErrorRate

• Statistiche valide:: Average

• Unità: Percent

Frequenza di errore 5xx

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 5xx.

• Nome parametro: 5xxErrorRate

• Statistiche valide:: Average

• Unità: Percent

Tasso di errore 502

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 502. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: 502ErrorRate

• Statistiche valide:: Average

• Unità: Percent

Tasso di errore 503

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 503. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: 503ErrorRate

• Statistiche valide:: Average

• Unità: Percent

Tasso di errore 504

Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è 504. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: 504ErrorRate

• Statistiche valide:: Average

• Unità: Percent

Byte scaricati

Il numero totale di byte scaricati dai visualizzatori per le richieste GET e HEAD.

• Nome parametro: BytesDownloaded

• Statistiche valide:: Sum

• Unità: None

Byte caricati

Il numero totale di byte caricati dai visualizzatori in CloudFront, tramite le richieste OPTIONS, POST e PUT.

• Nome parametro: BytesUploaded

• Statistiche valide:: Sum

• Unità: None

Percentuale di riscontri nella cache

La percentuale di richieste che possono essere memorizzate nella cache per le quali CloudFront ha fornito il contenuto dalla propria cache. Le richieste HTTP POST e PUT e gli errori non sono considerati memorizzabili nella cache. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: CacheHitRate

• Statistiche valide:: Average

• Unità: Percent

Latenza di origine

Il tempo totale trascorso, in millisecondi, da quando CloudFront riceve una richiesta a quando inizia a fornire una risposta alla rete (non al visualizzatore), per le richieste che vengono servite dall'origine, non dalla cache CloudFront. Questo è anche noto come latenza di primo byte, o time-to-first-byte. Per ottenere questo parametro, è necessario attivare ulteriori parametri.

• Nome parametro: OriginLatency

• Statistiche valide:: Percentile

• Unità: Milliseconds

Nota

Per ottenere una statistica Percentile dall'API CloudWatch, utilizzare il parametro ExtendedStatistics, non Statistics. Per ulteriori informazioni, consulta GetMetricStatistics nella Documentazione di riferimento delle API di Amazon CloudWatch o la documentazione di riferimento per gli SDK di AWS.

Richieste

Il numero totale di richieste di visualizzatore ricevute da CloudFront, per tutti i metodi HTTP e per le richieste HTTP e HTTPS.

• Nome parametro: Requests

• Statistiche valide:: Sum

• Unità: None

Frequenza di errore totale

Percentuale di tutte le richieste del visualizzatore per le quali il codice di stato HTTP della risposta è 4xx o 5xx.

• Nome parametro: TotalErrorRate

• Statistiche valide:: Average

• Unità: Percent

Valori per i parametri delle funzioni CloudFront

Utilizza le informazioni contenute nell'elenco seguente per ottenere dettagli sui parametri CloudFront specifici dall'API CloudWatch.

Nota

Per ogni metrica è applicabile una sola statistica, Average o Sum. L'elenco seguente specifica quale statistica è applicabile a tale metrica.

Invocazioni

Il numero di volte in cui la funzione è stata avviata (richiamata) in un determinato periodo di tempo.

• Nome parametro: FunctionInvocations

• Statistiche valide:: Sum

• Unità: None

Errori di convalida

Il numero di errori di convalida prodotti dalla funzione in un determinato periodo di tempo. Gli errori di convalida si verificano quando la funzione viene eseguita correttamente ma restituisce dati non validi (un oggetto evento non valido).

• Nome parametro: FunctionValidationErrors

• Statistiche valide:: Sum

• Unità: None

Errori di esecuzione

Il numero di errori di esecuzione che si sono verificati in un determinato periodo di tempo. Gli errori di esecuzione si verificano quando la funzione non viene completata correttamente.

• Nome parametro: FunctionExecutionErrors

• Statistiche valide:: Sum

• Unità: None

Utilizzo di calcolo

La quantità di tempo (0-100) impiegata dalla funzione per l'esecuzione come percentuale del tempo massimo consentito. Ad esempio, un valore pari a 35 significa che la funzione è stata completata nel 35% del tempo massimo consentito.

• Nome parametro: FunctionComputeUtilization

• Statistiche valide:: Average

• Unità: Percent

Throttle

Il numero di volte in cui la funzione è stata limitata in un determinato periodo di tempo.

• Nome parametro: FunctionThrottles

• Statistiche valide:: Sum

• Unità: None