Problemi durante il richiamo delle funzioni

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeRequestContentTooLarge","message":"Request content too large"}
Fn: Error invoking function. status: 413 message: Request content too large

Il messaggio indica che il contenuto della richiesta alle funzioni OCI supera la dimensione massima consentita di 6 MB.

Se viene visualizzato questo errore, verificare che il contenuto della richiesta non superi la dimensione massima consentita.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"TooManyRequests","message":"User-rate limit exceeded"}
Fn: Error invoking function. status: 429 message: User-rate limit exceeded

Il messaggio indica che OCI Functions sta già gestendo il numero massimo di richieste consentite per la tenancy e non può accettare un'altra richiesta.

Per ulteriori informazioni su come prevedere ed evitare in modo proattivo questo errore, vedere Monitoraggio dell'uso e della disponibilità della memoria per le funzioni OCI.

Se viene visualizzato questo errore, attendere alcuni minuti prima di richiamare di nuovo la funzione. In alternativa, o se il problema persiste, Contattaci per aumentare la memoria totale per l'esecuzione della funzione concorrente.

Quando si richiama una funzione distribuita in OCI Functions, il client potrebbe segnalare un timeout.

Per ulteriori informazioni, controllare i log della funzione (vedere Memorizzazione e visualizzazione dei log delle funzioni). Se i log contengono un messaggio di stato 444, la connessione tra il client e le funzioni OCI è stata interrotta durante l'esecuzione della funzione. Se nei log della funzione viene visualizzato un messaggio di stato 444, richiamare di nuovo la funzione.

Tenere presente che il modo in cui viene richiamata una funzione determina anche il periodo di tempo massimo per il quale la funzione può essere eseguita. Per ulteriori informazioni, vedere Funzioni di fatturazione.

Se si verifica un problema con il codice di una funzione, quando si richiama la funzione viene visualizzato il seguente errore:

Fn: Error invoking function. status: 502 message: Function failed

Per analizzare il problema con il codice della funzione, controllare l'output dei log da parte della funzione. Il servizio Oracle Cloud Infrastructure Logging è l'opzione predefinita e consigliata per accedere, cercare e memorizzare i log delle funzioni. Per memorizzare e visualizzare i log di una funzione, la funzione deve includere istruzioni di stampa. Per ulteriori informazioni, vedere Memorizzazione e visualizzazione dei log delle funzioni.

OCI Functions consente di inviare i log di una funzione a una destinazione di log esterna (ad esempio, Papertrail) impostando un URL syslog per l'applicazione. Vedere Memorizzazione e visualizzazione dei log delle funzioni.

Se l'URL syslog non è valido o non è raggiungibile, quando si richiama la funzione viene visualizzato il seguente errore:

{"code":"FunctionInvokeSyslogUnavailable","message":"Syslog endpoint unavailable"}

Fn: Error invoking function. status: 502 message: Syslog endpoint unavailable

Per confermare che l'URL della destinazione di log esterna è la causa dell'errore:

1. Aggiornare l'applicazione per annullare l'impostazione dell'URL syslog mediante l'interfaccia CLI di Fn Project. Ad esempio, immettendo:

   fn update app helloworld-app --syslog-url ''

2. Distribuire la funzione che si desidera eseguire. Vedere Creazione e distribuzione di funzioni.
3. Richiamare la funzione. Vedere Funzioni di fatturazione.

Se la funzione viene eseguita correttamente, l'URL della destinazione di log esterna non è raggiungibile dalla subnet in cui la funzione è in esecuzione. Doppio controllo:

• L'URL della destinazione di log esterna è valido.
• L'URL della destinazione di log esterna è accessibile pubblicamente.
• La subnet in cui è in esecuzione la funzione dispone dell'accesso in uscita alla rete Internet pubblica.

Quando richiami una funzione, OCI Functions estrae l'immagine corrispondente da Oracle Cloud Infrastructure Registry utilizzando la VCN e le subnet specificate per l'applicazione.

Se OCI Functions non è in grado di estrarre l'immagine, viene restituito il seguente messaggio quando si richiama una funzione:

{"code":"FunctionInvokeImageNotAvailable","message":"Failed to pull function image"}

Fn: Error invoking function. status: 502 message: Failed to pull function image

