OCI Functionsのトラブルシューティング
OCI関数の問題のトラブルシューティング方法および一般的な問題に対する考えられる解決策をご覧ください。
このトピックでは、OCIファンクションに関連する一般的な問題と、その対処方法について説明します。
エラーまたは問題の詳細を確認するには、次の方法を使用します。
- コンソールの「メトリック」ページの「エラー」チャートを使用して、個々のファンクションのエラー・コードおよびメッセージを表示します:ファンクションを呼び出したときに正常に実行または実行されない場合は、コンソールの「メトリック」ページの「エラー」チャートを使用して、そのファンクションのエラー・コードおよびエラー・メッセージを表示できます。詳細は、ファンクション・メトリックを参照してください。
- トレースを使用してファンクションの実行を監視:ファンクションを呼び出したときにファンクションが実行または期待どおりに実行されない場合、トレースを使用して実行およびパフォーマンスの問題をデバッグできます。トレースを使用するには、その関数を含むアプリケーションのトレースを有効にしてから、1つ以上の関数のトレースを有効にする必要があります。その後、APMトレース・エクスプローラでファンクション・トレースを表示できます。詳細は、ファンクションの分散トレースを参照してください。
- ファンクション・ログを使用したファンクション呼出し情報の確認: Oracle Cloud Infrastructureロギング・サービスは、ファンクション・ログのアクセス、検索および格納を行うデフォルトかつ推奨のオプションです。ファンクションのログを格納および表示するには、そのファンクションにprint文が含まれる必要があることに注意してください。詳細は、「ファンクション・ログの格納および表示」を参照してください。
-
DEBUG= 1を使用して、OCIファンクション・サービスとの間で送受信されるリクエストおよびレスポンスの詳細を表示します: Fn Project CLIコマンドの使用時に予期しないエラーが発生した場合は、OCIファンクション・サービスとの間で送受信されるHTTPリクエストおよびレスポンスの詳細を表示できます。文字列
DEBUG=1を使用してコマンドを起動し、コマンドを再度実行します。例:$ DEBUG=1 fn invoke helloworld-app helloworld-funcDEBUG=1はコマンドの前に指定する必要があり、DEBUGは大文字にする必要があることに注意してください。Oracleサポートに連絡してサポート・チケットを発行する場合は、出力をチケットに添付できます。
OCIファンクション開発環境(Fn ProjectのCLIコンテキストで
--provider oracleを指定)としてローカル・マシンを設定した場合は、環境変数OCI_GO_SDK_DEBUG=vを設定し、DEBUG=1でコマンドを開始する必要があります。
このトピックの問題は、次の幅広いカテゴリで構成されています。
OCIファンクションの設定および実行
| エラー番号およびメッセージ(ある場合) | 説明とリンク |
|---|---|
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が使用可能であることが表示される |
アプリケーションおよびファンクションの作成
| エラー番号およびメッセージ(ある場合) | 説明とリンク |
|---|---|
アプリケーションを作成できません。再試行してください。 |
新規アプリケーションを作成すると、「新規アプリケーション」ダイアログにエラー・メッセージが表示される |
アプリケーションおよびファンクションのデプロイ
| エラー番号およびメッセージ(ある場合) | 説明とリンク |
|---|---|
unauthorized: incorrect username or password |
アプリケーションをデプロイすると、「unauthorized: incorrect username or password」メッセージが返される |
|
|
ファンクションをデプロイすると、「docker pushの実行中にエラーが発生しました。dockerにログインしましたか。」というメッセージが返されます。 |
500: Internal server error |
ファンクションをデプロイすると、ListTriggersメッセージと500エラーが返される |
Image <<image-name> does not exist or you do not have access to use it. |
ファンクションをデプロイすると「イメージが存在しないか、それを使用するためのアクセス権がありません」というメッセージが返される |
401: Missing subnets annotation |
OCI関数にファンクションをデプロイすると、「Fn: Missing subnets Annotation」メッセージが返される |
Function's image architecture 'x86' is incompatible with the application's shape type 'GENERIC_X86_ARM' |
OCI Functionsにファンクションをデプロイすると、「ファンクションのイメージ・アーキテクチャ'x86'に互換性がありません...」というメッセージが返されます |
ファンクションの呼び出し
| エラー番号およびメッセージ(ある場合) | 説明とリンク |
|---|---|
|
|
関数を呼び出すと、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エラーが返される |
|
|
関数を呼び出すと、FunctionInvokeTooManyMatchingDGsメッセージおよび502エラーが返されます。 |
|
|
ファンクションを呼び出すと、FunctionInvokeExecutionErrorメッセージおよび502エラーが返される |
|
|
ファンクションを呼び出すと、FunctionInvokeExecutionFailedメッセージおよび502エラーが返される |
|
|
ファンクションを呼び出すと、FunctionInvokeInvalidResponseメッセージおよび502エラーが返される |
|
|
ファンクションを呼び出すと、FunctionInvokeSubnetConfigErrorメッセージおよび502エラーが返されます |
|
|
ファンクションを呼び出すと、FunctionInvokeServiceUnavailableメッセージおよび503エラーが返される |
|
|
ファンクションを呼び出すと、FunctionInvokeContainerInitFailエラー・メッセージ、504エラーおよび'ModuleNotFoundError: No module named 'contextvars'ログ・メッセージが返されます |
504: Container failed to initialize, please ensure you are using the latest fdk and check the logs |
ファンクションを呼び出すとFunctionInvokeContainerInitFailおよび「コンテナ初期化のタイムアウト」メッセージ、ならびに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でOCIファンクションを実行すると、Dockerログインで「error法: exit status 1...」メッセージが返される |