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

Usa il rilevamento ricorsivo del loop Lambda per prevenire loop infiniti

Quando configuri una funzione Lambda di modo che invii l'output sullo stesso servizio o risorsa che richiama la funzione, è possibile che venga creato un ciclo ricorsivo infinito. Ad esempio, una funzione Lambda potrebbe scrivere un messaggio in una coda Amazon Simple Queue Service (AmazonSQS), che a sua volta richiama la stessa funzione. Questa invocazione fa sì che la funzione scriva un altro messaggio nella coda, che a sua volta richiama nuovamente la funzione.

I loop ricorsivi involontari possono comportare la fatturazione di addebiti imprevisti a tuo favore. Account AWS I cicli ricorsivi possono anche far sì che Lambda si dimensioni e utilizzi tutta la simultaneità disponibile del tuo account. Per contribuire a ridurre l'impatto dei loop involontari, Lambda rileva alcuni tipi di loop ricorsivi poco dopo che si sono verificati. Per impostazione predefinita, quando Lambda rileva un ciclo ricorsivo, interrompe la chiamata della funzione e ti avvisa. Se il tuo progetto utilizza intenzionalmente schemi ricorsivi, puoi modificare la configurazione predefinita di una funzione per consentirne l'invocazione ricorsiva. Per ulteriori informazioni, consulta Consentire l'esecuzione di una funzione Lambda in un ciclo ricorsivo.

Comprendere il rilevamento dei cicli ricorsivi

Il rilevamento dei cicli ricorsivi in Lambda si basa sul tracciamento gli eventi. Lambda è un servizio di elaborazione basato su eventi che esegue il codice della funzione quando si verificano determinati eventi. Ad esempio, quando un articolo viene aggiunto a una SQS coda Amazon o a un argomento di Amazon Simple Notification Service (AmazonSNS). Lambda passa gli eventi alla funzione come JSON oggetti, che contengono informazioni sulla modifica dello stato del sistema. Quando un evento causa l'esecuzione di una funzione, si parla di invocazione.

Per rilevare i cicli ricorsivi, Lambda utilizza le intestazioni di tracciamento AWS X-Ray. Quando dei Servizi AWS che supportano il rilevamento dei cicli ricorsivi inviano eventi a Lambda, tali eventi vengono automaticamente annotati con metadati. Quando la funzione Lambda scrive uno di questi eventi su un altro supportato Servizio AWS utilizzando una versione supportata di an AWS SDK, aggiorna questi metadati. I metadati aggiornati includono il numero di volte in cui l'evento ha richiamato la funzione.

Una catena di richieste è una sequenza di invocazioni Lambda causate dallo stesso evento di attivazione. Ad esempio, immagina che una SQS coda Amazon richiami la tua funzione Lambda. La tua funzione Lambda invia quindi l'evento elaborato alla stessa SQS coda Amazon, che richiama nuovamente la tua funzione. In questo esempio, ogni invocazione della funzione rientra nella stessa catena di richieste.

Se la tua funzione viene richiamata circa 16 volte nella stessa catena di richieste, Lambda interrompe automaticamente la successiva chiamata di funzione in quella catena di richieste e ti avvisa. Ad esempio, se la funzione è configurata con più trigger, le invocazioni da altri trigger non sono interessate.

Se hai configurato una destinazione in caso di errore o una coda DLQ per la funzione, Lambda invia anche l'evento dall'invocazione interrotta alla destinazione o alla coda DLQ. Quando configuri una coda di destinazione o di lettere morte per la tua funzione, assicurati di non utilizzare un argomento Amazon SNS o una SQS coda Amazon che la tua funzione utilizza anche come trigger di eventi o mappatura dell'origine degli eventi. Se invii eventi alla stessa risorsa che richiama la tua funzione, puoi creare un altro ciclo ricorsivo.

Supportato e Servizi AWS SDKs

Lambda è in grado di rilevare solo i loop ricorsivi che includono determinati loop supportati. Servizi AWS Affinché i loop ricorsivi vengano rilevati, la funzione deve utilizzare anche uno dei circuiti supportati. AWS SDKs

Supportato Servizi AWS

