文档首页/ 应用与数据集成平台 ROMA Connect/ API参考/ 数据集成API/ 任务监控管理/ 查询单个任务的日志详情 - ListMonitorLog
更新时间：2025-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询单个任务的日志详情 - ListMonitorLog

功能介绍

查询单个任务的所有日志信息。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v2/{project_id}/fdi/instances/{instance_id}/tasks/{task_id}/monitor-logs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目的ID，获取方式请参见API参考的“附录 > 获取项目ID”章节。

instance_id

是

String

实例ID。

task_id

是

String

任务ID。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

偏移量，表示从此偏移量开始查询，offset从1开始，取0时行为与1一致。

limit

否

Integer

每页显示条目数量，最大数量999，超过999后只返回999。

begin_time

否

Integer

日志查询的起始时间，格式timestamp(ms)，使用UTC时区。

end_time

否

Integer

日志查询的结束时间，格式timestamp(ms)，使用UTC时区。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total

Integer

总数。

size

Integer

当前页日志数量。

entities

Array of TaskMonitorLog objects

任务监控日志当前页元素。
表5 TaskMonitorLog

参数

参数类型

描述

id

String

单次任务执行的跟踪ID。

start_time

Integer

本次执行启动时间，格式timestamp(ms)，使用UTC时区。

dispatch_time

Integer

计划执行时间，格式timestamp(ms)，使用UTC时区。

end_time

Integer

写入结束时间，格式timestamp(ms)，使用UTC时区。

execute_status

String

任务本次执行状态：

  • UNSTARTED(未启动)

  • WAITING(等待调度中)

  • RUNNING(执行中)

  • SUCCESS(执行成功)

  • CANCELLED(任务取消)

  • ERROR(执行异常)

position

String

标识本次任务执行到哪一个阶段：

  • ADAPTER(任务处于初始化阶段)

  • READER(任务正在执行Reader读操作)

  • WRITER(任务正在执行Writer写操作)

position_status

String

任务本次执行当前阶段的状态：

  • NORMAL(正在运行)

  • NODE_END(本节点正常结束)

  • RUNTIME_CANCEL(任务被取消)

  • TASK_END(本任务正常结束)

  • RUNTIME_ERR(运行时异常)

  • INTERNAL_ERR(内部程序异常)

status

Integer

本次任务执行详细状态，状态码划分规则：reader端 100 ~ 499，writer端 500 ~ 899，其他900 ~ ：

  • 16(被强制取消)

  • 99(任务开始)

  • 100(Reader 任务开始)

  • 101(Reader 任务结束)

  • 102(正在读取数据)

  • 103(读端数据源端异常)

  • 104(读取数据结束)

  • 105(读取数据为0)

  • 106(读任务强制取消)

  • 107(在reader plugin中，任务发生了中断)

  • 108(读任务恢复运行)

  • 500(Writer 任务开始)

  • 501(Writer 任务结束)

  • 502(正在数据写入)

  • 503(目标端异常)

  • 504(数据写入结束)

  • 505(写任务强制取消)

  • 506(在writer plugin中，任务发生了中断)

  • 507(写任务恢复运行)

  • 900(接收到调度请求)

  • 901(任务运行结束)

  • 902(任务已运行结束，正在进行数据完整性校验)

  • 903(输出数据完整性校验结果)

  • 904(经过数据完整性校验，发现有数据缺失，正在进行数据补偿)

  • 905(输出数据补偿结果)

  • 906(读取任务正在在排队中（平台资源）)

  • 907(读取任务被拒绝执行，因为上一次调度还没有结束)

  • 908(写入任务正在在排队中（平台资源）)

  • 909(写入任务被拒绝执行，因为上一次调度还没有结束)

  • 911(读取任务没有被正常开启，请检查网络是否通畅，参数是否正确)

  • 912(写入任务没有被正常开启，请检查网络是否通畅，参数是否正确)

  • 913(任务调度请求失败)

  • 914(任务被拒绝执行，因为上一次调度还没有结束)

  • 915(任务不正常运行)

  • 916(任务日志上报异常)

dirty_data_count

Integer

异常数据条数。

data_count

Integer

成功数据条数。

data_size

Number

成功数据大小，浮点数类型。

data_size_unit

String

成功数据大小的计量单位。

spend_time

Integer

执行时长，单位：ms。

read_spend_time

Integer

读取执行时长，单位：ms，只有在定时任务时存在该属性。

