Visualizza CloudFront e modifica le metriche delle funzioni - Amazon CloudFront

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

Visualizza CloudFront e modifica le metriche delle funzioni

È possibile visualizzare le metriche operative relative alle CloudFront distribuzioni e alle funzioni edge nella console. CloudFront

Per visualizzare le CloudFront metriche delle funzioni edge in CloudFront
  1. Accedi a AWS Management Console e apri la CloudFront console all'indirizzohttps://console.aws.amazon.com/cloudfront/v4/home.

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

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

  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 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 frequenza di aggiornamento predefinita è di 1 minuto, ma puoi scegliere altre opzioni.

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

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

Byte caricati

Il numero totale di byte caricati CloudFront, utilizzati OPTIONS e richiesti dagli spettatori. POST 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 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.

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 .

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 AWS CloudFormation, con AWS Command Line Interface (AWS CLI) o con l'API. CloudFront

Console
Per attivare metriche aggiuntive
  1. Accedi a AWS Management Console e apri la CloudFront console all'indirizzohttps://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, usa il tipo di AWS::CloudFront::MonitoringSubscription risorsa. L'esempio seguente mostra la sintassi del AWS 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:

Per 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}
Per vedere se le metriche aggiuntive sono attivate 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
Per 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 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. CloudWatch Quando recuperi le metriche con l'API, vengono applicati costi API aggiuntivi. CloudWatch

Metriche predefinite delle funzioni 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.

Le seguenti metriche predefinite sono 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 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:

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 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 è vicino 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%, si consiglia di esaminarla per ridurre i tempi di esecuzione e migliorarne l'utilizzo. Ad esempio, potresti voler registrare solo gli errori, semplificare le espressioni regex 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 è stata letta correttamente dall'archivio di valori chiave 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 chiave entro un determinato periodo di tempo.

Tutte queste metriche sono pubblicate CloudWatch nella regione Stati Uniti orientali (Virginia settentrionale) (us-east-1), nel CloudFront namespace. 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 certo periodo di tempo. Ad esempio, se si sceglie più del 70% del tempo disponibile per 15 minuti consecutivi, viene attivato l'allarme. 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, 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. Ottieni metriche utilizzando l'API Amazon CloudWatch