Ottieni metriche utilizzando l'API Amazon CloudWatch

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

Per ulteriori informazioni, consulta get-metric-data AWS CLICommand Reference o il funzionamento dell'GetMetricDataAPI in Amazon CloudWatch API Reference.

Nota

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

Valori di tutti i parametri CloudFront

I seguenti valori si applicano a tutte le CloudFront metriche:

Namespace

Il valore per Namespace è sempre AWS/CloudFront.

Dimensioni

Ogni CloudFront metrica ha le due dimensioni seguenti:

DistributionId

L'ID della CloudFront distribuzione per la quale desideri ottenere le metriche.

FunctionName

Il nome della funzione (in CloudFront Funzioni) per la quale desideri ottenere le metriche.

Questa dimensione si applica solo alle funzioni.

Region

Il valore per Region è sempreGlobal, perché CloudFront è un servizio globale.

Valori per le metriche CloudFront di distribuzione

Utilizza le informazioni del seguente elenco per ottenere dettagli su metriche di CloudFront distribuzione specifiche dall' CloudWatch API. 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 di byte scaricati dai visualizzatori per le richieste GET, HEAD e OPTIONS.

• Nome parametro: BytesDownloaded

• Statistiche valide:: Sum

• Unità: None

Byte caricati

Il numero totale di byte con cui gli spettatori hanno caricatoCloudFront, utilizzato POST e richiesto sulla tua pagina di origine. PUT

• Nome parametro: BytesUploaded

• Statistiche valide:: Sum

• Unità: None

Percentuale di riscontri nella cache

La percentuale di tutte le richieste memorizzabili nella cache per le quali è CloudFront stato fornito il contenuto della 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 impiegato, 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 Questa è anche nota come latenza del 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 Percentile statistica dall' CloudWatch API, usa il ExtendedStatistics parametro, not. Statistics Per ulteriori informazioni, GetMetricStatisticsconsulta Amazon CloudWatch API Reference o la documentazione di riferimento per gli AWS SDK.

Richieste

Il numero totale di richieste di visualizzatori ricevute da CloudFront, per tutti i metodi HTTP e per entrambe 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 le metriche CloudFront delle funzioni

Utilizza le informazioni del seguente elenco per ottenere dettagli sulle metriche di CloudFront funzioni specifiche dall' CloudWatch API.

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

Throttles

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

• Nome parametro: FunctionThrottles

• Statistiche valide:: Sum

• Unità: None