Troubleshooting Oracle Functions

This topic covers common issues related to Oracle Functions and how to address them.

Use the following techniques to find out more about an error or issue:

• Use DEBUG=1 to see more details about an error: If you encounter an unexpected error when using an Fn Project CLI command, you can find out more about the problem by starting the command with the string DEBUG=1 and running the command again. For example:

  DEBUG=1 fn invoke helloworld-app helloworld-func

  Note that DEBUG=1 must appear before the command, and that DEBUG must be in upper case.

• Use --display-call-id when invoking functions to aid issue resolution: If you encounter an issue when invoking a function, you can engage with Oracle Support. Oracle Support can investigate the issue more efficiently if you provide the call id of the function invocation. You can obtain the call id using the --display-call-id command option. For example:

  
  fn invoke helloworld-app helloworld-func --display-call-id

  Output:

  Call ID: 01CS23SDG71BT2N9GZJ002DQM5
  Hello World !

The issues in this topic are organized in the following broad categories:

• Setting up and running Oracle Functions

  Error number and message (if applicable)	Description and link
  401: Not authenticated	Running Fn Project CLI commands returns a 401 error
  404: Resource is not authorized or not found	Running Fn Project CLI commands returns a 404 error
  x509: decryption password incorrect	Running Fn Project CLI commands returns an X509: decryption password incorrect error
  Error response from daemon... unknown: Unauthorized	Performing Docker-related operations with the Fn Project CLI displays an "Error response from daemon... unknown: Unauthorized" message
  asn1:structure error: tags don't match	Running an Fn Project CLI command displays an "Fn: asn1:structure error: tags don't match" message
  Client version: n.n.nn is not latest: n.n.nn	Running fn version shows that a more recent version of the Fn Project CLI is available

• Creating applications and functions

  Error number and message (if applicable)	Description and link
  Unable to create your app, please try again.	Creating a new application displays an error message in the New Application dialog

• Deploying applications and functions

  Error number and message (if applicable)	Description and link
  unauthorized: incorrect username or password	Deploying an application returns an "unauthorized: incorrect username or password" message
  denied: requested access to the resource is denied Fn: error running docker push, are you logged into docker?: exit status 1	Deploying a function returns an "error running docker push, are you logged into docker?" message
  500: Internal server error	Deploying a function returns a ListTriggers message and a 500 error
  Image <image-name> does not exist or you do not have access to use it.	Deploying a function returns an "Image does not exist or you do not have access to use it" message
  401: Missing subnets annotation	Deploying a function to Oracle Functions returns "Fn: Missing subnets annotation" message

• Invoking functions

  Error number and message (if applicable)	Description and link
  502: Function failed	Invoking a function returns a Function failed message and a 502 error
  502: Syslog endpoint unavailable	Invoking a function returns a FunctionInvokeSyslogUnavailable message and a 502 error
  502: Failed to pull function image	Invoking a function returns a FunctionInvokeImageNotAvailable message and a 502 error
  502: subnet ocid1.subnet.... is out of IPs	Invoking a function returns a FunctionInvokeSubnetOutOfIPs message and a 502 error
  502: subnet ocid1.subnet.... does not exist or Oracle Functions is not authorized to use it	Invoking a function returns a FunctionInvokeSubnetNotAvailable message and a 502 error (due to a subnet issue)
  502: dhcp options ocid1.dhcpoptions.... does not exist or Oracle Functions is not authorized to use it	Invoking a function returns a FunctionInvokeSubnetNotAvailable message and a 502 error (due to a DHCP Options issue)
  504: Container failed to initialize, please ensure you are using the latest fdk and check the logs 'ModuleNotFoundError: No module named 'contextvars'	Invoking a function returns a FunctionInvokeContainerInitFail error message, a 504 error, and a 'ModuleNotFoundError: No module named 'contextvars'' log message
  504: Container failed to initialize, please ensure you are using the latest fdk and check the logs	Invoking a function returns FunctionInvokeContainerInitFail and 'Container initialization timed out' messages, and a 504 error
  504: Timed out	Invoking a function returns a FunctionInvokeTimeout message and a 504 error

• Miscellaneous

  Error number and message (if applicable)	Description and link
  error getting credentials - err: exit status 1, out: Error spawning command line 'dbus-launch --autolaunch...	When running Oracle Functions on Ubuntu, Docker login returns an "error getting credentials - err: exit status 1..." message