文档首页/ AI开发平台ModelArts/ API参考/ 训练管理/ 查询训练作业指定任务的日志(预览)
更新时间:2025-08-19 GMT+08:00

查询训练作业指定任务的日志(预览)

功能介绍

查询训练作业指定任务的日志(预览)接口用于获取ModelArts平台上指定训练作业任务的日志信息。

该接口适用于以下场景:当用户需要查看特定训练任务的运行日志时,可以通过此接口获取日志预览。使用该接口的前提条件是用户已知训练作业ID和任务ID,并具有查看日志的权限。查询操作完成后,平台将返回包含任务日志的预览信息。若训练作业ID或任务ID不存在、任务未生成日志或用户无权限操作,接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/training-jobs/{training_job_id}/tasks/{task_id}/logs/preview

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

training_job_id

String

参数解释:训练作业ID。

约束限制:获取方法请参见查询训练作业列表

取值范围:不涉及。

默认取值:不涉及。

task_id

String

参数解释:训练作业的任务名称。可从训练作业详情中的status.tasks字段中获取。

约束限制:单节点默认为"worker-0",多节点则为"worker-0"、"worker-1",依次类推。

取值范围:不涉及。

默认取值:不涉及。

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

training_job_id

String

参数解释:训练作业ID。

约束限制:获取方法请参见查询训练作业列表

取值范围:不涉及。

默认取值:不涉及。

task_id

String

参数解释:训练作业的任务名称。可从训练作业详情中的status.tasks字段中获取。

约束限制:单节点默认为"worker-0",多节点则为"worker-0"、"worker-1",依次类推。

取值范围:不涉及。

默认取值:不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

content

String

参数解释:日志内容。如果日志大小没有超过上限(n兆)则返回全部内容,如果日志超过了上限(n兆)则返回最新的n兆的日志。2022/03/01 00:00:00 (GMT+08:00)后,此参数名称由“context”改为“content”。

取值范围:不涉及。

current_size

Integer

参数解释:当前返回的日志大小(单位:字节)。最大为5兆。

取值范围:不涉及。

full_size

Integer

参数解释:完整的日志大小(单位:字节)。

取值范围:不涉及。

请求示例

如下以查询uuid为2cd88daa-31a4-40a8-a58f-d186b0e93e4f的训练作业对应worker-0日志内容为例。

GET https://endpoint/v2/{project_id}/training-jobs/2cd88daa-31a4-40a8-a58f-d186b0e93e4f/tasks/worker-0/logs/preview

响应示例

状态码:200

ok

{
  "content" : "[Modelarts Service Log]collect and upload ascend logs end at 2021-05-18-14:28:13\n[Modelarts Service Log]exiting..:\n [Modelarts Service Log]exiting...\n[Modelarts Service Log]exiting..:\n [Modelarts Service Log]exiting...\n[Modelarts Service Log]exit with :\n [Modelarts Service Log]exit with 0\n[Modelarts Service Log]exit with :\n [Modelarts Service Log]exit with 0\n[ModelArts Service Log][INFO][2021/05/18 14:28:14,207]:\n  output-handler finalizing due to: [training finished]\n[ModelArts Service Log][INFO][2021/05/18 14:28:14,207]:\n  output-handler finalized\n[Modelarts Service Log][sidecar] exiting at 2021-05-18-14:28:14\n[Modelarts Service Log][sidecar] wait python processes exit..:\n  [Modelarts Service Log][sidecar] wait python processes exit...\n[Modelarts Service Log][sidecar] exit with :\n  [Modelarts Service Log][sidecar] exit with 0",
  "current_size" : 126548,
  "full_size" : 5242880
}

状态码

状态码

描述

200

ok

错误码

请参见错误码