Tipi di metriche per le funzioni degli eventi Lambda

Questa sezione descrive i tipi di metriche Lambda disponibili nella console. CloudWatch

Parametri di invocazione

Le metriche di invocazione sono indicatori binari del risultato di una chiamata di una Lambda Event Function. Visualizza questi parametri con la statistica Sum. Ad esempio, se la Event Function restituisce un errore, Lambda invia la Errors metrica con il valore 1. Per ottenere un conteggio del numero di errori della funzione Event che si sono verificati ogni minuto, visualizza la Sum Errors metrica con un periodo di 1 minuto.

• Invocations— Il numero di volte in cui viene richiamato il codice Event Function, incluse le chiamate riuscite e le chiamate che generano 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 di Invocations 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 di Errors per il valore di Invocations. Nota che il timestamp di una metrica di errore riflette quando la funzione di evento è stata richiamata, non quando si è verificato l'errore.

• DeadLetterErrors— Per le chiamate asincrone, il numero di volte in cui Lambda tenta di inviare un evento a una coda di lettere morte (DLQ) senza successo. Dead-letter possono verificarsi errori a causa di limiti di risorse o dimensioni impostati in modo errato.

• 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 errore TooManyRequestsException. Le richieste con limitazione e altri errori di chiamata non contano come Invocations o Errors.

  Nota

  Con Lambda Managed Instances, Lambda fornisce metriche granulari di accelerazione che identificano il vincolo specifico che causa l'acceleratore. Quando si verifica un rallentamento nell'ambiente di esecuzione, viene emessa esattamente una delle seguenti metriche secondarie con il valore 1, mentre le altre tre vengono emesse con il valore 0. La Throttles metrica viene sempre emessa insieme a queste metriche secondarie.

  • CPUThrottles— Le chiamate sono state limitate a causa dell'esaurimento della CPU nell'ambiente di esecuzione.

  • MemoryThrottles— Richiamazioni limitate a causa dell'esaurimento della memoria nell'ambiente di esecuzione.

  • DiskThrottles— Richiamazioni limitate a causa dell'esaurimento del disco nell'ambiente di esecuzione.

  • ConcurrencyThrottles— Le chiamate vengono limitate quando viene raggiunto il limite di concorrenza dell'ambiente di esecuzione.

• OversizedRecordCount— Per le sorgenti di eventi Amazon DocumentDB, il numero di eventi che Event Function riceve dal flusso di modifiche di dimensioni superiori a 6 MB. Lambda elimina il messaggio ed emette questo parametro.

• ProvisionedConcurrencyInvocations— Il numero di volte in cui il codice Event Function viene richiamato utilizzando la concorrenza fornita.

• ProvisionedConcurrencySpilloverInvocations— Il numero di volte in cui il codice della funzione dell'evento viene richiamato utilizzando la concorrenza standard quando sono in uso tutta la concorrenza fornita.

• RecursiveInvocationsDropped— Il numero di volte in cui Lambda ha interrotto l'invocazione della funzione evento perché ha rilevato che la funzione evento fa parte di un ciclo ricorsivo infinito. Il rilevamento ricorsivo del loop monitora quante volte una funzione evento viene richiamata come parte di una catena di richieste tracciando i metadati aggiunti dagli SDK supportati. AWS Per impostazione predefinita, se la funzione evento viene richiamata come parte di una catena di richieste circa 16 volte, Lambda elimina la chiamata 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.

Metriche di distribuzione

Le metriche di distribuzione forniscono informazioni sugli eventi di distribuzione di Lambda Event Function e sui relativi processi di convalida.

• SignatureValidationErrors— Il numero di volte in cui si è verificata la distribuzione di un pacchetto di codice con errori di convalida della firma quando la politica di configurazione della firma del codice è impostata su. Warn Questa metrica viene emessa quando i controlli di scadenza, mancata corrispondenza o revoca hanno esito negativo, ma la distribuzione è comunque consentita a causa dell'impostazione dei criteri. Warn Per ulteriori informazioni sulla firma del codice, consulta. Utilizzo della firma del codice per verificare l'integrità del codice con Lambda

Metriche delle prestazioni

Le metriche delle prestazioni forniscono dettagli sulle prestazioni relative a una singola chiamata di Event Function. Ad esempio, la Duration metrica indica la quantità di tempo in millisecondi impiegata dalla Event Function per l'elaborazione di un evento. Per avere un'idea della velocità con cui la Event Function elabora gli eventi, visualizza queste metriche con la statistica or. Average Max

• Duration— La quantità di tempo impiegata dal codice Event Function per l'elaborazione di un evento. La durata fatturata per una invocazione è il valore di Duration arrotondato per eccesso al millisecondo più vicino. Duration non include il tempo di avvio a freddo.

• PostRuntimeExtensionsDuration— Il tempo cumulativo impiegato dal runtime per l'esecuzione del codice per le estensioni dopo il completamento del codice Event Function.