Lambda attualmente rileva loop ricorsivi tra le tue funzioni, Amazon, Amazon SQS S3 e Amazon. SNS Lambda rileva anche i cicli ricorsivi composti solo da funzioni Lambda, che possono richiamarsi reciprocamente in modo sincrono o asincrono. I diagrammi seguenti mostrano alcuni esempi di ciclo ricorsivo che Lambda è in grado di rilevare:

Quando un altro Servizio AWS tipo Amazon DynamoDB fa parte del ciclo, Lambda al momento non è in grado di rilevarlo e fermarlo.

Poiché attualmente Lambda rileva solo loop ricorsivi che coinvolgono Amazon, Amazon S3 e SQS SNS Amazon, è comunque possibile che i loop che Servizi AWS coinvolgono altri possano comportare un utilizzo involontario delle funzioni Lambda.

Per evitare che ti vengano addebitati addebiti imprevisti Account AWS, ti consigliamo di configurare gli CloudWatchallarmi Amazon per avvisarti di modelli di utilizzo insoliti. Ad esempio, puoi CloudWatch configurare la notifica dei picchi nella concorrenza o nelle chiamate della funzione Lambda. Puoi anche configurare un avviso di fatturazione che ti segnali quando la spesa nel tuo account supera una soglia da te specificata. In alternativa, puoi utilizzare AWS Cost Anomaly Detection per ricevere avvisi in merito a schemi di fatturazione insoliti.

Supportato AWS SDKs

Affinché Lambda rilevi i loop ricorsivi, la funzione deve utilizzare una delle seguenti versioni o successive: SDK

Alcuni runtime Lambda come Python e Node.js includono una versione di. AWS SDK Se la SDK versione inclusa nel runtime della funzione è inferiore a quella minima richiesta, puoi aggiungere una versione supportata di SDK al pacchetto di distribuzione della funzione. Puoi anche aggiungere una SDK versione supportata alla tua funzione utilizzando un livello Lambda. Per un elenco dei componenti SDKs inclusi in ogni runtime Lambda, consulta. Runtime Lambda

Notifiche dei cicli ricorsivi

Quando Lambda interrompe un ciclo ricorsivo, ricevi notifiche tramite AWS Health Dashboard e tramite e-mail. Puoi anche utilizzare le CloudWatch metriche per monitorare il numero di chiamate ricorsive interrotte da Lambda.

AWS Health Dashboard notifiche

Quando Lambda interrompe una chiamata ricorsiva, AWS Health Dashboard visualizza una notifica nella pagina Lo stato del tuo account, in Problemi aperti e recenti. Tieni presente che possono essere necessarie fino a tre ore dopo che Lambda interrompe un'invocazione ricorsiva prima che venga visualizzata questa notifica. Per ulteriori informazioni sulla visualizzazione degli eventi dell'account in AWS Health Dashboard, consulta Getting started with your AWS Health Dashboard — Lo stato del tuo account nella AWS Health User Guide.

Avvisi via e-mail

Quando Lambda interrompe per la prima volta un'invocazione ricorsiva della funzione, ti invia un avviso e-mail. Lambda invia un massimo di un'e-mail ogni 24 ore per ogni funzione del tuo Account AWS. Dopo l'invio di una notifica e-mail da parte di Lambda, non riceverai altre e-mail per la stessa funzione per altre 24 ore, anche se Lambda interrompe ulteriori invocazioni ricorsive della funzione. Tieni presente che possono essere necessarie fino a tre ore dopo che Lambda interrompe un'invocazione ricorsiva prima che tu riceva questo avviso via e-mail.

Lambda invia avvisi e-mail a ciclo ricorsivo al contatto principale Account AWS dell'account e al contatto operativo alternativo del tuo account. Per informazioni sulla visualizzazione o l'aggiornamento degli indirizzi e-mail nel tuo account, consulta la pagina Aggiornamento delle informazioni di contatto della Guida generale di AWS .

CloudWatch Metriche Amazon

La CloudWatch metrica RecursiveInvocationsDropped registra il numero di chiamate di funzioni che Lambda ha interrotto perché la funzione è stata richiamata più di circa 16 volte in una singola catena di richieste. Lambda emette questo parametro non appena interrompe un'invocazione ricorsiva. Per visualizzare questa metrica, segui le istruzioni relative alla visualizzazione delle metriche sulla console e scegli la metrica. CloudWatch RecursiveInvocationsDropped

