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

Risoluzione dei problemi delle funzioni Web Lambda

Inizia con lo stato della risorsa, la risposta HTTP e i log della richiesta. Le funzioni Web espongono uno stato separato per la funzione, la revisione, l'endpoint e ogni regione di un endpoint. MultiRegion PerRegion Un errore in una risorsa non sempre modifica lo stato delle altre.

Raccogliere informazioni diagnostiche

Problemi di distribuzione e avvio

Per evitare errori di distribuzione ripetuti, convalida la configurazione e l'avvio in una revisione di test prima di creare una revisione di produzione.

Errori della CLI e dei pacchetti

Richieste HTTP non riuscite

Limiti di intestazione della richiesta

Alle intestazioni delle richieste si applicano due limiti. Lambda limita il blocco di intestazione a 128 KB e rifiuta le richieste più grandi prima che raggiungano la tua funzione. Il server Node.js HTTP della tua funzione limita anche il numero di righe di intestazione che accetta. Entrambi restituiscono campi di intestazione della richiesta HTTP 431 troppo grandi, come mostrato nella tabella seguente. Per i limiti della piattaforma, vedi. Limiti dell'intestazione

Il limite di dimensione conta ogni byte dell'intestazione della richiesta man mano che il client la invia. Ciò include la riga di richiesta, ogni riga di intestazione (incluse Host tutte le intestazioni aggiunte dalla libreria del client) e i terminatori di riga. Le intestazioni aggiunte da Lambda non vengono conteggiate ai fini del limite di dimensione.

Quando una richiesta supera il limite di dimensione, Lambda la rifiuta prima che raggiunga la funzione, quindi la richiesta non produce alcuna chiamata e nessuna immissione nel registro dell'applicazione. L'intestazione della lambda-web-error-type risposta identifica la causa.

Il limite di Node.js conteggio conta le righe di intestazione, non i nomi di intestazione distinti. Un'intestazione ripetuta tre volte conta tre volte. Di conseguenza, una richiesta che accumula x-forwarded-for o traccia le intestazioni attraverso una catena di proxy può raggiungere il limite. Nessuna singola intestazione deve avere un aspetto insolito perché ciò accada. Il limite viene misurato sulla richiesta ricevuta dalla funzione, che include le intestazioni aggiunte da Lambda. Di conseguenza, un client che invia poco meno di 1.000 righe di intestazione può raggiungerlo. Quando ciò accade, la richiesta raggiunge l'ambiente di esecuzione e il Node.js server la rifiuta durante l'analisi. Il tuo gestore non funziona. La risposta contiene le lambda-web-logstream intestazioni lambda-web-request-id and, ma non contiene l'lambda-web-error-typeintestazione.

Se l'applicazione deve accettare più righe di intestazione di quelle consentite dall'Node.jsimpostazione predefinita, aumentate il Node.js limite nel codice del server. Imposta server.maxHeadersCount il numero di righe di intestazione da accettare o impostalo per 0 disabilitare il controllo del Node.js conteggio. Il limite di dimensione di 128 KB è ancora valido.

const server = http.createServer(handler);
server.maxHeadersCount = 2000;
server.listen(port, host);

Non è necessario modificare il limite di dimensione dell'Node.jsintestazione. I Node.js runtime gestiti lo impostano in modo che corrisponda al limite della piattaforma, quindi il limite della piattaforma si applica alla dimensione dell'intestazione. Non è possibile aumentare il limite della piattaforma dal codice dell'applicazione.

Per rimanere entro i limiti, spostate lo stato di massa dalle intestazioni al corpo della richiesta, eliminate i cookie e comprimete le intestazioni di tracciamento e proxy ridondanti prima che la richiesta raggiunga l'endpoint. Se una CloudFront distribuzione si trova davanti all'endpoint, inoltra solo le intestazioni necessarie all'applicazione nella policy di richiesta di origine.

Tipi di errore delle funzioni Web

