Visualizzazione delle metriche delle funzioni di CloudFront ed edge - Amazon CloudFront
Metriche di distribuzione predefinite di CloudFrontAttivazione di ulteriori metriche di distribuzione CloudFrontMetriche predefinite della funzione Lambda@EdgeMetriche predefinite di Funzioni CloudFront

Visualizzazione delle metriche delle funzioni di CloudFront ed edge

È possibile visualizzare i parametri operativi relativi alle distribuzioni CloudFront e alle funzioni edge nella console CloudFront.

Come visualizzare le metriche delle funzioni CloudFront ed edge in CloudFront

  1. Accedi alla Console di gestione AWS e apri la console CloudFront all'indirizzo https://console.aws.amazon.com/cloudfront/v4/home.

  2. Nel riquadro di navigazione, scegli Monitoring (Monitoraggio).

  3. Per visualizzare i grafici relativi all'attività per una distribuzione CloudFront o una funzione edge, sceglierne una, quindi scegliere View distribution metrics (Visualizza parametri di distribuzione) oppure View metrics (Visualizza parametri).

  4. 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.

    2. Per modificare la frequenza con cui CloudFront aggiorna le informazioni contenute nel grafico, scegliere la freccia giù accanto all'icona di aggiornamento, quindi selezionare un intervallo di aggiornamento. La velocità di aggiornamento predefinita è di 1 minuto, ma è possibile scegliere altre opzioni.

  5. Per visualizzare i grafici CloudFront nella console CloudWatch, scegliere Aggiungi al dashboard. È necessario utilizzare la Regione Stati Uniti orientali (Virginia Settentrionale) per visualizzare i grafici nella console CloudWatch.

Metriche di distribuzione predefinite di CloudFront

I seguenti parametri predefiniti sono inclusi per tutte le distribuzioni CloudFront, senza costi aggiuntivi:

Richieste

Il numero totale di richieste di visualizzatore ricevute da CloudFront, per tutti i metodi HTTP e per 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 dai visualizzatori in CloudFront, tramite le richieste OPTIONS, POST e PUT.

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 distribuzione CloudFront 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.

Attivazione di ulteriori metriche di distribuzione CloudFront

Oltre ai parametri predefiniti, è possibile attivare ulteriori parametri a un costo aggiuntivo. Per ulteriori informazioni sui costi, consulta Stima dei costi per le metriche aggiuntive di CloudFront.

Tali parametri aggiuntivi devono essere attivati separatamente per ogni distribuzione:

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.

Latenza di origine

Il tempo totale trascorso 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.

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.

È possibile attivare parametri aggiuntivi nella console CloudFront, con CloudFormation, con l'AWS Command Line Interface (AWS CLI) o con l'API CloudFront.

Console
Come attivare metriche aggiuntive

  1. Accedi alla Console di gestione AWS e apri la console CloudFront all'indirizzo https://console.aws.amazon.com/cloudfront/v4/home.

  2. Nel riquadro di navigazione, scegli Monitoring (Monitoraggio).

  3. Scegliere la distribuzione per cui attivare ulteriori parametri, quindi scegliere View distribution metrics (Visualizza parametri di distribuzione).

  4. Scegliere Manage additional metrics (Gestisci parametri aggiuntivi).

  5. 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.

CloudFormation

Per attivare metriche aggiuntive con CloudFormation, utilizza il tipo di risorsa AWS::CloudFront::MonitoringSubscription. L'esempio seguente mostra la sintassi del modello CloudFormation, in formato YAML, per l'abilitazione di parametri aggiuntivi.

Type: AWS::CloudFront::MonitoringSubscription
Properties: 
  DistributionId: EDFDVBD6EXAMPLE
  MonitoringSubscription:
    RealtimeMetricsSubscriptionConfig:
      RealtimeMetricsSubscriptionStatus: Enabled
CLI

