查询训练作业指定任务的日志(预览)
功能介绍
查询训练作业指定任务的日志(预览)接口用于获取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
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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
参数 |
参数类型 |
描述 |
---|---|---|
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 |
错误码
请参见错误码。