Soluzioni possibili:

• Verificare che l'immagine specificata per la funzione esista ancora nella posizione specificata in Oracle Cloud Infrastructure Registry.
• Verifica che Oracle Cloud Infrastructure sia disponibile (questo messaggio viene restituito se Oracle Cloud Infrastructure non è inaspettatamente disponibile).

• Verifica che la VCN includa un gateway Internet o un gateway di servizi. Affinché OCI Functions sia in grado di accedere a Oracle Cloud Infrastructure Registry per il pull di un'immagine, la VCN deve includere un gateway Internet o un gateway di servizi, come indicato di seguito.

  • Se per l'applicazione sono state specificate subnet pubbliche, la VCN deve includere anche un gateway Internet. Una tabella di instradamento deve includere una regola di instradamento destinata al gateway Internet con la relativa proprietà Blocco CIDR di destinazione impostata su 0.0.0.0/0. Una lista di sicurezza deve includere una regola di uscita con conservazione dello stato che consenta l'accesso a Oracle Cloud Infrastructure Registry (ad esempio, con la proprietà Tipo di destinazione impostata su Service, la proprietà Servizio di destinazione impostata su All <region> services In Oracle Services Network e la proprietà Protocollo IP impostata su All).
  • Se per l'applicazione sono state specificate subnet private, anche la VCN deve includere un gateway di servizi. Per consentire l'accesso a All <region> Services In Oracle Services Network, è necessario impostare il gateway del servizio. Una tabella di instradamento deve includere una regola di instradamento destinata al gateway di servizio con la proprietà Destination Service impostata su All <region> Services In Oracle Services Network. Una lista di sicurezza deve includere una regola di uscita con conservazione dello stato che consenta l'accesso a Oracle Cloud Infrastructure Registry (ad esempio, con la proprietà Tipo di destinazione impostata su Service, la proprietà Servizio di destinazione impostata su All <region> services In Oracle Services Network e la proprietà Protocollo IP impostata su All).

  Se non è già stato definito un gateway Internet o di servizio per la VCN, definirne uno adesso.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeSubnetOutOfIPs","message":"subnet ocid1.subnet.oc1.phx.aaaaaaaac... is out of IPs"}
Fn: Error invoking function. status: 502 message: subnet ocid1.subnet.oc1.phx.aaaaaaaac... is out of IPs

Se viene visualizzato questo errore, controllare due volte che ogni subnet nella VCN disponga almeno del numero minimo richiesto di indirizzi IP liberi specificato nella sezione Creazione della VCN e delle subnet da utilizzare con le funzioni OCI, se non esistono già.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeSubnetNotAvailable","message":"subnet ocid1.subnet.oc1.phx.aaaaaaaac... does not exist or Oracle Functions is not authorized to use it"}
Fn: Error invoking function. status: 502 message: subnet ocid1.subnet.oc1.phx.aaaaaaaac... does not exist or Oracle Functions is not authorized to use it

Se viene visualizzato questo errore, verificare che la subnet specificata per l'applicazione esista ancora.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeSubnetNotAvailable","message":"dhcp options ocid1.dhcpoptions.oc1.phx.aaaaaaaac... does not exist or Oracle Functions is not authorized to use it"}
Fn: Error invoking function. status: 502 message: dhcp options ocid1.dhcpoptions.oc1.phx.aaaaaaaac... does not exist or Oracle Functions is not authorized to use it

Se viene visualizzato questo errore, verificare che il set di opzioni DHCP nella VCN specificata per l'applicazione esista ancora.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeResponseBodyTooLarge","message":"function response body too large"}
Fn: Error invoking function. status: 502 message: function response body too large

Il messaggio indica che la risposta restituita dall'esecuzione della funzione supera la dimensione massima consentita di 6 MB.

Se viene visualizzato questo errore, rivedere il codice funzione e ridurre le dimensioni delle risposte restituite dalla funzione.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeResponseHeaderTooLarge","message":"function response header too large"}
Fn: Error invoking function. status: 502 message: function response body too large

Il messaggio indica che l'intestazione della risposta restituita dall'esecuzione della funzione supera la dimensione massima consentita.

