UDCA 記錄

如要排解 Apigee Hybrid 中的 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 次，然後將檔案移至資料集的 /failed 子目錄。
警告 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 嘗試壓縮檔案再上傳時發生問題。 在這種情況下，系統會上傳未壓縮的檔案。