如要排解 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. |
上傳成功後，UCA 會重新排序 /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 收到來自上游服務的錯誤訊息，指出已超過配額。因此，UCA 會略過這個迴圈中的剩餘檔案，並在下一個間隔中重試。 |
| 警告 | 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 在上傳前嘗試壓縮檔案時發生問題。 在這種情況下，系統會上傳未壓縮的檔案。 |