使用日志排查 Azure Data Box Disk 中的验证问题Use logs to troubleshoot validation issues in Azure Data Box Disk

本文适用于 Azure Data Box Disk。This article applies to Azure Data Box Disk. 本文介绍如何使用日志来排查部署此解决方案时可能会出现的验证问题。The article describes how to use the logs to troubleshoot the validation issues you could see when you deploy this solution.

验证工具日志文件Validation tool log files

使用 验证工具验证磁盘上的数据时,会生成一个 error.xml 文件来记录任何错误。When you validate the data on the disks using the validation tool, an error.xml is generated to log any errors. 该日志文件位于驱动器的 Drive:\DataBoxDiskImport\logs 文件夹中。The log file is located in the Drive:\DataBoxDiskImport\logs folder of your drive. 当你运行验证时,系统会提供错误日志的链接。A link to the error log is provided when you run validation.

如果运行多个会话进行验证,将为每个会话生成一个错误日志。If you run multiple sessions for validation, then one error log is generated per session.

  • 下面是当载入 PageBlob 文件夹的数据未经 512 字节对齐时生成的错误日志示例。Here is a sample of the error log when the data loaded into the PageBlob folder is not 512-bytes aligned. 上传到 PageBlob 的任何数据(例如 VHD 或 VHDX)必须经过 512 字节对齐。Any data uploaded to PageBlob must be 512-bytes aligned, for example, a VHD or VHDX. 此文件中的错误位于 <Errors> 中,警告位于 <Warnings> 中。The errors in this file are in the <Errors> and warnings in <Warnings>.

    <?xml version="1.0" encoding="utf-8"?>
        <ErrorLog Version="2018-10-01">
            <SessionId>session#1</SessionId>
            <ItemType>PageBlob</ItemType>
            <SourceDirectory>D:\Dataset\TestDirectory</SourceDirectory>
            <Errors>
                <Error Code="Not512Aligned">
                    <Description>The file is not 512 bytes aligned.</Description>
                    <List>
                        <File Path="\Practice\myScript.ps1" />
                    </List>
                    <Count>1</Count>
                </Error>
            </Errors>
            <Warnings />
        </ErrorLog>
    
  • 下面是当容器名称无效时生成的错误日志示例。Here is a sample of the error log when the container name is not valid. 在磁盘上的 BlockBlobPageBlobAzureFile 文件夹下创建的文件夹将成为 Azure 存储帐户中的容器。The folder that you create under BlockBlob, PageBlob, or AzureFile folders on the disk becomes a container in your Azure Storage account. 容器的名称必须遵守 Azure 命名约定The name of the container must follow the Azure naming conventions.

    <?xml version="1.0" encoding="utf-8"?>
    <ErrorLog Version="2018-10-01">
        <SessionId>bbsession</SessionId>
        <ItemType>BlockBlob</ItemType>
        <SourceDirectory>E:\BlockBlob</SourceDirectory>
        <Errors>
        <Error Code="InvalidShareContainerFormat">
            <List>
            <Container Name="Azu-reFile" />
            <Container Name="bbcont ainer1" />
            </List>
            <Count>2</Count>
        </Error>
        </Errors>
        <Warnings />
    </ErrorLog>
    

验证工具错误Validation tool errors

下表汇总了 error.xml 中包含的错误以及相应的建议操作。The errors contained in the error.xml with the corresponding recommended actions are summarized in the following table.

