UDCA のログ

Apigee ハイブリッドで UDCA のトラブルシューティングを行うには、ログファイルを確認します。UDCA ログは stdout/stderr に書き込まれ、kubectl logs コマンドを実行して確認できます。

Kubernetes 管理マシンで、次のコマンドを実行します。

kubectl logs pod_name apigee-udca -n namespace

次の表は、UDCA ログファイルに表示される一般的なエラー メッセージとその意味を示しています。ログメッセージには、タイムスタンプ、場合によってはスタックトレースなど、問題の診断と解決に役立つ情報が含まれます。

エントリのタイプ ログ メッセージ 意味
エラー Failed to create directory for dataset dataset_name 指定されたデータセット用に構成されているディレクトリが存在せず、UDCA がディレクトリを作成できませんでした。設定の権限の問題が原因であると考えられます。

この問題により、UDCA が開始されません。

エラー Shutdown action was interrupted. It is possible that some data will be lost シャットダウンの一環として、UDCA はすべてのファイルをディスクにアップロードしようとします。

このメッセージは、シャットダウンに予想より時間がかかり、一部のデータがアップロードされずに失われる可能性があることを示します。

エラー Scheduled DatasetHandler for dataset dataset_name encountered an exception. 指定されたデータセットに対して操作を実行しようとしましたが、構成されたディレクトリのポーリング中、またはファイルのアップロード中に予期しない例外が発生しました。
エラー Upload failed for file filename. Max Retries exceeded! Moving dir to failed folder. UDCA が指定されたファイルをアップロードできず、そのファイルをデータセットの /failed サブディレクトリに移動しました。
エラー Re-queuing files from failed directory encountered an exception. UDCA は、アップロードが成功した後に、/failed ディレクトリからファイルを再キューします。これで、ネットワークとアップストリームの問題が解決した後に、UDCA はファイルのアップロードを再試行するようになります。

このメッセージは、ファイルの再キュー中に UDCA でエラーが発生したことを示します。

エラー Shutting down datasetHandler encountered an exception. シャットダウン中に UDCA で例外が発生しました。
エラー Failed to move file from directory_name to directory_name. 内部ライフサイクル管理のためにサブディレクトリ間でファイルを移動する際に UDCA で例外が発生しました。
エラー Failed to delete file filename. アップロードが成功した後のファイルの削除中に UDCA で例外が発生しました。
警告 Received 429 - Too many Requests from upstream service. Skipping remaining files in this iteration and will retry again UDCA は、アップストリーム サービスからの割り当てを超過したというエラーを受け取りました。その結果、UDCA はこの反復処理で残りのファイルをスキップし、次の間隔で再試行します。
警告 File upload failed for filename. error_message 返されたエラーのため、UDCA が指定されたファイルをアップロードできませんでした。

UDCA はファイルのアップロードを 3 回試行してから、対象ファイルをデータセットの /failed サブディレクトリに移動します。

警告 Request request_URI timed out. Aborting request 指定された非同期のファイル アップロード リクエストがタイムアウトになり、キャンセルされました。
警告 Request request_URI failed. Exception exception 指定された非同期リクエストは例外で失敗しました。
警告 Metrics Computation Failed: error_message UDCA のファイル システム指標の定期的な計算で例外が発生しました。