• IteratorAge: per le origini eventi DynamoDB, Kinesis e Amazon DocumentDB, l'età (in millisecondi) dell'ultimo record dell'evento. Questa metrica misura il tempo che intercorre tra il momento in cui uno stream riceve il record e il momento in cui la mappatura dell'origine dell'evento invia l'evento alla Event Function.

• OffsetLag— Per le sorgenti di eventi autogestite Apache Kafka e Amazon Managed Streaming for Apache Kafka (Amazon MSK), la differenza di offset tra l'ultimo record scritto su un argomento e l'ultimo record elaborato dal gruppo di consumatori di Event Function. 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 riporta le metriche di concorrenza come conteggio aggregato del numero di istanze che elaborano eventi tra una Event Function, una versione, un alias o. 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 Event Function che elaborano eventi. Se questo numero raggiunge la quota di esecuzioni simultanee per la regione o il limite di concorrenza riservato per la funzione Event, Lambda limita le richieste di invocazione aggiuntive.

• ProvisionedConcurrentExecutions— Il numero di istanze di Event Function che elaborano gli eventi utilizzando la concorrenza fornita. Per ogni chiamata di un alias o versione con la simultaneità fornita, Lambda emette il conteggio corrente. Se la tua Event Function è inattiva o non riceve richieste, Lambda non emette questa metrica.

• ProvisionedConcurrencyUtilization: per una versione o un alias, il valore di ProvisionedConcurrentExecutions diviso per la quantità totale di simultaneità fornita configurata. Ad esempio, se configuri una concorrenza predisposta di 10 per la funzione Event e il valore è 7, allora il valore ProvisionedConcurrentExecutions è 0,7. ProvisionedConcurrencyUtilization

  Se la tua Event Function è inattiva o non riceve richieste, Lambda non emette questa metrica perché è basata su. ProvisionedConcurrentExecutions Tienilo a mente se lo utilizzi ProvisionedConcurrencyUtilization come base per gli allarmi. CloudWatch

• UnreservedConcurrentExecutions— Per una regione, il numero di eventi che Event Functions senza concorrenza riservata sta elaborando.

• ClaimedAccountConcurrency: per una Regione, la quantità di simultaneità non disponibile per le invocazioni on demand. ClaimedAccountConcurrency corrisponde a UnreservedConcurrentExecutions 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. Questa metrica fornisce informazioni sul numero di eventi ricevuti da una Event Function. 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 tra AsyncEventsReceived e Invocations 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 correttamente in coda l'evento e il momento in cui viene richiamata la Event Function. 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 parametro Errors per identificare gli errori della funzione e il parametro Throttles per identificare i problemi di simultaneità.

• AsyncEventsDropped— Il numero di eventi che vengono eliminati senza eseguire correttamente la funzione di evento. Se configuri una coda DLQ o una destinazione OnFailure, 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 parametro Errors per identificare gli errori della funzione e il parametro Throttles 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.

Attualmente, le metriche di mappatura delle sorgenti degli eventi sono disponibili per Amazon SQS, Kinesis, DynamoDB, Amazon MSK e le sorgenti di eventi Apache Kafka autogestite.

Per la mappatura delle sorgenti degli eventi con metrics config, puoi anche controllare tutte le metriche relative a ESM nella scheda Monitor dalla pagina Console Lambda > Risorse aggiuntive > mappature delle fonti degli eventi ora.

Per abilitare i parametri o uno strumento di mappatura dell'origine degli eventi (console)

1. Apri la pagina Event Functions della console Lambda.

2. Scegli la funzione evento per cui desideri abilitare le metriche.

3. Scegli la scheda Configurazione, quindi scegli Trigger.

4. Scegli lo strumento di mappatura dell'origine degli eventi per cui desideri abilitare i parametri, quindi scegli Modifica.

5. In Configurazione della mappatura dell'origine degli eventi, scegli Abilita metriche o seleziona dall'elenco a discesa Metriche.

6. Selezionare Salva.

In alternativa, puoi abilitare le metriche per la mappatura delle sorgenti degli eventi a livello di codice utilizzando l'oggetto presente 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

Esistono 3 gruppi di metriche:EventCount, ErrorCount eKafkaMetrics, e ogni gruppo ha più metriche. Non tutte le metriche sono disponibili per ogni origine di eventi. La tabella seguente riassume le metriche supportate per ogni tipo di origine di eventi.

È necessario attivare il gruppo di metriche per ricevere le metriche relative alle metriche. Ad esempio, imposta EventCount in metrics config per avere: (PolledEventCount,,,,, e). FilteredOutEventCount InvokedEventCount FailedInvokeEventCount DroppedEventCount OnFailureDestinationDeliveredEventCount DeletedEventCount