Se viene visualizzato questo errore, rivedere il codice funzione e ridurre il numero e/o le dimensioni di qualsiasi intestazione personalizzata restituita dalla funzione.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":" FunctionInvokeTooManyMatchingDGs","message":"Unable to get resource authorization token due to Function resource matching too many Dynamic Groups. Update your Dynamic Groups' matching rules"}
Fn: Error invoking function. status: 502 message: Unable to get resource authorization token due to Function resource matching too many Dynamic Groups. Update your Dynamic Groups' matching rules

Il messaggio indica che la funzione appartiene a un numero di gruppi dinamici superiore al numero massimo supportato.

Se viene visualizzato questo errore, ridurre il numero di gruppi dinamici a cui appartiene la funzione aggiornando le regole di corrispondenza dei gruppi dinamici. Per conoscere il numero massimo di gruppi dinamici ai quali può appartenere una funzione, vedere Limiti nei gruppi dinamici (il limite visualizzato per una singola istanza di computazione si applica anche a una funzione).

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeExecutionError","message":"error receiving function response"}
Fn: Error invoking function. status: 502 message: error receiving function response

Il messaggio indica che la risposta dall'esecuzione della funzione restituisce un errore.

Se questo errore viene visualizzato in modo imprevisto, rivedere il codice funzione per comprendere le condizioni in cui la funzione non viene eseguita correttamente.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeExecutionFailed","message":"function failed"}
Fn: Error invoking function. status: 502 message: function failed

Il messaggio indica che è stato rilevato un errore durante l'esecuzione della funzione, probabilmente causato da un bug nel codice della funzione.

Se viene visualizzato questo errore, rivedere il codice funzione e correggere eventuali bug trovati.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeInvalidResponse","message":"invalid function response"}
Fn: Error invoking function. status: 502 message: invalid function response

Il messaggio indica che il richiamo della funzione restituisce un codice di risposta HTTP non valido (nessun errore di funzione né timeout).

Se viene visualizzato questo errore, rivedere il codice funzione e correggere eventuali bug trovati.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeSubnetConfigError","message":"Customer subnet DNS resolver error. Please fix the subnet configuration and try again"}
Fn: Error invoking function. status: 502 message: Customer subnet DNS resolver error. Please fix the subnet configuration and try again

Il messaggio indica un problema di configurazione della VCN, probabilmente correlato alla configurazione del resolver personalizzato.

Se viene visualizzato questo errore, identificare qualsiasi subnet nella VCN che utilizza un resolver personalizzato. Quando una subnet utilizza un resolver personalizzato (ad esempio, situato su Internet, nella VCN o nella rete on premise), confermare che il resolver personalizzato è raggiungibile. Verificare inoltre che il resolver personalizzato funzioni correttamente. Per ulteriori informazioni sui resolver personalizzati, vedere DNS nella tua rete cloud virtuale.

Se l'errore persiste, verificare che la configurazione della VCN (e la configurazione del resolver personalizzato, se utilizzata) sia corretta richiamando una nuova funzione hello world in esecuzione in una nuova VCN:

1. Creare una nuova VCN mediante la procedura guidata VCN (selezionare VCN con connettività Internet).
2. Creare una nuova risorsa di opzioni DHCP e specificare le stesse opzioni DNS di prima (se è stato utilizzato un resolver personalizzato in precedenza, selezionare Resolver personalizzato).
3. Crea una nuova subnet nella VCN e seleziona la risorsa Opzioni DHCP appena creata.
4. Creare una nuova applicazione specificando la VCN e la subnet appena create.
5. Crea una semplice funzione hello world nell'applicazione che hai appena creato.
6. Confermare che è possibile invocare la nuova funzione del mondo di ciao con successo.

Se il problema persiste, contattaci per risolvere il problema di configurazione della VCN.

Quando si richiama una funzione distribuita in OCI Functions, l'immagine della funzione viene estratta dal registro Docker. A seconda delle dimensioni dell'immagine e delle dimensioni delle immagini per altre funzioni nell'applicazione, è possibile che venga visualizzato un messaggio simile al seguente:

Fn: Error invoking function. status: 502 message: The combined uncompressed size of all Function images in an application has exceeded the allowed limit. Please reduce the size of the images or number of functions from the application.

Questo messaggio indica che il pull dell'immagine della funzione ha aumentato la dimensione totale non compressa di tutte le immagini per le funzioni nell'applicazione oltre il limite massimo consentito.

