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à.
Tipi di parametri per le funzioni Lambda
Questa sezione descrive i tipi di metriche Lambda disponibili nella console. CloudWatch
Argomenti
Parametri di invocazione
I parametri di invocazione sono indicatori binari del risultato di una chiamata alla funzione Lambda. Visualizza questi parametri con la statistica Sum
. Ad esempio, se la funzione restituisce un errore, Lambda invia il parametro Errors
con un valore pari a 1. Per ottenere un conteggio del numero di errori di funzione che si sono verificati ogni minuto, visualizzare la somma Sum
del parametro Errors
con un periodo di un minuto.
-
Invocations
: il numero di volte in cui viene chiamato il codice di funzione, incluse le chiamate riuscite e le chiamate che determinano un errore di funzione. Le chiamate non vengono registrate se la richiesta di chiamata è limitata o altrimenti viene generato un errore di chiamata. Il valore diInvocations
equivale al numero di richieste fatturate. -
Errors
: il numero di chiamate che provocano un errore di funzione. Gli errori di funzione includono eccezioni generate dal codice e eccezioni generate dal runtime Lambda. Il runtime restituisce errori per problemi quali timeout ed errori di configurazione. Per calcolare la percentuale di errore, dividere il valore diErrors
per il valore diInvocations
. Tieni presente che il timestamp di un parametro di errore riflette quando è stata richiamata la funzione, non quando si è verificato l'errore. -
DeadLetterErrors
: per la chiamata asincrona, il numero di tentativi di invio non riusciti da parte di Lambda di un evento a una coda DLQ. Gli errori DLQ possono verificarsi a causa di risorse configurate erroneamente o limiti di dimensione. -
DestinationDeliveryFailures
: per la chiamata asincrona e per lo strumento di mappatura dell'origine degli eventi supportato, indica il numero di tentativi di invio non riusciti da parte di Lambda di un evento a una destinazione. Per gli strumenti di mappatura dell'origine degli eventi, Lambda supporta destinazioni per le origini di flusso (DynamoDB e Kinesis). Gli errori di recapito possono verificarsi a causa di errori di autorizzazioni, risorse configurate erroneamente o limiti di dimensione. Gli errori possono verificarsi anche se la destinazione che hai configurato è di tipo non supportato, ad esempio una coda FIFO di Amazon SQS o un argomento FIFO di Amazon SNS. -
Throttles
: il numero di richieste di chiamata con throttling. Quando tutte le istanze di funzione elaborano le richieste e non è disponibile alcuna simultaneità per l'aumento, Lambda rifiuta le richieste aggiuntive con un erroreTooManyRequestsException
. Le richieste con limitazione e altri errori di chiamata non contano comeInvocations
oErrors
. -
OversizedRecordCount
: per le origini di eventi di Amazon DocumentDB, il numero di eventi che la funzione riceve dal flusso di modifiche è superiore a 6 MB. Lambda elimina il messaggio ed emette questo parametro. -
ProvisionedConcurrencyInvocations
: il numero di volte in cui il codice di funzione viene richiamato tramite la simultaneità fornita. -
ProvisionedConcurrencySpilloverInvocations
: il numero di volte in cui il codice di funzione viene chiamato tramite la simultaneità standard quando è in uso tutta la simultaneità fornita. -
RecursiveInvocationsDropped
: il numero di volte in cui Lambda ha interrotto l'invocazione della funzione perché ha rilevato che la funzione fa parte di un ciclo ricorsivo infinito. Il rilevamento ricorsivo del loop monitora quante volte una funzione viene richiamata come parte di una catena di richieste tracciando i metadati aggiunti da Supported. AWS SDKs Per impostazione predefinita, se la funzione viene richiamata come parte di una catena di richieste circa 16 volte, Lambda interrompe l'invocazione successiva. Se disabiliti il rilevamento del ciclo ricorsivo, questo parametro non viene emesso. Per ulteriori informazioni sull'utilizzo di questa caratteristica, consulta Usa il rilevamento di un ciclo ricorsivo Lambda per prevenire loop infiniti.
Parametri prestazionali
I parametri delle prestazioni forniscono dettagli delle prestazioni relativi a una singola chiamata della funzione. Ad esempio, il parametro Duration
indica il tempo in millisecondi che la funzione impiega per l'elaborazione di un evento. Per avere un'idea della velocità con cui la funzione elabora gli eventi, visualizzare questi parametri con la statistica Average
o Max
.
-
Duration
– La quantità di tempo che il codice della funzione impiega durante l'elaborazione di un evento. La durata fatturata per una invocazione è il valore diDuration
arrotondato per eccesso al millisecondo più vicino.Duration
non include il tempo di avvio a freddo. -
PostRuntimeExtensionsDuration
– La quantità cumulativa di tempo che il runtime trascorre eseguendo il codice per le estensioni dopo il completamento del codice funzione. -
IteratorAge
: per le origini eventi DynamoDB, Kinesis e Amazon DocumentDB, l'età (in millisecondi) dell'ultimo record dell'evento. Questo parametro misura il tempo che passa tra il momento in cui il flusso riceve il record e il momento in cui lo strumento di mappatura dell'origine degli eventi invia l'evento alla funzione. -
OffsetLag
: per le origini eventi Apache Kafka autogestite e Streaming gestito da Amazon per Apache Kafka (Amazon MSK), la differenza di offset tra l'ultimo record scritto su un argomento e l'ultimo record elaborato dal gruppo di consumer della funzione. Sebbene un argomento di Kafka possa avere più partizioni, questo parametro misura il ritardo di offset a livello di argomento.
Duration
supporta anche le statistiche percentili (p
). Utilizzare i percentili per escludere valori estremi che incideranno sulle statistiche Average
e Maximum
. Ad esempio, la statistica p95
mostra la durata massima del 95% delle chiamate, escludendo il 5% più lento. Per ulteriori informazioni, consulta Percentiles nella Amazon CloudWatch User Guide.
Parametri di concorrenza
Lambda segnala i parametri di simultaneità come conteggio aggregato del numero di istanze che elaborano eventi in una funzione, una versione, un alias o una Regione AWS. Per vedere quanto sei vicino al superamento dei limiti di simultaneità, visualizza questi parametri con la statistica Max
.
-
ConcurrentExecutions
– Il numero di istanze di funzione che stanno elaborando gli eventi. Se questo numero raggiunge la quota di esecuzioni simultanee per la regione o il limite di simultaneità riservato configurato per la funzione, Lambda limita le richieste di chiamata aggiuntive. -
ProvisionedConcurrentExecutions
: il numero di istanze di funzione che stanno elaborando eventi tramite la simultaneità fornita. Per ogni chiamata di un alias o versione con la simultaneità fornita, Lambda emette il conteggio corrente. Se la tua funzione è inattiva o non riceve richieste, Lambda non emette questa metrica. -
ProvisionedConcurrencyUtilization
: per una versione o un alias, il valore diProvisionedConcurrentExecutions
diviso per la quantità totale di simultaneità fornita configurata. Ad esempio, se configuri una simultaneità fornita pari a 10 per la funzione eProvisionedConcurrentExecutions
è 7, alloraProvisionedConcurrencyUtilization
è 0,7.Se la tua funzione è inattiva o non riceve richieste, Lambda non emette questa metrica perché è basata su.
ProvisionedConcurrentExecutions
Tienilo a mente se lo utilizziProvisionedConcurrencyUtilization
come base per gli allarmi. CloudWatch -
UnreservedConcurrentExecutions
: per una regione, il numero di eventi che vengono elaborati da funzioni che non dispongono di simultaneità riservata. -
ClaimedAccountConcurrency
: per una Regione, la quantità di simultaneità non disponibile per le invocazioni on demand.ClaimedAccountConcurrency
corrisponde aUnreservedConcurrentExecutions
più la quantità di simultaneità allocata (ovvero la simultaneità totale riservata più la simultaneità totale fornita). Per ulteriori informazioni, consulta Lavorare con il parametro ClaimedAccountConcurrency.
Parametri di chiamata asincrona
I parametri di chiamata asincrona forniscono dettagli sulle chiamate asincrone da origini di eventi e sulle chiamate dirette. Puoi impostare le soglie e gli allarmi per la notifica di alcuni cambiamenti. Ad esempio, quando si verifica un aumento indesiderato del numero di eventi in coda per l'elaborazione (AsyncEventsReceived
). Oppure, quando un evento aspetta da molto tempo di essere elaborato (AsyncEventAge
).
-
AsyncEventsReceived
: il numero di eventi che Lambda mette correttamente in coda per l'elaborazione. Questo parametro fornisce informazioni sul numero di eventi ricevuti da una funzione Lambda. Monitora questo parametro e imposta gli allarmi relativi alle soglie per verificare eventuali problemi. Ad esempio, per rilevare un numero indesiderato di eventi inviati a Lambda e diagnosticare rapidamente i problemi derivanti da configurazioni errate di trigger o funzioni. Le discrepanze traAsyncEventsReceived
eInvocations
possono indicare una disparità nell'elaborazione, l'eliminazione degli eventi o un potenziale arretrato della coda. -
AsyncEventAge
: il tempo che intercorre tra il momento in cui Lambda mette in coda correttamente l'evento e il momento in cui la funzione viene richiamata. Il valore di questo parametro aumenta quando gli eventi vengono ritentati a causa di errori di chiamata o limitazioni. Monitora questo parametro e imposta allarmi per rilevare le soglie su diverse statistiche relative a quando si verifica un accumulo di code. Per risolvere un aumento di questo parametro, consulta il parametroErrors
per identificare gli errori della funzione e il parametroThrottles
per identificare i problemi di simultaneità. -
AsyncEventsDropped
: il numero di eventi eliminati senza eseguire correttamente la funzione. Se configuri una coda DLQ o una destinazioneOnFailure
, gli eventi vengono inviati lì prima di essere eliminati. Gli eventi vengono eliminati per diversi motivi. Ad esempio, possono superare la durata massima o esaurire il numero massimo di tentativi oppure la simultaneità riservata potrebbe essere impostata su 0. Per risolvere il problema relativo all'eliminazione degli eventi, consulta il parametroErrors
per identificare gli errori della funzione e il parametroThrottles
per identificare i problemi di simultaneità.
Parametri dello strumento di mappatura dell'origine degli eventi
I parametri dello strumento di mappatura dell'origine degli eventi forniscono informazioni sul comportamento di elaborazione dello strumento di mappatura dell'origine degli eventi. Questi parametri consentono di monitorare il flusso e lo stato degli eventi, compresi gli eventi che lo strumento di mappatura dell'origine degli eventi ha elaborato, filtrato o eliminato con successo.
Devi attivare la ricezione di parametri relative ai conteggi (PolledEventCount
, FilteredOutEventCount
, InvokedEventCount
, FailedInvokeEventCount
, DroppedEventCount
, OnFailureDestinationDeliveredEventCount
e DeletedEventCount
). Per attivare l'accesso, puoi utilizzare la console o l'API Lambda.
Per abilitare i parametri o uno strumento di mappatura dell'origine degli eventi (console)
-
Aprire la pagina Funzioni
della console Lambda. -
Scegli la funzione per la quale desideri abilitare i parametri.
-
Scegli la scheda Configurazione, quindi scegli Trigger.
-
Scegli lo strumento di mappatura dell'origine degli eventi per cui desideri abilitare i parametri, quindi scegli Modifica.
-
In Configurazione dello strumento di mappatura dell'origine degli eventi, scegli Abilita parametri.
-
Seleziona Salva.
In alternativa, puoi abilitare le metriche per la mappatura delle sorgenti degli eventi a livello di codice utilizzando l'oggetto nel tuo. EventSourceMappingMetricsConfigEventSourceMappingConfiguration Ad esempio, il seguente comando UpdateEventSourceMappingCLI abilita le metriche per una mappatura dell'origine degli eventi:
aws lambda update-event-source-mapping \ --uuid a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --metrics-config Metrics=EventCount
Visualizza i parametri relativi al conteggio degli eventi con la statistica Sum
.
avvertimento
Gli strumenti di mappatura dell'origine degli eventi elaborano ogni evento almeno una volta e può verificarsi un'elaborazione duplicata dei record. Per questo motivo, gli eventi possono essere contati più volte nei parametri che coinvolgono il conteggio degli eventi.
-
PolledEventCount
: il numero di eventi che Lambda legge correttamente dall'origine eventi. Se Lambda esegue un polling di eventi ma riceve un polling vuoto (nessun nuovo record), Lambda emette un valore 0 per questo parametro. Usa questo parametro per rilevare se lo strumento di mappatura dell'origine degli eventi esegue correttamente il polling dei nuovi eventi. -
FilteredOutEventCount
: per lo strumento di mappatura dell'origine degli eventi con un criterio di filtro, il numero di eventi filtrati in base a tali criteri di filtro. Utilizza questo parametro per rilevare se lo strumento di mappatura dell'origine degli eventi filtra correttamente gli eventi. Per gli eventi che soddisfano i criteri di filtro, Lambda emette un parametro 0. -
InvokedEventCount
: il numero di eventi che hanno richiamato la funzione Lambda. Usa questo parametro per verificare che gli eventi stiano richiamando correttamente la tua funzione. Se un evento causa un errore nella funzione o una limitazione,InvokedEventCount
può contare più volte per lo stesso evento sottoposto a polling a causa dei vari tentativi automatici. -
FailedInvokeEventCount
: il numero di eventi con cui Lambda ha provato a richiamare la funzione ma senza riuscirci. Le invocazioni possono avere esito negativo per motivi quali problemi di configurazione della rete, autorizzazioni non corrette o una funzione, una versione o un alias Lambda eliminati. Se lo strumento di mappatura dell'origine degli eventi ha abilitato le risposte in batch parziali,FailedInvokeEventCount
include qualsiasi evento con un valore non vuotoBatchItemFailures
nella risposta.Nota
Il timestamp per il parametro
FailedInvokeEventCount
rappresenta la fine dell'invocazione della funzione. Questo comportamento è diverso dagli altri parametri di errore di invocazione Lambda, che hanno un timestamp all'inizio dell'invocazione della funzione. -
DroppedEventCount
: il numero di eventi che Lambda ha interrotto a causa della scadenza o dell'esaurimento dei nuovi tentativi. In particolare, si tratta del numero di record che superano i valori configurati perMaximumRecordAgeInSeconds
oMaximumRetryAttempts
. È importante sottolineare che questo non include il numero di record che scadono a causa del superamento delle impostazioni di conservazione dell'origine eventi. Gli eventi eliminati escludono anche gli eventi inviati a una destinazione in errore. Utilizza questo parametro per rilevare un aumento del backlog di eventi. -
OnFailureDestinationDeliveredEventCount
: per lo strumento di mappatura dell'origine degli eventi con una destinazione in errore configurata, il numero di eventi inviati a tale destinazione. Utilizza questo parametro per monitorare gli errori di funzione relativi alle chiamate da questa origine eventi. Se la consegna alla destinazione non riesce, Lambda gestisce i parametri come segue:-
Lambda non emette il parametro
OnFailureDestinationDeliveredEventCount
. -
Per il parametro
DestinationDeliveryFailures
, Lambda emette un 1. -
Per il parametro
DroppedEventCount
, Lambda emette un numero pari al numero di eventi che hanno avuto esito negativo nella consegna.
-
-
DeletedEventCount
: il numero di eventi che Lambda elimina correttamente in seguito all'elaborazione. Se Lambda prova a eliminare un evento ma fallisce, Lambda emette un parametro 0. Utilizza questo parametro per assicurarti che gli eventi elaborati correttamente vengano eliminati dall'origine eventi.
Se lo strumento di mappatura dell'origine degli eventi è disabilitato, non riceverai i parametri dello strumento. Potresti anche visualizzare metriche mancanti se CloudWatch o Lambda presenta una disponibilità ridotta.
Non tutti i parametri dello strumento di mappatura dell'origine degli eventi sono disponibili per ogni origine eventi. Al momento, i parametri dello strumento di mappatura dell'origine degli eventi sono disponibili per le origini eventi dei flussi Amazon SQS, Kinesis e DynamoDB. La seguente matrice di disponibilità riassume i parametri supportati per ogni tipo di origine eventi.
Parametro dello strumento di mappatura dell'origine degli eventi | Supporto per Amazon SQS | Supporto per flussi Kinesis e DynamoDB |
---|---|---|
|
Sì |
Sì |
|
Sì |
Sì |
|
Sì |
Sì |
|
Sì |
Sì |
|
No |
Sì |
|
No |
Sì |
|
Sì |
No |
Inoltre, se lo strumento di mappatura dell'origine degli eventi delle origini eventi è in modalità provisioning, Lambda fornisce il seguente parametro:
-
ProvisionedPollers
: per lo strumento di mappatura dell'origine degli eventi in modalità provisioning, il numero di poller di eventi che sono attivamente in esecuzione. Visualizza questo parametro utilizzando il parametroMAX
.