共用方式為


在 AzCopy 中使用記錄檔和計畫檔案,尋找錯誤並繼續工作

AzCopy 是命令列工具,您可以用來將 Blob 或檔案複製到儲存帳戶中,或從儲存帳戶中複製檔案。 本文可協助您使用記錄檔來診斷錯誤,然後使用計畫檔案來繼續工作。 本文也說明如何藉由變更詳細程度來設定記錄和計畫檔案,以及如何設定這些檔案的預設儲存位置。

備註

如需協助您開始使用 AzCopy 的內容,請參閱開始 使用 AzCopy。 本文適用於 AzCopy V10,因為這是目前支援的 AzCopy 版本。 如果您需要使用舊版的 AzCopy,請參閱使用舊版的 AzCopy

記錄檔和計畫檔案

AzCopy 會建立每個工作的記錄計畫檔案。 您可以使用這些記錄來調查任何可能的問題並進行疑難排解。

記錄包含失敗狀態 (UPLOADFAILEDCOPYFAILED和 )、 DOWNLOADFAILED完整路徑和失敗原因。

根據預設,記錄檔和計畫檔案位於 Windows 上的 %USERPROFILE%\.azcopy 目錄中 (在 Mac 和 Linux 上則位於 $HOME$\.azcopy 目錄中),但您可以變更該位置。

相關錯誤不一定是出現在檔案中的第一個錯誤。 對於網路錯誤、逾時和伺服器忙碌錯誤等錯誤,AzCopy 最多會重試 20 次,而且重試程式通常會成功。 您看到的第一個錯誤可能無傷大雅,且已重試成功。 因此,與其查看檔案中的第一個錯誤,不如尋找 UPLOADFAILEDCOPYFAILEDDOWNLOADFAILED 附近的錯誤。

這很重要

向 Microsoft 支援服務提交要求 (或針對需要任何協力廠商協助的問題進行疑難排解) 時,請分享您要執行的編校版本命令。 此版本可確保 SAS 不會意外與任何人共用。 您可以在記錄檔開頭找到編校的版本。

檢閱記錄以了解錯誤

以下命令會從04dc9ca9-158f-7945-5933-564021086c79記錄檔中取得所有具有UPLOADFAILED狀態的錯誤:

Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log

檢視和繼續作業

每次傳輸操作會產生一個 AzCopy 任務。 使用下列命令檢視作業的歷程記錄:

azcopy jobs list

若要檢視作業統計資料,請使用下列命令:

azcopy jobs show <job-id>

若要依狀態篩選傳輸,請使用下列命令:

azcopy jobs show <job-id> --with-status=Failed

小提示

--with-status 旗標的值要區分大小寫。

使用下列命令來繼續失敗或取消的工作。 此命令會使用作業識別碼和 SAS 權杖,因為基於安全性原因,它不會持續存在:

azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"

小提示

以單引號 ('') 括住路徑引數,例如 SAS 權杖。 除了 Windows 命令殼層 (cmd.exe) 以外,在所有命令殼層中使用單引號。 如果您使用 Windows 命令殼層 (cmd.exe),請使用雙引號 ("") 括住路徑引數,而非單引號 ('')。

繼續工作時,AzCopy 會查看工作計畫檔。 計畫檔會列出第一次建立工作時系統識別出要處理的所有檔案。 當您繼續作業時,AzCopy 會嘗試傳輸方案檔案中列出且尚未傳輸的所有檔案。

變更計畫檔的位置

使用下列命令。

export AZCOPY_JOB_PLAN_LOCATION=<value>

變更記錄檔的位置

使用下列命令。

export AZCOPY_LOG_LOCATION=<value>

變更預設記錄層級

根據預設,AzCopy 會將記錄層級設定為 INFO。 若要減少記錄詳細程度並節省磁碟空間,請使用選項 --log-level 來覆寫此設定。

可用記錄層級如下:DEBUGINFOWARNINGERRORNONE

移除方案檔案和記錄檔

若要從本機電腦移除所有計劃和記錄檔並節省磁碟空間,請使用命令 azcopy jobs clean

若要只移除一個工作的計劃和日誌檔,請使用 azcopy jobs rm <job-id>。 將此範例中的 <job-id> 預留位置取代為作業的作業識別碼。

另請參閱