OCI Functionsのトラブルシューティング
OCI Functionsの問題をトラブルシューティングする方法、および一般的な問題に対する考えられる解決策をご覧ください。
このトピックでは、OCIファンクションに関連する一般的な問題と、その解決方法について説明します。
次の手法を使用して、エラーまたは問題の詳細を確認します。
- コンソールの「メトリック」ページの「エラー」チャートを使用して、個々のファンクションのエラー・コードおよびメッセージを表示します:ファンクションが呼び出されたときに正常に実行されないか、正常に実行されない場合は、コンソールの「メトリック」ページの「エラー」チャートを使用して、そのファンクションのエラー・コードおよびエラー・メッセージを表示できます。詳細は、ファンクション・メトリックを参照してください
- トレースを使用したファンクションの実行の確認:ファンクションの起動時にファンクションが実行されないか、予期したとおりに実行されない場合は、トレースを使用して実行およびパフォーマンスの問題をデバッグできます。トレースを使用するには、関数を含むアプリケーションのトレースを有効にしてから、1つ以上の関数のトレースを有効にする必要があります。その後、APMトレース・エクスプローラでファンクション・トレースを表示できます。詳細は、「ファンクションの分散トレース」を参照してください。
- ファンクション・ログを使用してファンクション呼出し情報を確認します: Oracle Cloud Infrastructure Loggingサービスは、ファンクション・ログへのアクセス、検索および格納を行うデフォルトかつ推奨のオプションです。ファンクションのログを格納および表示するには、そのファンクションにprint文が含まれる必要があることに注意してください。詳細は、ファンクション・ログの格納および表示に関する項を参照してください。
-
DEBUG=1を使用して、OCI Functionsサービスとの間で送受信されるリクエストおよびレスポンスの詳細を表示します: Fn Project CLIコマンドの使用時に予期しないエラーが発生した場合、OCI Functionsサービスとの間で送受信されるHTTPリクエストおよびレスポンスの詳細を確認できます。文字列
DEBUG=1を指定してコマンドを起動し、コマンドを再度実行します。例:$ DEBUG=1 fn invoke helloworld-app helloworld-funcDEBUG=1はコマンドの前に指定する必要があり、DEBUGは大文字にする必要があることに注意してください。Oracle Supportと契約し、サポート・チケットを発行する場合は、出力をチケットに添付できます。
また、ローカル・マシンをOCI Functions開発環境(Fn ProjectのCLIコンテキストで
--provider oracleを指定)として設定した場合は、環境変数OCI_GO_SDK_DEBUG=vを設定し、DEBUG=1でコマンドを起動する必要があります。
このトピックの問題は、次の大まかなカテゴリで構成されています。
一部のトラブルシューティングの問題は、特定の機能ワークフローにのみ適用されます。Docker、Dockerログイン、Dockerプッシュ、イメージ・リポジトリ、イメージ・ダイジェスト、署名済イメージ、またはOracle Cloud Infrastructure Registryからのイメージのプルに関する問題は、イメージベースの機能に適用されます。コードのみの関数に固有の問題については、コードのみの関数のトラブルシューティングを参照してください。
OCI Functionsの設定および実行
| エラー番号とメッセージ(ある場合) | 説明とリンク |
|---|---|
401: Not authenticated
|
FnプロジェクトのCLIコマンドを実行すると、401エラーが返される |
404: Resource is not authorized or not found
|
FnプロジェクトのCLIコマンドを実行すると、404エラーが返される |
x509: decryption password incorrect
|
Fn ProjectのCLIコマンドを実行すると、X509: 復号化パスワードの不正なエラーが返される |
Error response from daemon... unknown: Unauthorized
|
Fn ProjectのCLIでイメージベース関数に対してDocker関連の操作を実行すると、「Error response from daemon... unknown: Unauthorized」メッセージが表示される |
asn1:structure error: tags don't match
|
Fn ProjectのCLIコマンドを実行すると、「Fn: asn 1: 構造エラー: タグが一致しません」メッセージが表示される |
Client version: n.n.nn is not latest: n.n.nn
|
fn versionを実行すると、最新バージョンのFn ProjectのCLIが使用可能であることが表示される |
アプリケーションおよびファンクションの作成
| エラー番号とメッセージ(ある場合) | 説明とリンク |
|---|---|
Unable to create your app, please try again.
|
新規アプリケーションを作成すると、「新規アプリケーション」ダイアログにエラー・メッセージが表示される |
イメージベース関数のデプロイ
ファンクションの呼出し
| エラー番号とメッセージ(ある場合) | 説明とリンク |
|---|---|
|
|
ファンクションを呼び出すと、FunctionInvokeRequestContentTooLargeメッセージおよび413エラーが返されます。 |
|
|
|
444
|
ファンクションを呼び出すと、クライアントはタイムアウトを報告し、ファンクションのログに444エラーが表示されます |
502: Function failed
|
ファンクションを呼び出すと、ファンクションの失敗メッセージおよび502エラーが返されます |
502: Syslog endpoint unavailable
|
ファンクションを呼び出すと、FunctionInvokeSyslogUnavailableメッセージおよび502エラーが返される |
502: Failed to pull function image
|
イメージ・ベースのファンクションを起動すると、FunctionInvokeImageNotAvailableメッセージおよび502エラーが返される |
502: subnet ocid1.subnet.... is out of IPs
|
ファンクションを呼び出すと、FunctionInvokeSubnetOutOfIPsメッセージおよび502エラーが返される |
502: subnet ocid1.subnet.... does not exist or Oracle Functions is not authorized to use it
|
ファンクションを呼び出すと、FunctionInvokeSubnetNotAvailableメッセージおよび502エラー(サブネットの問題による)が返される |
502: dhcp options ocid1.dhcpoptions.... does not exist or Oracle Functions is not authorized to use it
|
ファンクションを呼び出すと、FunctionInvokeSubnetNotAvailableメッセージおよび502エラー(DHCPオプションの問題による)が返される |
|
|
ファンクションを呼び出すと、FunctionInvokeResponseBodyTooLargeメッセージおよび502エラーが戻されます。 |
|
|
ファンクションを呼び出すと、FunctionInvokeResponseHeaderTooLargeメッセージおよび502エラーが戻されます。 |
|
|
ファンクションを呼び出す と、FunctionInvokeSecurityAttributeNotAvailableメッセージおよび502エラーが返される |
|
|
ファンクションを呼び出すと、FunctionInvokeTooManyMatchingDGsメッセージおよび502エラーが戻されます。 |
|
|
ファンクションを呼び出すと、FunctionInvokeExecutionErrorメッセージおよび502エラーが戻されます。 |
|
|
ファンクションを呼び出すと、FunctionInvokeExecutionFailedメッセージおよび502エラーが戻されます。 |
|
|
ファンクションを呼び出すと、FunctionInvokeInvalidResponseメッセージおよび502エラーが戻されます。 |
|
|
ファンクションを呼び出すと、FunctionInvokeSubnetConfigErrorメッセージおよび502エラーが戻されます。 |
|
|
イメージベースのファンクションを呼び出すと、「アプリケーション内のすべてのファンクション・イメージの圧縮されていないサイズが割当て制限を超えました....」メッセージおよび502エラーが返されます。 |
|
|
関数を呼び出すと、FunctionInvokeContainerInitFailエラー・メッセージ、502エラーおよび'ModuleNotFoundError: 'contextvars'という名前のモジュールがありません'ログ・メッセージが返されます |
|
|
ファンクションを呼び出すと、FunctionInvokeServiceUnavailableメッセージおよび503エラーが返されます。 |
504: Container failed to initialize, please ensure you are using the latest fdk and check the logs
|
ファンクションを呼び出すとFunctionInvokeContainerInitTimeoutおよび「コンテナ初期化のタイムアウト」メッセージ、ならびに504エラーが返されます |
504: Timed out
|
ファンクションを呼び出すと、FunctionInvokeTimeoutメッセージおよび504エラーが返される |
|
|
ファンクションを呼び出すと、FunctionInvokeContainerInitTimeoutメッセージおよび504エラーが返されます。 |
|
|
イメージベースのファンクションを呼び出すと、FunctionInvokeImagePullTimeoutメッセージおよび504エラーが返されます。 |
その他
| エラー番号とメッセージ(ある場合) | 説明とリンク |
|---|---|
error getting credentials - err: exit status 1, out: Error spawning command line 'dbus-launch --autolaunch...
|
イメージベース関数用にUbuntu環境を構成すると、Dockerログインによって「error getting credentials - err: exit status 1...」メッセージが返されます。 |