Fehlerbehebung bei OCI Functions

Erfahren Sie, wie Sie Probleme mit OCI Functions und mögliche Lösungen für häufige Probleme beheben können.

In diesem Thema werden allgemeine Probleme im Zusammenhang mit OCI Functions und deren Behebung behandelt.

Verwenden Sie die folgenden Techniken, um mehr über einen Fehler oder ein Problem zu erfahren:

Im Diagramm "Fehler" auf der Seite "Metriken" in der Konsole können Sie Fehlercodes und Meldungen für einzelne Funktionen anzeigen: Wenn eine Funktion beim Aufrufen nicht wie erwartet ausgeführt wird oder ausgeführt wird, können Sie das Diagramm Fehler auf der Seite Metriken in der Konsole verwenden, um Fehlercodes und Fehlermeldungen für diese Funktion anzuzeigen. Weitere Informationen finden Sie unter Funktionsmetriken.
Funktionsausführung mit Tracing überwachen: Wenn eine Funktion beim Aufruf nicht wie erwartet ausgeführt wird oder ausgeführt wird, können Sie mit Tracing Ausführungs- und Performanceprobleme debuggen. Um Tracing zu verwenden, müssen Sie Tracing für die Anwendung aktivieren, die diese Funktion enthält, und dann Tracing für eine oder mehrere Funktionen aktivieren. Anschließend können Sie Funktionstraces im APM-Trace-Explorer anzeigen. Weitere Informationen finden Sie unter Verteiltes Tracing für Funktionen.
Funktionslogs verwenden, um Funktionsaufrufinformationen zu prüfen: Der Oracle Cloud Infrastructure Logging-Service ist die Standardoption und die empfohlene Option für den Zugriff auf, die Suche und das Speichern von Funktionslogs. Beachten Sie, dass die Funktion Druckanweisungen enthalten muss, um Logs für eine Funktion zu speichern und anzuzeigen. Weitere Informationen finden Sie unter Funktionslogs speichern und anzeigen.
Mit DEBUG=1 können Sie Details zu Anforderungen und Antworten anzeigen, die an und vom OCI Functions-Service gesendet werden: Wenn bei Verwendung eines Fn-Projekt-CLI-Befehls ein unerwarteter Fehler auftritt, werden weitere Details zu den HTTP-Anforderungen und -Antworten angezeigt, die an und vom OCI Functions-Service gesendet werden. Starten Sie den Befehl mit der Zeichenfolge DEBUG=1, und führen Sie den Befehl erneut aus. Beispiel:
```
$ DEBUG=1 fn invoke helloworld-app helloworld-func
```
Beachten Sie, dass DEBUG=1 vor dem Befehl eingegeben werden und DEBUG in Großbuchstaben stehen muss.

Wenn Sie mit Oracle Support zusammenarbeiten und ein Supportticket erstellen, können Sie die Ausgabe an das Ticket anhängen.

Wenn Sie einen lokalen Rechner als OCI Functions-Entwicklungsumgebung eingerichtet haben (--provider oracle im Fn-Projekt-CLI-Kontext angeben), müssen Sie die Umgebungsvariable OCI_GO_SDK_DEBUG=v festlegen und den Befehl mit DEBUG=1 starten.

Die Themen in diesem Thema sind in folgende allgemeine Kategorien unterteilt:

OCI Functions einrichten und ausführen


Fehlernummer und -meldung (falls zutreffend)	Beschreibung und Link
`401: Not authenticated`	Beim Ausführen von Fn-Projekt-CLI-Befehlen wird ein 401-Fehler zurückgegeben
`404: Resource is not authorized or not found`	Beim Ausführen von Fn-Projekt-CLI-Befehlen wird ein 404-Fehler zurückgegeben
`x509: decryption password incorrect`	Beim Ausführen von Fn-Projekt-CLI-Befehlen wird der Fehler "X509: decryption password incorrect" zurückgegeben
`Error response from daemon... unknown: Unauthorized`	Beim Ausführen Docker-bezogener Vorgänge mit der Fn-Projekt-CLI wird die Meldung "Error response from daemon... unknown: Unauthorized" angezeigt
`asn1:structure error: tags don't match`	Beim Ausführen eines Fn-Projekt-CLI-Befehls wird die Meldung "Fn: asn1:structure error: tags don't match" angezeigt
`Client version: n.n.nn is not latest: n.n.nn`	Das Ausführen des Befehls fn version zeigt, dass eine neuere Version der Fn-Projekt-CLI verfügbar ist

Anwendungen und Funktionen erstellen


Fehlernummer und -meldung (falls zutreffend)	Beschreibung und Link
`Unable to create your app, please try again.`	Beim Erstellen einer neuen Anwendung wird im Dialogfeld "Neue Anwendung" eine Fehlermeldung angezeigt

Anwendungen und Funktionen bereitstellen