write_spend_time

Integer

写入执行时长，单位：ms。

remarks

String

本次执行结果简要信息。

detail_logs

Array of TaskMonitorDetailLog objects

本次执行详细轨迹信息。
表6 TaskMonitorDetailLog

参数

参数类型

描述

id

String

任务每次执行步骤产生的唯一ID。

status

Integer

本次任务执行详细状态，状态码划分规则：reader端 100 ~ 499，writer端 500 ~ 899，其他900 ~ ：

  • 16(被强制取消)

  • 99(任务开始)

  • 100(Reader 任务开始)

  • 101(Reader 任务结束)

  • 102(正在读取数据)

  • 103(读端数据源端异常)

  • 104(读取数据结束)

  • 105(读取数据为0)

  • 106(读任务强制取消)

  • 107(在reader plugin中，任务发生了中断)

  • 108(读任务恢复运行)

  • 500(Writer 任务开始)

  • 501(Writer 任务结束)

  • 502(正在数据写入)

  • 503(目标端异常)

  • 504(数据写入结束)

  • 505(写任务强制取消)

  • 506(在writer plugin中，任务发生了中断)

  • 507(写任务恢复运行)

  • 900(接收到调度请求)

  • 901(任务运行结束)

  • 902(任务已运行结束，正在进行数据完整性校验)

  • 903(输出数据完整性校验结果)

  • 904(经过数据完整性校验，发现有数据缺失，正在进行数据补偿)

  • 905(输出数据补偿结果)

  • 906(读取任务正在在排队中（平台资源）)

  • 907(读取任务被拒绝执行，因为上一次调度还没有结束)

  • 908(写入任务正在在排队中（平台资源）)

  • 909(写入任务被拒绝执行，因为上一次调度还没有结束)

  • 911(读取任务没有被正常开启，请检查网络是否通畅，参数是否正确)

  • 912(写入任务没有被正常开启，请检查网络是否通畅，参数是否正确)

  • 913(任务调度请求失败)

  • 914(任务被拒绝执行，因为上一次调度还没有结束)

  • 915(任务不正常运行)

  • 916(任务日志上报异常)

position

String

标识当前步骤属于哪一个阶段：

  • ADAPTER(任务处于初始化阶段)

  • READER(任务正在执行Reader读操作)

  • WRITER(任务正在执行Writer写操作)

position_status

String

任务当前步骤的状态：

  • NORMAL(正在运行)

  • NODE_END(本节点正常结束)

  • RUNTIME_CANCEL(任务被取消)

  • TASK_END(本任务正常结束)

  • RUNTIME_ERR(运行时异常)

  • INTERNAL_ERR(内部程序异常)

stage

String

标识当前步骤属于哪一个FDI插件，如adapter、apireader、rdbwriter等。

dirty_data_count

Integer

异常数据条数。

data_count

Integer

成功数据条数。

data_size

Number

成功数据大小，浮点数类型。

data_size_unit

String

成功数据大小的计量单位。

spend_time

Integer

执行时长，单位：ms。

remarks

String

执行详细信息。

step_begin_time

Integer

本次步骤启动时间，格式timestamp(ms)，使用UTC时区。

step_end_time

Integer

本次步骤结束时间，格式timestamp(ms)，使用UTC时区。

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

无

响应示例

状态码：200

OK

{
  "total" : 99999,
  "size" : 99999,
  "entities" : [ {
    "id" : "id123456789",
    "start_time" : 1603243428000,
    "dispatch_time" : 1603243428000,
    "end_time" : 1603243428000,
    "execute_status" : "RUNNING",
    "position" : "READER",
    "position_status" : "NORMAL",
    "status" : 504,
    "dirty_data_count" : 0,
    "data_count" : 100,
    "data_size" : 1000,
    "data_size_unit" : "B",
    "spend_time" : 5000,
    "read_spend_time" : 5000,
    "write_spend_time" : 5000,
    "remarks" : "Task execute success",
    "detail_logs" : [ {
      "id" : "id123456789",
      "status" : 500,
      "position" : "READER",
      "position_status" : "NORMAL",
      "stage" : "adapter",
      "dirty_data_count" : 0,
      "data_count" : 100,
      "data_size" : 1000,
      "data_size_unit" : "B",
      "spend_time" : 5000,
      "remarks" : "task start successfully.",
      "step_begin_time" : 1603243428000,
      "step_end_time" : 1603243428000
    } ]
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 任务监控管理