Parametro dello strumento di mappatura dell'origine degli eventi	Gruppo di metriche	Amazon SQS	Stream Kinesis e DynamoDB	Amazon MSK e Apache Kafka autogestito
PolledEventCount	EventCount	Sì	Sì	Sì
FilteredOutEventCount	EventCount	Sì	Sì	Sì
InvokedEventCount	EventCount	Sì	Sì	Sì
FailedInvokeEventCount	EventCount	Sì	Sì	Sì
DroppedEventCount	EventCount	No	Sì	Sì
OnFailureDestinationDeliveredEventCount	EventCount	No	Sì	Sì
DeletedEventCount	EventCount	Sì	No	No
CommittedEventCount	EventCount	No	No	Sì
PollingErrorCount	ErrorCount	No	No	Sì
InvokeErrorCount	ErrorCount	No	No	Sì
OnFailureDestinationDeliveryErrorCount	ErrorCount	No	No	Sì
SchemaRegistryErrorCount	ErrorCount	No	No	Sì
CommitErrorCount	ErrorCount	No	No	Sì
MaxOffsetLag	KafkaMetrics	No	No	Sì
SumOffsetLag	KafkaMetrics	No	No	Sì

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 questa metrica usando la matematica. MAX

• (Solo Amazon MSK e sorgenti di eventi Apache Kafka autogestite)EventPollerUnit: per le mappature delle sorgenti di eventi in modalità provisioning, il numero di unità di poller di eventi che sono attivamente in esecuzione. Visualizza SUM questa metrica usando la matematica.

• (Amazon MSK e sorgenti di eventi Apache Kafka autogestite)EventPollerThroughputInBytes: per le mappature delle sorgenti di eventi in modalità provisioned, la dimensione totale dei record dei poller di eventi intervistati dall'origine dell'evento. Può dirti l'attuale produttività dei sondaggi. Visualizza questa metrica usando la matematica. SUM

Ecco ulteriori dettagli su ciascuna metrica:

• 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 tua funzione Lambda Event. Usa questa metrica per verificare che gli eventi stiano richiamando correttamente la tua Event Function. Se un evento causa un errore di funzione o un rallentamento, è possibile che lo stesso evento sottoposto a interrogazione InvokedEventCount venga conteggiato più volte a causa di tentativi automatici.

  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 potrebbero essere contati più volte nelle metriche che coinvolgono il conteggio degli eventi.

• FailedInvokeEventCount— Il numero di eventi con cui Lambda ha provato a richiamare la tua Event Function, ma non sono riusciti. Le chiamate possono avere esito negativo a causa di problemi di configurazione della rete, autorizzazioni errate o eliminazione di una funzione, una versione o un alias Lambda Event Function. Se lo strumento di mappatura dell'origine degli eventi ha abilitato le risposte in batch parziali, FailedInvokeEventCount include qualsiasi evento con un valore non vuoto BatchItemFailures nella risposta.

  Nota

  Il timestamp della FailedInvokeEventCount metrica rappresenta la fine della chiamata di Event Function. Questo comportamento è diverso dalle altre metriche di errore di chiamata Lambda, che hanno un timestamp all'inizio della chiamata di Event Function.

• 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 per MaximumRecordAgeInSeconds o MaximumRetryAttempts. È 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.

• CommittedEventCount— Il numero di eventi che Lambda ha eseguito con successo dopo l'elaborazione. È una somma dei delta dell'ultimo e dell'ultimo offset commesso da ciascuna partizione nella mappatura delle sorgenti degli eventi di Kafka.

• PollingErrorCount— Il numero di errori che Lambda non è riuscito a controllare le richieste dall'origine dell'evento. Lambda emette questi dati metrici solo quando si verifica un errore.

• InvokeErrorCount— Il numero di errori in cui Lambda non è riuscita a richiamare la funzione evento. Notate che la chiamata è registrata in batch. Il numero è a livello di batch, non a livello di conteggio dei record. Lambda emette questi dati metrici solo quando si verifica un errore.

• SchemaRegistryErrorCount— Il numero di errori che Lambda non è riuscito a recuperare lo schema o a deserializzare con lo schema. Lambda emette questi dati metrici solo quando si verifica un errore.

• CommitErrorCount— Il numero di errori che Lambda non è riuscito a commettere nel cluster Kafka. Lambda emette questi dati metrici solo quando si verifica un errore.

• MaxOffsetLag— Il numero massimo di ritardi di offset (differenza tra gli offset più recenti e quelli confermati) su tutte le partizioni nella mappatura delle sorgenti degli eventi.

• SumOffsetLag— La somma dell'offset è in ritardo su tutte le partizioni nella mappatura della sorgente dell'evento.

Se lo strumento di mappatura dell'origine degli eventi è disabilitato, non riceverai i parametri dello strumento. Potresti anche vedere delle metriche mancanti se CloudWatch o Lambda presenta una disponibilità ridotta.