Quando una richiesta a un endpoint Web Function fallisce, Lambda restituisce lambda-web-error-type un'intestazione di risposta che identifica l'errore. Il valore utilizza il formato<Prefix>.<ErrorReason>: il prefisso indica dove si è verificato l'errore e il motivo specifica la causa.

Ad esempio, Runtime.RequestTimeout significa che il runtime gestito ha segnalato che la funzione non ha risposto entro il timeout configurato e Application.InitCodeError significa che il codice di inizializzazione utilizzato ha generato un errore.

Lambda include l'lambda-web-error-typeintestazione quando l'errore è stato causato dalla richiesta stessa o dalla funzione, dalla sua configurazione o dal suo codice. Lambda omette l'intestazione per gli errori interni del servizio e per gli errori di autorizzazione, in modo che nessun dettaglio venga rivelato a un chiamante non autorizzato. Un valore indica un problema nel percorso tra la piattaforma Lambda e la tua funzione. Nel percorso della richiesta, l'errore identifica dove la richiesta non è riuscita. Nel percorso di risposta, utilizzate il valore insieme alla telemetria dell'applicazione per capire cosa è successo.

Per le metriche di limitazione che identificano il limite applicato (per i tipi,, e Platform.EndpointMaxEnvThrottle di errore) Platform.AccountRequestThrottle Platform.EndpointRequestThrottlePlatform.AccountActiveVCPUArm64Throttle, vedi. Metriche di utilizzo e limitazione a livello regionale

Mancano i log o le metriche

Se non viene visualizzato alcun registro dell'applicazione, il ruolo di esecuzione potrebbe non avere le autorizzazioni Amazon CloudWatch Logs. Allega la policy AWSLambdaBasicExecutionRole gestita al ruolo di esecuzione, oppure concedilogs:CreateLogGroup, elogs:CreateLogStream. logs:PutLogEvents Per le autorizzazioni richieste, consulta Ruolo di esecuzione.

Problemi di archiviazione e crittografia del codice

Problemi con gli endpoint MultiRegionPerRegion

Usa il regionalEndpoints campo per identificare la regione interessata. Confronta la sua stateReason e updateStatusReason con le regioni sane. Controlla le quote regionali, le repliche AWS KMS delle chiavi, la disponibilità del runtime e lo stato di replica della revisione. Dopo aver corretto la causa, ripeti l'aggiornamento dell'endpoint. Per il modello di replica, vedere. Multi-Region dispiegamento

Per un MultiRegion endpoint, il routing basato sulla latenza (che indirizza le richieste verso la regione con la latenza misurata più bassa) non garantisce che ogni richiesta vada alla regione con la latenza più bassa. Esegui il test dalla posizione del client interessato e ispeziona i log dell'applicazione per determinare quale regione ha gestito la richiesta. Per un PerRegion endpoint, verificate anche la configurazione del DNS esterno o del routing front-door.

Problemi di rete e connettività

La maggior parte dei problemi di connettività deriva da una revisione in corso che non contiene alcun riferimento al connettore o fa riferimento a una versione precedente del connettore, oppure da sottoreti di connettori, gruppi di sicurezza o percorsi che bloccano il traffico.

Utilizzate la seguente sequenza per isolare un problema di connettività:

I sintomi più comuni includono i seguenti.

Non è disponibile un accesso interattivo a un ambiente di esecuzione di funzioni Web. Utilizza i log delle applicazioni, le intestazioni di risposta degli endpoint, i campi dello stato delle risorse, le CloudWatch metriche e i log di flusso VPC per diagnosticare gli errori.

Prepara un pacchetto di escalation

Se i controlli precedenti non identificano la causa, raccogli le seguenti informazioni prima di aprire un caso. Supporto AWS Ciò consente al tecnico dell'assistenza di correlare il funzionamento del piano di controllo, l'implementazione regionale, la richiesta e la telemetria:

Informazioni correlate