Fehlernummer und -meldung (falls zutreffend)	Beschreibung und Link
`unauthorized: incorrect username or password`	Beim Bereitstellen einer Anwendung wird die Meldung "unauthorized: incorrect username or password" zurückgegeben
`denied: requested access to the resource is denied` `Fn: error running docker push, are you logged into docker?: exit status 1`	Beim Bereitstellen einer Funktion wird die Meldung "error running docker push, are you login into docker?" zurückgegeben.
`500: Internal server error`	Beim Bereitstellen einer Funktion werden eine ListTriggers-Meldung und ein 500-Fehler zurückgegeben
`Image <image-name> does not exist or you do not have access to use it.`	Beim Bereitstellen einer Funktion wird die Meldung "Das Image ist nicht vorhanden, oder Sie haben keinen Zugriff darauf" zurückgegeben
`401: Missing subnets annotation`	Beim Deployment einer Funktion in OCI Functions wird die Meldung "Fn: Missing subnets annotation" zurückgegeben
`Function's image architecture 'x86' is incompatible with the application's shape type 'GENERIC_X86_ARM'`	Beim Deployment einer Funktion in OCI Functions wird die Meldung "Function's image architecture 'x86' is incompatible..." zurückgegeben
`OL8 CloudShell does not support cross-compilation and multi-arch functions builds. Please ensure the architecture of your App matches the CloudShell architecture.`	Wenn Sie eine Funktion in OCI Functions in Cloud Shell bereitstellen, wird die Meldung "OL8 Cloud Shell unterstützt keine Compilierungs- und Multi-Arch-Funktionen-Builds..." zurückgegeben
`Invalid or unsupported image manifest. Unable to get architecture from the OCIR Manifest/Headers…`	Beim Bereitstellen einer Funktion wird ein "Ungültiges oder nicht unterstütztes Imagemanifest" zurückgegeben. Architektur kann nicht aus der Nachricht "OCIR-Manifest/Header..." abgerufen werden

Funktionen aufrufen


Fehlernummer und -meldung (falls zutreffend)	Beschreibung und Link
`413: Request content too large` `FunctionInvokeRequestContentTooLarge`	Beim Aufrufen einer Funktion werden eine FunctionInvokeRequestContentTooLarge-Meldung und ein 413-Fehler zurückgegeben
`429: User-rate limit exceeded` `TooManyRequests`	Beim Aufrufen einer Funktion werden die Meldung TooManyRequests und ein 429-Fehler zurückgegeben
`444`	Beim Aufrufen einer Funktion meldet der Client einen Timeout. In den Logs der Funktion wird ein 444-Fehler angezeigt.
`502: Function failed`	Wenn Sie eine Funktion aufrufen, werden die Meldung "Funktion nicht erfolgreich" und ein 502-Fehler zurückgegeben
`502: Syslog endpoint unavailable`	Beim Aufrufen einer Funktion werden die Meldung "FunctionInvokeSyslogUnavailable" und ein 502-Fehler zurückgegeben
`502: Failed to pull function image`	Beim Aufrufen einer Funktion werden die Meldung "FunctionInvokeImageNotAvailable" und ein 502-Fehler zurückgegeben
`502: subnet ocid1.subnet.... is out of IPs`	Beim Aufrufen einer Funktion werden die Meldung "FunctionInvokeSubnetOutOfIPs" und ein 502-Fehler zurückgegeben
`502: subnet ocid1.subnet.... does not exist or Oracle Functions is not authorized to use it`	Beim Aufrufen einer Funktion werden die Meldung "FunctionInvokeSubnetNotAvailable" und ein 502-Fehler (aufgrund eines Subnetzproblems) zurückgegeben
`502: dhcp options ocid1.dhcpoptions.... does not exist or Oracle Functions is not authorized to use it`	Beim Aufrufen einer Funktion werden die Meldung "FunctionInvokeSubnetNotAvailable" und ein 502-Fehler (aufgrund eines DHCP-Optionenproblems) zurückgegeben
`502: function response body too large` `FunctionInvokeResponseBodyTooLarge`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeResponseBodyTooLarge und ein 502-Fehler zurückgegeben
`502: FunctionInvokeResponseHeaderTooLarge` `function response header too large`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeResponseHeaderTooLarge und ein 502-Fehler zurückgegeben
`502: Unable to get resource authorization token due to Function resource matching too many Dynamic Groups. Update your Dynamic Groups' matching rules` `FunctionInvokeTooManyMatchingDGs`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeTooManyMatchingDGs und ein 502-Fehler zurückgegeben
`502: error receiving function response` `FunctionInvokeExecutionError`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeExecutionError und ein 502-Fehler zurückgegeben
`502: function failed` `FunctionInvokeExecutionFailed`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeExecutionFailed und ein 502-Fehler zurückgegeben
`502: invalid function response` `FunctionInvokeInvalidResponse`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeInvalidResponse und ein 502-Fehler zurückgegeben
`502: Customer subnet DNS resolver error. Please fix the subnet configuration and try again`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeSubnetConfigError und ein 502-Fehler zurückgegeben
`502: 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.`	Beim Aufrufen einer Funktion wird die Meldung "Die kombinierte unkomprimierte Größe aller Funktionsbilder in einer Anwendung hat den zugewiesenen Grenzwert überschritten...." und ein 502-Fehler zurückgegeben
`503: Timed out - server too busy` `FunctionInvokeServiceUnavailable`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeServiceUnavailable und ein 503-Fehler zurückgegeben
`504: Container failed to initialize, please ensure you are using the latest fdk and check the logs` `'ModuleNotFoundError: No module named 'contextvars'`	Beim Aufrufen einer Funktion werden eine FunctionInvokeContainerInitFail-Fehlermeldung, ein 504-Fehler und eine ModuleNotFoundError-Logmeldung zurückgegeben: Kein Modul namens "contextvars"
`504: Container failed to initialize, please ensure you are using the latest fdk and check the logs`	Beim Aufrufen einer Funktion werden die Meldungen "FunctionInvokeContainerInitFail" und "Container initialization timed out" sowie ein 504-Fehler zurückgegeben
`504: Timed out`	Beim Aufrufen einer Funktion werden die Meldung "FunctionInvokeTimeout" und ein 504-Fehler zurückgegeben
`504: Container initialization timed out, please ensure you are using the latest fdk and check the logs` `FunctionInvokeContainerInitTimeout`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeContainerInitTimeout und ein 504-Fehler zurückgegeben
`504: Image pull timed out` `FunctionInvokeImagePullTimeout`	Beim Aufrufen einer Funktion werden die Meldung FunctionInvokeImagePullTimeout und ein 504-Fehler zurückgegeben

Verschiedenes