Risposta alle notifiche di rilevamento dei cicli ricorsivi

Quando la funzione viene richiamata più di circa 16 volte dallo stesso evento di attivazione, Lambda interrompe la successiva chiamata di funzione per quell'evento per interrompere il ciclo ricorsivo. Per evitare il ripetersi di un ciclo ricorsivo interrotto da Lambda, procedi come segue:

Inoltre, se l'origine degli eventi per la tua funzione Lambda è una SQS coda Amazon, prendi in considerazione la possibilità di configurare una coda di lettere non scritte nella coda di origine.

Se l'origine dell'evento è un SNS argomento di Amazon, prendi in considerazione l'aggiunta di una destinazione in caso di errore per la tua funzione.

Consentire l'esecuzione di una funzione Lambda in un ciclo ricorsivo

Se il tuo progetto utilizza intenzionalmente un ciclo ricorsivo, puoi configurare una funzione Lambda per consentirne l'invocazione ricorsiva. Ti consigliamo di evitare l'uso di loop ricorsivi nel tuo progetto. Gli errori di implementazione possono portare a invocazioni ricorsive che utilizzano tutta la concorrenza disponibile e alla fatturazione di Account AWS addebiti imprevisti sul tuo account.

È possibile configurare funzioni per consentire loop ricorsivi utilizzando la console Lambda, il AWS Command Line Interface ()AWS CLI e il. PutFunctionRecursionConfigAPI Puoi anche configurare l'impostazione di rilevamento ricorsivo del loop di una funzione in and. AWS SAM AWS CloudFormation

Per impostazione predefinita, Lambda rileva e termina i loop ricorsivi. A meno che il progetto non utilizzi intenzionalmente un loop ricorsivo, ti consigliamo di non modificare la configurazione predefinita delle funzioni.

Nota che quando configuri una funzione per consentire i loop ricorsivi, la metrica non viene emessa. CloudWatch RecursiveInvocationsDropped

Console

Per consentire l'esecuzione di una funzione in un ciclo ricorsivo (console)

1. Aprire la pagina Funzioni della console Lambda.

2. Scegliete il nome della funzione per aprire la pagina dei dettagli della funzione.

3. Scegli la scheda Configurazione, quindi scegli Rilevamento di concorrenza e ricorsione.

4. Oltre al rilevamento ricorsivo del loop, scegli Modifica.

5. Seleziona Consenti loop ricorsivi.

6. Seleziona Salva.

AWS CLI

È possibile utilizzare il PutFunctionRecursionConfigAPIper consentire alla funzione di essere richiamata in un ciclo ricorsivo. Specificare Allow il parametro del ciclo ricorsivo. Ad esempio, puoi chiamarlo API con il put-function-recursion-config AWS CLI comando:

aws lambda put-function-recursion-config --function-name yourFunctionName --recursive-loop Allow

Puoi riportare la configurazione della funzione all'impostazione predefinita in modo che Lambda termini i loop ricorsivi quando li rileva. Modifica la configurazione della tua funzione utilizzando la console Lambda o il. AWS CLI

Console

Per configurare una funzione in modo che i loop ricorsivi vengano terminati (console)

1. Aprire la pagina Funzioni della console Lambda.

2. Scegliete il nome della funzione per aprire la pagina dei dettagli della funzione.

3. Scegli la scheda Configurazione, quindi scegli Rilevamento di concorrenza e ricorsione.

4. Oltre al rilevamento ricorsivo del loop, scegli Modifica.

5. Seleziona Termina i loop ricorsivi.

6. Seleziona Salva.

AWS CLI

Puoi usare il PutFunctionRecursionConfigAPIper configurare la tua funzione in modo che Lambda termini i loop ricorsivi quando li rileva. Specificare il parametro Terminate del ciclo ricorsivo. Ad esempio, puoi chiamarlo API con il put-function-recursion-config AWS CLI comando:

aws lambda put-function-recursion-config --function-name yourFunctionName --recursive-loop Terminate

Regioni supportate per il rilevamento ricorsivo del loop Lambda

Il rilevamento ricorsivo del loop Lambda è supportato nei seguenti casi. Regioni AWS