Se viene visualizzato questo errore:

• Utilizzare tecniche standard per ridurre le dimensioni dell'immagine della funzione e/o le dimensioni delle immagini per altre funzioni nell'applicazione.
• Ridurre il numero di funzioni nell'applicazione.

Quando si richiama una funzione distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeServiceUnavailable","message":"Timed out - server too busy"}
Fn: Error invoking function. status: 503 message: Timed out - server too busy

Il messaggio indica che OCI Functions non è attualmente in grado di gestire la richiesta, probabilmente a causa di una capacità insufficiente. L'individuazione di questo messaggio di errore più volte non è raro, perché lo scale-up della capacità delle funzioni OCI può richiedere del tempo per soddisfare la domanda dei richiami delle funzioni.

Se viene visualizzato questo errore, provare a richiamare di nuovo la funzione. Non preoccuparti se il messaggio viene nuovamente visualizzato. Continuare a richiamare la funzione, lasciando un breve periodo di tempo tra i tentativi di richiamo.

Tenere presente quanto riportato di seguito.

• Se si continua a vedere questo errore, considerare di aumentare l'intervallo di tempo tra i richiami di funzione (forse utilizzando una tecnica standard come il backoff esponenziale jitterato per aggiungere un grado di casualità all'intervallo).
• Se il messaggio viene visualizzato quando una funzione viene richiamata come risultato di un'azione attivata da un evento, ulteriori tentativi di richiamare la funzione verranno eseguiti automaticamente fino a quando la funzione non viene richiamata correttamente. Non è richiesto alcun intervento da parte vostra.
• Se si impostano gli allarmi attivati dalle risposte agli errori di funzione contenenti 503 codici di errore, è possibile che vengano visualizzate più notifiche per le quali non è richiesto alcun intervento da parte dell'utente.
• Se il messaggio continua a essere visualizzato dopo un periodo di tempo prolungato, Contattaci per assistenza.

Quando si richiama una funzione Python 3.6 distribuita in OCI Functions, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeContainerInitFail","message":"Container failed to initialize, please ensure you are using the latest fdk and check the logs"}

Fn: Error invoking function. status: 504 message: Container failed to initialize, please ensure you are using the latest fdk and check the logs

Se viene visualizzato questo errore, controllare i log della funzione. Se viene visualizzato un messaggio "ModuleNotFoundError: No module named 'contextvars' nei log della funzione:

1. Aggiungere la riga seguente al file requirements.txt della funzione:

   fdk>=0.1.21

2. Ridistribuire la funzione in OCI Functions.
3. Richiama di nuovo la funzione.

Quando si richiama una funzione distribuita in OCI Functions, l'esecuzione della funzione è soggetta a una soglia di memoria massima. Se questo limite viene superato, l'esecuzione della funzione viene interrotta e viene restituito il seguente messaggio di errore:

{"code":"FunctionInvokeContainerInitFail","message":"Container failed to initialize, please ensure you are using the latest fdk and check the logs"}

Fn: Error invoking function. status: 504 message: Container failed to initialize, please ensure you are using the latest fdk and check the logs

Se viene visualizzato questo errore, aumentare la soglia di memoria massima della funzione. Ad esempio, a 256 MB, 512 MB, 1024 MB, 2048 MB o 3072 MB. Per i valori validi per la soglia di memoria massima, vedere Modifica delle impostazioni di memoria e timeout predefinite.

Ad esempio, per impostare la soglia di memoria massima di una funzione su 256 MB, effettuare una delle operazioni riportate di seguito.

• Selezionare Modifica funzione nella pagina Dettagli funzione della console e selezionare 256 dall'elenco a discesa Memoria (in MB).

• Aggiungere la riga seguente al file func.yaml della funzione. La soglia di memoria massima verrà impostata su 256 MB ogni volta che viene richiamata la funzione:

  memory: 256

  Tenere presente che se si modifica il file func.yaml, è necessario ridistribuire la funzione in OCI Functions prima di richiamarla di nuovo.

È consigliabile utilizzare la versione più recente dell'interfaccia CLI di Fn Project quando si crea una funzione Python helloworld. Quando si immette il comando fn init --runtime python <function-name> per creare la funzione helloworld, la riga memory: 256 viene aggiunta automaticamente al file func.yaml.

