Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Monitora le CloudFront metriche con Amazon CloudWatch
Amazon CloudFront è integrato con Amazon CloudWatch e pubblica automaticamente i parametri operativi per le distribuzioni e le funzioni edge (sia [Lambda](edge-functions.md) @Edge che Functions). CloudFront Puoi usare queste metriche per risolvere, tenere traccia ed eseguire il debug dei problemi. Molte di queste metriche vengono visualizzate in un set di grafici nella CloudFront console e sono accessibili anche tramite l' CloudFront API o la CLI. Tutte queste metriche sono disponibili nella [CloudWatch console](https://console.aws.amazon.com/cloudwatch/home) o tramite l' CloudWatch API o la CLI. CloudFront le metriche non vengono conteggiate ai fini delle [CloudWatch quote (precedentemente note come limiti)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) e non comportano costi aggiuntivi.
Oltre alle metriche predefinite per le CloudFront distribuzioni, puoi attivare metriche aggiuntive a un costo aggiuntivo. Le metriche aggiuntive si applicano alle CloudFront distribuzioni e devono essere attivate separatamente per ciascuna distribuzione. Per ulteriori informazioni sui costi, consulta [Stima il costo delle metriche aggiuntive CloudFront](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional-pricing).
Puoi anche impostare allarmi in base a queste metriche nella console o nella CloudFront console, nell' CloudWatchAPI o nella CLI. Ad esempio, è possibile impostare un allarme in base al parametro `5xxErrorRate`, che rappresenta la percentuale di tutte le richieste del visualizzatore per le quali il codice di stato HTTP della risposta è compreso nell'intervallo da `500` a `599`. Quando il tasso di errore raggiunge un determinato valore per un determinato periodo di tempo, ad esempio il 5% delle richieste per 5 minuti continui, l'allarme viene attivato. Quando si crea l'allarme, è possibile specificare il valore dell'allarme e la relativa unità di tempo.
**Note**
Quando crei un CloudWatch allarme nella CloudFront console, ne crea uno per te nella regione Stati Uniti orientali (Virginia settentrionale) (). `us-east-1` Se crei un allarme dalla CloudWatch console, devi usare la stessa regione. Poiché CloudFront si tratta di un servizio globale, le metriche relative al servizio vengono inviate agli Stati Uniti orientali (Virginia settentrionale).
Quando si creano allarmi, si applicano i prezzi [standard CloudWatch ](https://aws.amazon.com/cloudwatch/pricing/).
**Topics**
+ [Visualizza CloudFront e modifica le metriche delle funzioni](viewing-cloudfront-metrics.md)
+ [Creazione di allarmi per i parametri di](receiving-notifications.md)
+ [Download di dati sulle metriche in formato CSV](cloudwatch-csv.md)
+ [Tipi di metriche per CloudFront](programming-cloudwatch-metrics.md)
# Visualizza CloudFront e modifica le metriche delle funzioni
È possibile visualizzare le metriche operative relative alle CloudFront distribuzioni e alle funzioni [edge](https://aws.amazon.com/cloudfront/features/#Edge_Computing) nella console. CloudFront
**Per visualizzare le CloudFront metriche delle funzioni edge in CloudFront**
1. Accedi a Console di gestione AWS e apri la CloudFront console all'indirizzo[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Nel riquadro di navigazione, scegli **Monitoring (Monitoraggio)**.
1. Per visualizzare i grafici sull'attività per una specifica funzione di CloudFront distribuzione o periferica, scegline una, quindi scegli **Visualizza metriche di distribuzione o **Visualizza** metriche**.
1. Puoi personalizzare i grafici nel modo seguente:
1. Per modificare l'intervallo di tempo per le informazioni visualizzate nel grafico, scegliere 1h (1 ora), 3h (3 ore) o a un altro intervallo, oppure specificare un intervallo personalizzato.
1. Per modificare la frequenza di CloudFront aggiornamento delle informazioni nel grafico, scegliete la freccia rivolta verso il basso accanto all'icona di aggiornamento, quindi scegliete una frequenza di aggiornamento. La velocità di aggiornamento predefinita è di 1 minuto, ma è possibile scegliere altre opzioni.
1. Per visualizzare CloudFront i grafici nella CloudWatch console, scegli **Aggiungi** alla dashboard. È necessario utilizzare la regione Stati Uniti orientali (Virginia settentrionale) per visualizzare i grafici nella console. CloudWatch
**Topics**
+ [Metriche di distribuzione predefinite CloudFront](#monitoring-console.distributions)
+ [Attiva metriche di distribuzione aggiuntive CloudFront](#monitoring-console.distributions-additional)
+ [Metriche predefinite della funzione Lambda@Edge](#monitoring-console.lambda-at-edge)
+ [Metriche delle funzioni predefinite CloudFront](#monitoring-console.cloudfront-functions)
## Metriche di distribuzione predefinite CloudFront
Le seguenti metriche predefinite sono incluse per tutte le CloudFront distribuzioni, senza costi aggiuntivi:
**Richieste**
Il numero totale di richieste di visualizzatori ricevute da CloudFront, per tutti i metodi HTTP e per entrambe le richieste HTTP e HTTPS.
**Byte scaricati**
Il numero totale di byte scaricati dai visualizzatori per le richieste `GET` e `HEAD`.
**Byte caricati**
Il numero totale di byte caricati CloudFront`OPTIONS`, utilizzati `POST` e `PUT` richiesti dagli spettatori.
**Frequenza di errore 4xx**
Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è `4xx`.
**Frequenza di errore 5xx**
Percentuale di tutte le richieste del visualizzatore per le quali è il codice di stato HTTP della risposta è `5xx`.
**Frequenza di errore totale**
Percentuale di tutte le richieste del visualizzatore per le quali il codice di stato HTTP della risposta è `4xx` o `5xx`.
Queste metriche sono mostrate nei grafici per ogni CloudFront distribuzione nella pagina **Monitoraggio della console**. CloudFront Su ogni grafico, i totali vengono visualizzati con granularità di 1 minuto. Oltre a visualizzare i grafici, è anche possibile [scaricare i report delle metriche come file CSV](cloudwatch-csv.md).
## Attiva metriche di distribuzione aggiuntive CloudFront
Oltre ai parametri predefiniti, è possibile attivare ulteriori parametri a un costo aggiuntivo. Per ulteriori informazioni sui costi, consulta [Stima il costo delle metriche aggiuntive CloudFront](#monitoring-console.distributions-additional-pricing).
Tali parametri aggiuntivi devono essere attivati separatamente per ogni distribuzione:
**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.
**Latenza di origine**
Il tempo totale impiegato 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 CloudFront cache. Questa condizione è nota anche come *latenza del primo byte*, o. *time-to-first-byte*
**Tasso di errore per codice di stato**
La percentuale di tutte le richieste del visualizzatore per le quali il codice di stato HTTP della risposta è un codice particolare nell'intervallo `4xx` o `5xx`. Questa metrica è disponibile per tutti i seguenti codici di errore: `401`, `403`, `404`, `502`, `503` e `504`.
Puoi attivare metriche aggiuntive nella CloudFront console, con CloudFormation, con AWS Command Line Interface (AWS CLI) o con l'API. CloudFront
------
#### [ Console ]
**Come attivare metriche aggiuntive**
1. Accedi Console di gestione AWS e apri la CloudFront console all'indirizzo[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Nel riquadro di navigazione, scegli **Monitoring (Monitoraggio)**.
1. Scegliere la distribuzione per cui attivare ulteriori parametri, quindi scegliere **View distribution metrics** (Visualizza parametri di distribuzione).
1. Scegliere **Manage additional metrics** (Gestisci parametri aggiuntivi).
1. Nella finestra **Manage additional metrics** (Gestisci parametri aggiuntivi), attiva **Enabled** (Abilitato). Dopo aver abilitato i parametri aggiuntivi, puoi chiudere la finestra **Manage additional metrics** (Gestisci parametri aggiuntivi).
Dopo aver abilitato i parametri aggiuntivi, questi vengono visualizzati nei grafici. Su ogni grafico, i totali vengono visualizzati con granularità di 1 minuto. Oltre a visualizzare i grafici, è anche possibile [scaricare i report delle metriche come file CSV](cloudwatch-csv.md).
------
#### [ CloudFormation ]
Per attivare metriche aggiuntive con CloudFormation, usa il tipo di `AWS::CloudFront::MonitoringSubscription` risorsa. L'esempio seguente mostra la sintassi del CloudFormation modello, in formato YAML, per abilitare metriche aggiuntive.
```
Type: AWS::CloudFront::MonitoringSubscription
Properties:
DistributionId: EDFDVBD6EXAMPLE
MonitoringSubscription:
RealtimeMetricsSubscriptionConfig:
RealtimeMetricsSubscriptionStatus: Enabled
```
------
#### [ CLI ]
Per gestire metriche aggiuntive con AWS Command Line Interface (AWS CLI), utilizzate uno dei seguenti comandi:
**Come attivare metriche aggiuntive per una distribuzione**
+ Utilizza il comando **create-monitoring-subscription** come nell'esempio seguente. Sostituiscilo *EDFDVBD6EXAMPLE* con l'ID della distribuzione per cui stai abilitando le metriche aggiuntive.
```
aws cloudfront create-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE --monitoring-subscription RealtimeMetricsSubscriptionConfig={RealtimeMetricsSubscriptionStatus=Enabled}
```
**Come vedere se sono attivate metriche aggiuntive per una distribuzione**
+ Utilizza il comando **get-monitoring-subscription** come nell'esempio seguente. Sostituiscilo *EDFDVBD6EXAMPLE* con l'ID della distribuzione che stai controllando.
```
aws cloudfront get-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
```
**Come disattivare metriche aggiuntive per una distribuzione**
+ Utilizza il comando **delete-monitoring-subscription** come nell'esempio seguente. Sostituiscilo *EDFDVBD6EXAMPLE* con l'ID della distribuzione per cui stai disattivando le metriche aggiuntive.
```
aws cloudfront delete-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
```
------
#### [ API ]
Per gestire metriche aggiuntive con l' CloudFront API, utilizza una delle seguenti operazioni API.
+ Per attivare metriche aggiuntive per una distribuzione, usa. [CreateMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateMonitoringSubscription.html)
+ Per vedere se le metriche aggiuntive sono attivate per una distribuzione, usa. [GetMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetMonitoringSubscription.html)
+ Per disattivare metriche aggiuntive per una distribuzione, usa. [DeleteMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteMonitoringSubscription.html)
Per ulteriori informazioni su queste operazioni API, consulta la documentazione di riferimento sull'API per il tuo AWS SDK o altro client API.
------
### Stima il costo delle metriche aggiuntive CloudFront
Quando attivi metriche aggiuntive per una distribuzione, CloudFront invia fino a 8 metriche CloudWatch nella regione Stati Uniti orientali (Virginia settentrionale). CloudWatch applica una tariffa fissa bassa per ogni metrica. Questa tariffa viene addebitata una sola volta al mese per parametro (fino a otto parametri per distribuzione). Si tratta di una tariffa fissa, quindi il costo rimane invariato indipendentemente dal numero di richieste o risposte ricevute o inviate dalla CloudFront distribuzione. [Per la tariffa metrica, consulta la [pagina CloudWatch dei prezzi di Amazon e il calcolatore dei prezzi](https://aws.amazon.com/cloudwatch/pricing/). CloudWatch](https://aws.amazon.com/cloudwatch/pricing/#Pricing_calculator) Quando recuperi le metriche con l'API, vengono applicati costi API aggiuntivi. CloudWatch
## Metriche predefinite della funzione Lambda@Edge
Puoi utilizzare le CloudWatch metriche per monitorare, in tempo reale, i problemi con le funzioni Lambda @Edge. Non sono previsti costi aggiuntivi per l'utilizzo di questi parametri.
Quando colleghi una funzione Lambda @Edge a un comportamento della cache in una CloudFront distribuzione, Lambda inizia a inviare automaticamente le metriche a. CloudWatch Le metriche sono disponibili per tutte le regioni Lambda, ma per visualizzare le metriche nella CloudWatch console o ottenere i dati delle metriche dall'API, devi utilizzare CloudWatch la regione Stati Uniti orientali (Virginia settentrionale) (). `us-east-1` Il nome del gruppo di metriche è formattato come:`AWS/CloudFront/distribution-ID`, dove *distribution-ID* è l'ID della CloudFront distribuzione a cui è associata la funzione Lambda @Edge. Per ulteriori informazioni sui CloudWatch parametri, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
Le seguenti metriche predefinite sono mostrate nei grafici per ogni funzione Lambda @Edge nella pagina **Monitoraggio della console**: CloudFront
+ `5xx`Frequenza di errore per Lambda@Edge
+ Errori di esecuzione Lambda
+ Risposte non valide Lambda
+ Throttle Lambda
I grafici includono il numero di chiamate, errori, throttle e così via. Su ogni grafico, i totali vengono visualizzati con granularità di 1 minuto, raggruppati in base alla regione AWS .
Se si verifica un picco di errori da analizzare, è possibile scegliere una funzione e quindi visualizzare i file di registro per AWS regione, fino a determinare quale funzione causa i problemi e in quale regione. AWS Per ulteriori informazioni sulla risoluzione di errori Lambda@Edge, consulta:
+ [Come stabilire il tipo di errore](lambda-edge-testing-debugging.md#lambda-edge-testing-debugging-failure-type)
+ [Quattro passaggi per eseguire il debug della distribuzione dei contenuti su AWS](https://aws.amazon.com/blogs/networking-and-content-delivery/four-steps-for-debugging-your-content-delivery-on-aws/)
## Metriche delle funzioni predefinite CloudFront
CloudFront Functions invia metriche operative ad Amazon CloudWatch in modo che tu possa monitorare le tue funzioni. La visualizzazione di queste metriche consente di risolvere, tenere traccia ed eseguire il debug dei problemi. CloudFront Functions pubblica le seguenti metriche su: CloudWatch
+ **Richiami** (`FunctionInvocations`): il numero di volte in cui la funzione è stata avviata (richiamata) in un determinato periodo di tempo.
+ **Errori di convalida** (`FunctionValidationErrors`): 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](functions-event-structure.md) non valido).
+ **Errori di esecuzione** (`FunctionExecutionErrors`): 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.
+ **Utilizzo del calcolo** (`FunctionComputeUtilization`): la quantità di tempo impiegata per l'esecuzione della funzione 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. Questo parametro è un numero compreso tra 0 e 100.
Se questo valore raggiunge o si avvicina a 100, la funzione ha utilizzato o sta per utilizzare il tempo di esecuzione consentito e le richieste successive potrebbero essere limitate. Se la funzione è in esecuzione con un utilizzo pari o superiore all’80%, ti consigliamo di rivedere la funzione per ridurre il tempo di esecuzione e migliorare l’utilizzo. Ad esempio, potrebbe essere necessario registrare solo gli errori, semplificare eventuali espressioni regolari complesse o rimuovere l’analisi non necessaria di oggetti JSON complessi.
+ **Throttle** (`FunctionThrottles`): il numero di volte in cui la funzione è stata limitata in un determinato periodo di tempo. Le funzioni possono essere limitate per i seguenti motivi:
+ La funzione supera continuamente il tempo massimo consentito per l'esecuzione
+ La funzione provoca errori di compilazione
+ Il numero di richieste al secondo è insolitamente elevato
CloudFront KeyValueStore invia anche le seguenti metriche operative ad Amazon CloudWatch:
+ **Richieste di lettura** (`KvsReadRequests`): il numero di volte in cui la funzione ha letto correttamente dall’archivio di valori delle chiavi in un determinato periodo di tempo.
+ **Errori di lettura** (`KvsReadErrors`): Il numero di volte in cui la funzione non è riuscita a leggere dall’archivio di valori delle chiavi entro un determinato periodo di tempo.
Tutte queste metriche vengono pubblicate CloudWatch nella regione Stati Uniti orientali (Virginia settentrionale) (`us-east-1`), nel namespace. CloudFront Puoi anche visualizzare queste metriche nella console. CloudWatch Nella CloudWatch console, puoi visualizzare le metriche per funzione o per funzione per distribuzione.
Puoi anche utilizzare CloudWatch per impostare allarmi in base a queste metriche. Ad esempio, puoi impostare un avviso in base al parametro del tempo di esecuzione (`FunctionComputeUtilization`), che rappresenta la percentuale di tempo disponibile impiegato dalla funzione per l'esecuzione. Quando il tempo di esecuzione raggiunge un determinato valore per un periodo di tempo specifico. Ad esempio, se si sceglie un valore superiore al 70% del tempo disponibile per 15 minuti consecutivi, l’allarme viene attivato. Quando si crea l'allarme, è possibile specificare il valore dell'allarme e la relativa unità di tempo.
**Nota**
CloudFront Functions invia le metriche CloudWatch solo per le funzioni nella `LIVE` fase che vengono eseguite in risposta alle richieste e alle risposte di produzione. Quando [testate una funzione](test-function.md), CloudFront non invia alcuna metrica a. CloudWatch L'output del test contiene informazioni sugli errori, sull'utilizzo del calcolo e sui registri delle funzioni (`console.log()`istruzioni), ma queste informazioni non vengono inviate a. CloudWatch
Per informazioni su come ottenere queste metriche con l' CloudWatch API, consulta. [Tipi di metriche per CloudFront](programming-cloudwatch-metrics.md)
# Creazione di allarmi per i parametri di
Nella CloudFront console, puoi impostare allarmi per ricevere notifiche tramite Amazon Simple Notification Service (Amazon SNS) in base a parametri specifici. CloudFront
**Come creare allarmi per le metriche**
1. Accedi a Console di gestione AWS e apri la console all' CloudFront indirizzo. [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)
1. Nel pannello di navigazione, seleziona **Alarms** (Allarmi).
1. Selezionare **Create Alarm (Crea allarme)**.
1. Per **Dettagli**, specifica quanto segue:
1. **Nome allarme**: un nome per l’allarme.
1. **Distribuzione**: la CloudFront distribuzione per cui stai creando l'allarme.
1. Per **Condizione**, specifica quanto segue:
1. **Metrica**: la metrica per cui stai creando l’allarme.
1. **«IF»**: la soglia in cui CloudWatch deve attivare un allarme e inviare una notifica all'argomento Amazon SNS. Ad esempio, per ricevere una notifica quando il tasso di errore `5xx` supera l'1%, specificare quanto segue:
**Tasso di errore 5xx** **> 1**
1. **“FOR” periodi consecutivi**: periodo di tempo durante il quale la condizione deve essere soddisfatta prima che venga attivato un allarme. Quando si sceglie un valore, puntare a un giusto equilibrio tra un valore che non attivi allarmi per problemi temporanei, ma attivi allarmi per problemi persistenti o reali.
1. (Facoltativo) **Notifica**: l’argomento Amazon SNS a cui inviare una notifica se questa metrica attiva un allarme.
1. Scegli **Crea allarme**.
**Note**
Quando inserisci i valori per la condizione, usa numeri interi senza punteggiatura. Ad esempio, per specificare mille, immetti **1000**.
Per i tassi di errore `4xx`, `5xx` e totali, il valore che specifichi è una percentuale.
Per le richieste, i byte scaricati e i byte caricati, il valore specificato è unità. Ad esempio, 1073742000 byte.
Per ulteriori informazioni sulla creazione di argomenti Amazon SNS, consulta [Creazione di un argomento Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*.
# Download di dati sulle metriche in formato CSV
Puoi scaricare i dati delle CloudWatch metriche per una CloudFront distribuzione in formato CSV.
**Come eseguire il download di dati sulle metriche in formato CSV**
1. Accedi Console di gestione AWS e apri la CloudFront console all'indirizzo. [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)
1. Nel riquadro di navigazione, scegli **Monitoring (Monitoraggio)**.
1. Scegli la distribuzione, quindi seleziona **Visualizza metriche di distribuzione**.
1. Scegli **Scarica CSV**, quindi seleziona il periodo di tempo (ad esempio, **Nell’ultimo giorno (periodo di 1 ora)**.
1. Dopo aver scaricato il file, aprilo per visualizzare le seguenti informazioni.
**Topics**
+ [Informazioni sul report](#cloudwatch-csv-header)
+ [Dati nel report dei parametri](#cloudwatch-csv-data)
## Informazioni sul report
Le prime righe del report includono le seguenti informazioni:
**Versione**
La versione CloudFront di segnalazione.
**Report**
Il nome del report.
**DistributionID**
L'ID della distribuzione per cui è stato eseguito il report.
**StartDateUTC**
La data d'inizio dell'intervallo di date per il quale esegui il report, in formato UTC.
**EndDateUTC**
La data di fine dell'intervallo di date per il quale esegui il report, in formato UTC.
**GeneratedTimeUTC**
La data e l'ora alla quale hai eseguito il report, in formato UTC.
**Granularità**
Il periodo di tempo per ogni riga nel report, ad esempio, `ONE_MINUTE`.
## Dati nel report dei parametri
Il report include i seguenti valori:
**DistributionID**
L'ID della distribuzione per cui è stato eseguito il report.
**FriendlyName**
L'eventuale nome di dominio alternativo (CNAME) per la distribuzione. Se una distribuzione non ha nomi di dominio alternativi, l'elenco include un nome di dominio di origine per la distribuzione.
**TimeBucket**
L'ora o il giorno a cui si riferiscono i dati, in formato UTC.
**Richieste**
Il numero totale di richieste per tutti i codici di stato HTTP (ad esempio, `200`, `404` e così via) e tutti i metodi (ad esempio, `GET`, `HEAD`, `POST` e così via) durante il periodo di tempo.
**BytesDownloaded**
Il numero di byte che i visualizzatori hanno scaricato per la distribuzione specificata durante il periodo di tempo.
**BytesUploaded**
Il numero di byte che i visualizzatori hanno caricato per la distribuzione specificata durante l'intervallo temporale.
**TotalErrorRatePct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `4xx` o `5xx` per la distribuzione specificata durante l'intervallo temporale.
**4 ottobre xxErrorRate**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `4xx` per la distribuzione specificata durante l'intervallo temporale.
**5 xxErrorRate Pct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `5xx` per la distribuzione specificata durante l'intervallo temporale.
Se sono stati [attivati parametri aggiuntivi](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional) per la distribuzione, il report include anche i seguenti valori aggiuntivi:
**401 ErrorRatePct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `401` per la distribuzione specificata durante l'intervallo temporale.
**403 ErrorRatePct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `403` per la distribuzione specificata durante l'intervallo temporale.
**404 ErrorRatePct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `404` per la distribuzione specificata durante l'intervallo temporale.
**502 ErrorRatePct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `502` per la distribuzione specificata durante l'intervallo temporale.
**503 ErrorRatePct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `503` per la distribuzione specificata durante l'intervallo temporale.
**504 ErrorRatePct**
La percentuale di richieste per le quali il codice di stato HTTP era un errore `504` per la distribuzione specificata durante l'intervallo temporale.
**OriginLatency**
Il tempo totale impiegato, in millisecondi, da quando CloudFront ha ricevuto una richiesta a quando ha iniziato a fornire una risposta alla rete (non al visualizzatore), per le richieste che sono state servite dall'origine, non dalla cache. CloudFront Questa è anche nota come latenza del *primo byte*, o. *time-to-first-byte*
**CacheHitRate**
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.
# Tipi di metriche per CloudFront
Puoi usare l' CloudWatch API o AWS Command Line Interface (AWS CLI) per ottenere le CloudFront metriche 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 CLI](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html)*Command Reference* o il funzionamento dell'[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API in *Amazon CloudWatch API Reference*.
**Topics**
+ [Valori per tutte le metriche CloudFront](#cloudfront-metrics-global-values)
+ [Valori per le metriche CloudFront di distribuzione](#cloudfront-metrics-distribution-values)
+ [Valori per le metriche CloudFront delle funzioni](#cloudfront-metrics-function-values)
**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 per tutte le metriche 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 seguenti dimensioni:
**`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` è sempre`Global`, 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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 CloudFront`OPTIONS`, `POST` utilizzati e richiesti dagli spettatori. `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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nome parametro: `OriginLatency`
+ Statistiche valide:: `Percentile`
+ Unità: `Milliseconds`
Per ottenere una `Percentile` statistica dall' CloudWatch API, usa il `ExtendedStatistics` parametro, not. `Statistics` Per ulteriori informazioni, [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)consulta *Amazon CloudWatch API Reference* o la documentazione di riferimento per [AWS SDKs](https://docs.aws.amazon.com/#sdks).
**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 indica 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`