Dimensioni e parametri di Amazon API Gateway - Amazon API Gateway

Dimensioni e parametri di Amazon API Gateway

I parametri e le dimensioni che API Gateway invia ad Amazon CloudWatch sono elencate di seguito. Per ulteriori informazioni, consulta Monitoraggio dell'esecuzione della REST API con le metriche Amazon CloudWatch.

Parametri di API Gateway

Amazon API Gateway invia dati dei parametri a CloudWatch ogni minuto.

Il namespace AWS/ApiGateway include le metriche descritte di seguito.

Metrica Descrizione

4XXError

Il numero di errori lato client catturati in un dato periodo.

Gateway API considera i codici di stato di risposta del gateway modificati come errori 4XXError.

La statistica Sum rappresenta questo parametro, ovvero il numero totale di errori 4XXError nel dato periodo. La statistica Average rappresenta la percentuale di errori 4XXError nel dato periodo, ovvero il numero totale di errori 4XXError diviso per il numero totale di richieste durante il periodo. Il denominatore corrisponde al parametro Count (di seguito).

Unit: Count

5XXError

Il numero di errori lato server catturati in un dato periodo.

La statistica Sum rappresenta questo parametro, ovvero il numero totale di errori 5XXError nel dato periodo. La statistica Average rappresenta la percentuale di errori 5XXError nel dato periodo, ovvero il numero totale di errori 5XXError diviso per il numero totale di richieste durante il periodo. Il denominatore corrisponde al parametro Count (di seguito).

Unit: Count

CacheHitCount

Il numero di richieste servite dalla cache API in un dato periodo.

La statistica Sum rappresenta questo parametro, ovvero il numero totale di riscontri nella cache nel dato periodo. La statistica Average rappresenta la percentuale di riscontri nella cache, ovvero il numero totale di riscontri nella cache diviso per il numero totale di richieste durante il periodo. Il denominatore corrisponde al parametro Count (di seguito).

Unit: Count

CacheMissCount

Il numero di richieste servite dal back-end in un dato periodo, quando la memorizzazione nella cache delle API è abilitata.

La statistica Sum rappresenta questo parametro, ovvero il numero totale di mancati riscontri nella cache nel dato periodo. La statistica Average rappresenta la percentuale di mancati riscontri nella cache, ovvero il numero totale di mancati riscontri nella cache diviso per il numero totale di richieste durante il periodo. Il denominatore corrisponde al parametro Count (di seguito).

Unit: Count

Count

Il numero totale di richieste API in un dato periodo.

La statistica SampleCount rappresenta questo parametro.

Unit: Count

IntegrationLatency

Il tempo che intercorre tra il momento in cui API Gateway ritrasmette una richiesta al back-end e quando riceve da questo una risposta.

Unit: Millisecond

Latency

Il tempo che intercorre tra il momento in cui API Gateway riceve una richiesta dal client e quando restituisce ad esso una risposta. La latenza include la latenza di integrazione e altri sovraccarichi dell'API Gateway.

Unit: Millisecond

Dimensioni per i parametri

Per filtrare i parametri di API Gateway, puoi utilizzare le dimensioni nella seguente tabella.

Nota

API Gateway rimuove i caratteri non ASCII dalla dimensione ApiName prima di inviare i parametri a CloudWatch. Se APIName non contiene caratteri ASCII, API ID viene utilizzato come ApiName.

Dimensione Descrizione

ApiName

Filtra i parametri dell'API Gateway per l’API REST con il nome API specificato.

ApiName, Method, Resource, Stage

Filtra i parametri dell'API Gateway per il metodo API con nome API, fase, risorsa e metodo specificati.

API Gateway non invia questi parametri a meno che non siano stati abilitati esplicitamente parametri CloudWatch dettagliati. Nella console, scegli una fase, quindi seleziona Modifica per Log e tracciamento. Seleziona Parametri dettagliati, quindi scegli Salva modifiche. In alternativa, puoi chiamare il comando update-stage della AWS CLI per aggiornare la proprietà metricsEnabled a true.

L'abilitazione di questi parametri comporta addebiti aggiuntivi sul tuo account. Per informazioni sui prezzi, consulta la pagina Prezzi di Amazon CloudWatch.

ApiName, Stage

Filtra i parametri di API Gateway per la risorsa della fase API con il nome e la fase specificati per l'API.