Quando si richiama una funzione distribuita in OCI Functions, la funzione può essere eseguita solo per un determinato periodo di tempo. Se questo limite di tempo viene superato, l'esecuzione della funzione viene interrotta e viene restituito il seguente messaggio di errore:

{"code":"FunctionInvokeTimeout","message":"Timed out"}

Fn: Error invoking function. status: 504 message: Timed out

Se viene visualizzato questo errore, provare ad aumentare il tempo massimo di esecuzione di una funzione nella definizione della funzione. Ad esempio, per impostare il tempo massimo su 300 secondi, effettuare una delle operazioni riportate di seguito.

• Selezionare Modifica funzione nella pagina Dettagli funzione della console e immettere 300 nel campo Timeout.

• Aggiungere la riga seguente al file func.yaml della funzione. Il limite di tempo massimo verrà impostato su 300 secondi ogni volta che viene richiamata la funzione:

  timeout: 300

  Tenere presente che se si modifica il file func.yaml, è necessario ridistribuire la funzione in OCI Functions prima di richiamarla di nuovo.

Tenere presente che il modo in cui viene richiamata una funzione determina anche il periodo di tempo massimo per il quale la funzione può essere eseguita. Per ulteriori informazioni, vedere Funzioni di fatturazione.

Potresti anche visualizzare questo messaggio di errore quando una funzione in esecuzione in una subnet pubblica non è in grado di connettersi a un'istanza di Oracle Autonomous Database per la quale sono abilitate le liste di controllo dell'accesso (ACL, Access Control List). In questo caso, vedere Connessione alle istanze di Oracle Autonomous Database dall'esecuzione di funzioni per ulteriori informazioni su:

• Configurazione della subnet per l'invio di tutto il traffico Internet in uscita a un gateway NAT e per consentire il traffico Internet.
• Aggiunta dell'indirizzo IP pubblico del gateway NAT alla lista di controllo dell'accesso del database.

Quando richiami una funzione distribuita in OCI Functions, l'immagine della funzione viene estratta dal registro Docker ed eseguita all'interno di un contenitore. A seconda delle dipendenze della funzione, l'avvio del contenitore potrebbe richiedere molto tempo. Se l'avvio del contenitore richiede troppo tempo, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeContainerInitTimeout","message":"Container initialization timed out, please ensure you are using the latest fdk and check the logs"}
Fn: Error invoking function. status: 504 message: Container initialization timed out, please ensure you are using the latest fdk and check the logs

Se viene visualizzato questo errore, aumentare la soglia di memoria massima della funzione. Ad esempio, a 256 MB, 512 MB, 1024 MB, 2048 MB o 3072 MB. Per i valori validi per la soglia di memoria massima, vedere Modifica delle impostazioni di memoria e timeout predefinite.

Ad esempio, per impostare la soglia di memoria massima di una funzione su 256 MB, effettuare una delle operazioni riportate di seguito.

• Selezionare Modifica funzione nella pagina Dettagli funzione della console e selezionare 256 dall'elenco a discesa Memoria (in MB).

• Aggiungere la riga seguente al file func.yaml della funzione. La soglia di memoria massima verrà impostata su 256 MB ogni volta che viene richiamata la funzione:

  memory: 256

  Tenere presente che se si modifica il file func.yaml, è necessario ridistribuire la funzione in OCI Functions prima di richiamarla di nuovo.

È consigliabile utilizzare la versione più recente dell'interfaccia CLI di Fn Project quando si crea una funzione Python helloworld. Quando si immette il comando fn init --runtime python <function-name> per creare la funzione helloworld, la riga memory: 256 viene aggiunta automaticamente al file func.yaml.

Quando si richiama una funzione distribuita in OCI Functions, l'immagine della funzione viene estratta dal registro Docker. A seconda delle dimensioni dell'immagine, potrebbe essere necessario molto tempo per estrarre l'immagine. Se il pull dell'immagine richiede troppo tempo, potrebbe essere visualizzato il seguente messaggio di errore:

{"code":"FunctionInvokeImagePullTimeout","message":"Image pull timed out"}
Fn: Error invoking function. status: 504 message: Image pull timed out