错误代码Error code 说明Description 建议的操作Recommended actions
None 已成功验证数据。Successfully validated the data. 不需要执行任何操作。No action is required.
InvalidXmlCharsInPath 无法创建清单文件,因为文件路径包含无效字符。Could not create a manifest file as the file path has characters that are not valid. 请删除这些字符以继续。Remove these characters to proceed.
OpenFileForReadFailed 无法处理文件。Could not process the file. 原因可能是出现访问问题或文件系统损坏。This could be due to an access issue or file system corruption. 由于出错,无法读取文件。Could not read the file due to an error. 错误详细信息已显示在异常中。The error details are in the exception.
Not512Aligned 此文件的格式无效,无法上传到 PageBlob 文件夹。This file is not in a valid format for PageBlob folder. 请仅将 512 字节对齐的数据上传到 PageBlob 文件夹。Only upload data that is 512 bytes aligned to PageBlob folder. 从 PageBlob 文件夹中删除该文件,或将其移到 BlockBlob 文件夹。Remove the file from the PageBlob folder or move it to the BlockBlob folder. 重试验证。Retry the validation.
InvalidBlobPath 文件路径无法根据 Azure Blob 命名约定映射到云中的有效 Blob 路径。File path doesn't map to a valid blob path in cloud as per the Azure Blob naming conventions. 请遵照 Azure 命名准则重命名文件路径。Follow the Azure naming guidelines to rename the file path.
EnumerationError 无法枚举要验证的文件。Could not enumerate the file for validation. 有多种可能的原因会导致此错误。There could be multiple reasons for this error. 最可能的原因是对文件的访问权限有问题。A most likely reason is access to the file.
ShareSizeExceeded 此文件导致 Azure 文件共享大小超过 Azure 限制 (5 TB)。This file caused the Azure file share size to exceed the Azure limit of 5 TB. 请减小共享中的数据大小,使其符合 Azure 对象大小限制Reduce the size of the data in the share so that it conforms to the Azure object size limits. 重试验证。Retry the validation.
AzureFileSizeExceeded 文件大小超过了 Azure 文件大小限制。File size exceeds the Azure File size limits. 请减小文件或数据的大小,使其符合 Azure 对象大小限制Reduce the size of the file or the data so that it conforms to the Azure object size limits. 重试验证。Retry the validation.
BlockBlobSizeExceeded 文件大小超过了 Azure 块 Blob 大小限制。File size exceeds the Azure Block Blob size limits. 请减小文件或数据的大小,使其符合 Azure 对象大小限制Reduce the size of the file or the data so that it conforms to the Azure object size limits. 重试验证。Retry the validation.
ManagedDiskSizeExceeded 文件大小超过了 Azure 托管磁盘大小限制。File size exceeds the Azure Managed Disk size limits. 请减小文件或数据的大小,使其符合 Azure 对象大小限制Reduce the size of the file or the data so that it conforms to the Azure object size limits. 重试验证。Retry the validation.
PageBlobSizeExceeded 文件大小超过了 Azure 托管磁盘大小限制。File size exceeds the Azure Managed Disk size limits. 请减小文件或数据的大小,使其符合 Azure 对象大小限制Reduce the size of the file or the data so that it conforms to the Azure object size limits. 重试验证。Retry the validation.
InvalidShareContainerFormat 目录名称不符合容器或共享的 Azure 命名约定。The directory names do not conform to Azure naming conventions for containers or shares. 在磁盘上现有文件夹下创建的第一个文件夹将成为存储帐户中的容器。The first folder created under the pre-existing folders on the disk becomes a container in your storage account. 此共享或容器名称不符合 Azure 命名约定。This share or container name does not conform to the Azure naming conventions. 请重命名该文件,使其符合 Azure 命名约定Rename the file so that it conforms to Azure naming conventions. 重试验证。Retry the validation.
InvalidBlobNameFormat 文件路径无法根据 Azure Blob 命名约定映射到云中的有效 Blob 路径。File path doesn't map to a valid blob path in cloud as per the Azure Blob naming conventions. 请重命名该文件,使其符合 Azure 命名约定Rename the file so that it conforms to Azure naming conventions. 重试验证。Retry the validation.
InvalidFileNameFormat 文件路径无法根据 Azure 文件命名约定映射到云中的有效文件路径。File path doesn't map to a valid file path in cloud as per the Azure File naming conventions. 请重命名该文件,使其符合 Azure 命名约定Rename the file so that it conforms to Azure naming conventions. 重试验证。Retry the validation.
InvalidDiskNameFormat 文件路径无法根据 Azure 托管磁盘命名约定映射到云中的有效磁盘名称。File path doesn't map to a valid disk name in cloud as per the Azure Managed Disk naming conventions. 请重命名该文件,使其符合 Azure 命名约定Rename the file so that it conforms to Azure naming conventions. 重试验证。Retry the validation.
NotPartOfFileShare 文件的上传路径无效。The upload path for files is not valid. 请将文件上传到 Azure 文件中的文件夹。Upload the files to a folder in Azure Files. 请删除出错文件,并将其上传到预先创建的文件夹。Remove the files in error and upload those files to a precreated folder. 重试验证。Retry the validation.
NonVhdFileNotSupportedForManagedDisk 非 VHD 文件不能作为托管磁盘上传。A non-VHD file can't be uploaded as a managed disk. 请从 ManagedDisk 文件夹中删除非 VHD 文件(因为不支持这些文件),或将其移到 PageBlob 文件夹。Remove the non-VHD files from ManagedDisk folder as these are not supported or move these files to a PageBlob folder. 重试验证。Retry the validation.

后续步骤Next steps