Updated on 2023-12-14 GMT+08:00

Querying Training Job Logs

Function

This API is used to obtain detailed information about training job logs by row.

URI

GET /v1/{project_id}/training-jobs/{job_id}/versions/{version_id}/aom-log

Table 1 describes the required parameters.
Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain a project ID, see Obtaining a Project ID and Name.

job_id

Yes

Long

ID of a training job

version_id

Yes

Long

Version ID of a training job

Table 2 Query parameters

Parameter

Mandatory

Type

Description

base_line

No

String

Base line of the log, which is obtained from an API response. If the value is empty, the latest log is obtained.

lines

No

Integer

Length of the obtained log. The default value is 50 lines. The value range is [0, 500].

log_file

Yes

String

Name of the log file to be viewed. For details about how to obtain the log file name, see Obtaining the Name of a Training Job Log File.

order

No

String

Log query direction

  • desc: Query next records.
  • asc: Query previous records.

Request Body

None

Response Body

Table 3 describes the response parameters.
Table 3 Parameters

Parameter

Type

Description

error_message

String

Error message of a failed API call.

This parameter is not included when the API call succeeds.

error_code

String

Error code of a failed API call. For details, see Error Codes.

This parameter is not included when the API call succeeds.

content

String

Content of the requested log

lines

Integer

Lines of the obtained logs

start_line

String

Start position of the obtained log

end_line

String

End position of the obtained log

is_success

Boolean

Whether the request is successful

Sample Request

The following shows how to obtain the logs contained in log1.log of the job whose job_id is 10 and version_id is 10.

GET    https://endpoint/v1/{project_id}/training-jobs/10/versions/10/aom-log?log_file=log1.log&base_line= 1551252759254000002&lines=50&order=desc

Sample Response

  • Successful response
    {
        "is_success": true,
        "start_line":1551252759254000002,
        "content": "Log string",
        "end_line": "1551252759254000003",
        "lines": "1"
    }
  • Failed response
    {
        "is_success": false,
        "error_message": "Error string",
        "error_code": "ModelArts.0105"
    }

Status Code

For details about the status code, see Status Code.