后续操作
本文介绍迁移任务创建后的一些后续操作。
查看迁移报告
迁移报告提供详细的迁移结果信息,包括成功、失败和跳过的文件列表,帮助您了解迁移任务的执行情况。
报告文件类型
根据任务执行情况,生成的迁移报告文件分为总迁移文件列表、迁移失败文件列表和迁移跳过文件列表三种。
迁移报告文件命名规则
uid@jobid@runtimeid_total_list_n,代表总迁移文件列表,可能会有多个,其中 n 是一个大于等于 0 的整数
uid@jobid@runtimeid_failed_list_n,代表迁移失败文件列表,可能会有多个,其中 n 是一个大于等于 0 的整数
uid@jobid@runtimeid_skipped_list_n,代表迁移跳过文件列表,可能会有多个,其中 n 是一个大于等于 0 的整数
报告字段说明
迁移报告文件所含字段内容描述了文件(对象)从源到目的地迁移过程中的各种属性,具体包括:
字段名称 | 字段含义 |
源文件名 | 表示源文件的名称,url编码 |
目的文件名 | 表示目标文件的名称,url编码 |
源文件大小 | 表示源文件的大小 |
目的文件大小 | 表示目标文件的大小 |
源文件MD5 | 表示源文件的MD5哈希值,源文件返回MD5时才会有 |
目的文件MD5 | 表示目标文件的MD5哈希值 |
源文件CRC64 | 表示源文件的CRC64哈希值,源文件返回CRC64时才会有 |
目的文件CRC64 | 表示目标文件的CRC64哈希值 |
源文件最后修改时间 | 表示源文件的最后修改时间 |
目的文件最后修改时间 | 表示目标文件的最后修改时间 |
源对象版本ID(只有多版本迁移涉及) | 仅在多版本迁移中使用,用于指示源对象的版本ID |
目的对象版本ID(只有多版本迁移涉及) | 仅在多版本迁移中使用,用于指示目标对象的版本ID |
迁移开始时间 | 记录文件迁移的开始时间 |
迁移结束时间 | 记录文件迁移的结束时间 |
是否异常迁移(false:正常,true:异常) | 一个布尔标志,指示迁移是否异常(false表示正常,true表示异常) |
异常原因 | 提供异常情况的原因说明 |
获取迁移报告
登录在线迁移控制台。
在左侧导航栏,选择在线迁移服务 > 迁移任务。
在迁移任务列表中,单击对应任务的管理,进入任务的详情页面。
若创建任务时选择不推送报告,在任务详情页 >历史,单击生成迁移报告。待迁移报告生成完成后,可单击下载迁移报告到本地。
若创建任务时选择推送报告,在任务详情页 >历史,待报告生成完成,可点击下载迁移报告到本地。
说明在数据迁移任务完成之前,生成的迁移报告内容可能不完整。如需获取完整的迁移报告,请在任务迁移完成后点击下载。
迁移报告仅供参考,以实际迁移完成的内容为准。
迁移报告生成后将被存储在指定的对象存储(OSS)Bucket中。根据任务执行情况,文件夹目录层级的前缀格式如下所示:
OSS://<bucket>/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/total_list/ OSS://<bucket>/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/failed_list/ OSS://<bucket>/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/skipped_list/
路径参数说明
字段名称
字段含义
bucket
目的端bucket
prefix
目的数据地址指定的迁移目录前缀
uid
用户主账号ID
jobid
任务ID(任务详情页 >详情获取)
runtimeid
任务执行记录ID(任务详情页 >历史获取)
在对象存储OSS控制台,找到目的bucket下迁移报告文件,您可以下载这些文件并查看详细的文件列表,推荐使用图形化管理工具ossbrowser 2.0(预览版)或ossutil工具查看。
查看迁移日志
迁移过程的日志可推送至日志服务(SLS),详细记录每个文件在迁移任务中的处理情况,包括迁移成功、失败及跳过的记录。通过迁移日志,可以实时监控迁移进度、快速定位问题文件,并对迁移过程进行审计和故障排查。
日志类型
在线迁移服务会在日志服务SLS中创建名称为aliyun-oss-import-log-阿里云账号ID-当前控制台地域的Project,例如aliyun-oss-import-log-137918634953****-cn-hangzhou。在此Project中可以查看迁移任务的日志,其中包含如下两种日志:
drs_import_success_log:迁移成功日志
drs_import_fail_log:迁移失败日志
日志字段说明
迁移日志中的主要字段说明如下表所示。
字段名称 | 字段含义 |
JobName | 迁移任务的名称 |
JobId | 迁移任务ID |
Region | 当前控制台所在地域 |
Status | 迁移文件的状态。包括如下三种状态:
|
UserId | 用户的UID |
ExecuteId | 执行记录ID |
StartTime | 迁移开始的时间 |
EndTime | 迁移结束的时间 |
ListTime | 该文件被扫描到的时间 |
Time | 当前的时间 |
SrcObjectName | 源端文件名称。以Src开头的是源端相关字段 文件名为URL编码处理后的格式,例如docs%2Fmy.docir%2Fexample.log |
SrcObjectSize | 源端文件大小 |
DestObjectName | 目的端文件名称。以Dest开头的是目的端相关字段 文件名为URL编码处理后的格式,例如docs%2Fmy.docir%2Fexample.log |
DestObjectSize | 目的端文件大小 |
获取迁移日志
您可以将迁移日志实时推送到阿里云日志服务(SLS)中进行查询与分析。在SLS控制台,您可以通过任务ID、文件名等关键词进行精确检索,以监控迁移过程或排查问题。
日志推送功能需要在创建迁移任务时开启(选择推送或仅推送错误日志)。若在创建时选择不推送,则无法在SLS中查看该任务的日志。
迁移日志不保证完整性,请不要将迁移日志用于迁移的完整性检查。
迁移日志仅供您参考,最终迁移结果请以目的端的实际文件为准。
不推送(默认):不推送迁移日志
推送:将迁移日志推送至SLS,可在SLS上查看迁移日志
仅推送文件错误日志:仅将错误迁移日志推送至日志服务SLS,可在SLS上查看错误迁移日志
在选择推送或仅推送文件错误日志前,请确保您已完成以下操作,否则可能导致迁移任务异常:
已开通SLS服务
已在日志服务授权项授权页面中同意授权
当选择推送或仅推送文件错误日志时,在线迁移服务会在日志服务SLS中创建名称为aliyun-oss-import-log-阿里云账号ID-当前迁移服务部署地域的Project,例如aliyun-oss-import-log-137918634953****-cn-hangzhou。
日志服务授权:此选项在迁移日志选择推送或仅推送文件错误日志时显示。
单击授权进入云资源访问授权页面,页面会对应创建AliyunOSSImportSlsAuditRole角色,并对角色做授权,请单击同意授权完成授权。
失败文件重试
当迁移任务结束后,如果报告中显示有部分文件迁移失败,您可以创建一个仅针对这些失败文件进行重试的新子任务。
操作步骤
登录在线迁移控制台。
在顶部菜单栏,选择任务所在的地域。
在左侧导航栏,选择在线迁移服务>迁移任务。
在迁移任务列表中,单击对应任务操作列的管理,进入任务详情页面。
在历史区域下单击对应任务操作列的重试失败文件。
修改子任务名称,单击下一步。
确认迁移带宽、每秒迁移文件数、覆盖方式等参数无误后,单击下一步。
单击确定,子任务会启动并且重新迁移失败的文件。