Apigee ハイブリッドで Universal Data Collection Agent（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 で例外が発生しました。 |
| エラー | Failed to rename file from file_name to file_name. |
UDCA がファイル名の変更中に UUID を追加するときに例外が発生しました。 |
| 警告 | 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 回試行してから、対象ファイルをデータセットの |
| 警告 | Request request_URI timed out. Aborting request |
指定された非同期のファイル アップロード リクエストがタイムアウトになり、キャンセルされました。 |
| 警告 | Request request_URI failed. Exception
exception |
指定された非同期リクエストが例外で失敗しました。 |
| 警告 | Metrics Computation Failed:
error_message |
UDCA のファイル システム指標の定期的な計算で例外が発生しました。 |
| 警告 | Will attempt to upload api file file_name uncompressed |
UDCA がアップロード前にファイルを圧縮しようとしたときに問題が発生しました。この場合、圧縮されていないファイルがアップロードされます。 |