Per gestire parametri aggiuntivi con AWS Command Line Interface (AWS CLI), utilizzare uno dei seguenti comandi:

Come attivare metriche aggiuntive per una distribuzione

  • Utilizza il comando create-monitoring-subscription come nell'esempio seguente. Sostituisci EDFDVBD6EXAMPLE con l’ID della distribuzione per la quale stai abilitando 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. Sostituisci 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. Sostituisci EDFDVBD6EXAMPLE con l’ID della distribuzione per la quale stai disattivando metriche aggiuntive.

    
aws cloudfront delete-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
API

Per gestire metriche aggiuntive con l'API CloudFront, utilizzare una delle seguenti operazioni API.

Per ulteriori informazioni su queste operazioni API, consulta la documentazione di riferimento delle API per l’SDK AWS o un altro client API.

Stima dei costi per le metriche aggiuntive di CloudFront

Quando si abilitano parametri aggiuntivi per una distribuzione, CloudFront invia fino a 8 parametri a CloudWatch nella regione Stati Uniti orientali (Virginia settentrionale). CloudWatch addebita 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, pertanto i costi restano invariati indipendentemente dal numero di richieste o risposte che la distribuzione CloudFront riceve o invia. Per la tariffa per parametro, consultare la pagina dei prezzi di Amazon CloudWatch e il calcolatore dei prezzi di CloudWatch. Quando si recuperano i parametri mediante l'API CloudWatch, vengono applicati addebiti aggiuntivi per le API.

Metriche predefinite della funzione Lambda@Edge

È possibile utilizzare i parametri CloudWatch 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 distribuzione CloudFront, Lambda inizia a inviare i parametri a CloudWatch in modo automatico. I parametri sono disponibili per tutte le regioni Lambda, ma per visualizzare le metriche nella console CloudWatch o ottenere i dati delle metriche dall'API CloudWatch, è necessario utilizzare l'area Stati Uniti orientali (Virginia settentrionale) (us-east-1). Il nome del gruppo di parametri ha il seguente formato: AWS/CloudFront/distribution-ID, dove distribution-ID è l'ID della distribuzione CloudFront a cui è associata la funzione Lambda@Edge. Per ulteriori informazioni sulle metriche di CloudWatch, consulta la Guida per l'utente di Amazon CloudWatch.

Queste metriche predefinite vengono mostrate nei grafici per ogni funzione Lambda@Edge nella pagina Monitoraggio della console CloudFront:

  • 5xxFrequenza 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 viene registrato un picco di errori che si desidera analizzare, ad esempio, puoi scegliere una funzione e quindi visualizzare i file di log in base alla regione AWS, finché non determini la funzione che causa i problemi e in quale regione AWS. Per ulteriori informazioni sulla risoluzione di errori Lambda@Edge, consulta:

Metriche predefinite di Funzioni CloudFront

CloudFront Functions invia i parametri operativi 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 i seguenti parametri 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 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

KeyValueStore di CloudFront 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.

Tutti questi parametri vengono pubblicati su CloudWatch nella regione Stati Uniti orientali (Virginia settentrionale) (us-east-1), nello spazio dei nomi CloudFront. Puoi visualizzare tali parametri anche dalla console CloudWatch. Nella console CloudWatch, puoi visualizzare i parametri in base alla funzione o in base alla funzione per distribuzione.

Puoi anche usare CloudWatch per impostare gli allarmi in base ai parametri. 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

Funzioni CloudFront invia parametri a CloudWatch solo per le funzioni che si trovano nella fase LIVE che vengono eseguite in risposta alle richieste di produzione e alle risposte. Durante il test di una funzione, CloudFront non invia alcun parametro a CloudWatch. L’output del test contiene informazioni su errori, utilizzo del calcolo e log delle funzioni (istruzioni console.log()), ma queste informazioni non vengono inviate a CloudWatch.

Per informazioni su come ottenere questi parametri con l'API CloudWatch, consulta Tipi di metriche per CloudFront.