查询实例日志
更新时间：2025-12-11
接口描述
可以根据任务实例查询日志内容
权限说明
用户查询工作空间下特定工作流WORKFLOW特定工作流实例的日志详情，需具有以下任一权限
- 查看工作流的权限: 查看
VIEW - 运行工作流的权限: 运行
EXECUTE - 编辑工作流的权限：编辑
MODIFY - 管理工作流的权限：管理
MANAGE
请求结构
Plain Text
1GET /api/databuilder/v2/workspaces/${workspaceId}/execution/${runId}/log HTTP/1.1
2Host: databuilder.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域
请求参数
| 参数名 | 类型 | 是否必填 | 参数位置 | 说明 |
|---|---|---|---|---|
| workspaceId | String | 是 | PATH | 工作空间 |
| runId | String | 是 | PATH | 任务实例ID（工作流对应ins_Id，集成任务对应运行Id，即runId） |
| jobType | Enum | 是 | 查询请求 | WORKFLOW、INTEGRATION |
| taskId | String | 否 | 查询请求 | 工作流任务节点ID（当jobType=WORKFLOW时，必传） |
| logType | Enum | 否 | 查询请求 | 日志类型，RUN（运行日志）、SUBMIT（提交日志） |
| moduleName | String | 否 | 查询请求 | 日志模块名称 |
| marker | String | 否 | 查询请求 | 日志分页参数，默认值为空字符串 |
| startDateTime | DateTime | 否 | 查询请求 | 起始日期时间，包括起始时间，支持yyyy-MM-dd HH:mm:ss 或 yyyy-MM-dd HH:mm:ss.SSS格式，时区为东八区 |
| endDateTime | DateTime | 否 | 查询请求 | 结束日期时间，不包括结束时间，支持yyyy-MM-dd HH:mm:ss 或 yyyy-MM-dd HH:mm:ss.SSS格式，时区为东八区场景传参提示：日志在不断生成的过程中，用户在页面上停留了较长时间后，按时间范围查询时，为了能够一致连续获取后续日志，需要更新 endDateTime 参数值，marker 正常向后滑动，其他参数保持不变。 |
| sort | Enum | 否 | 查询请求 | 默认为asc；asc：从前往后顺序拉日志 desc：从后往前拉日志 |
| limit | int | 否 | 查询请求 | 返回最大行数，默认100条，最大值为 1000当为-1时为下载日志，下载时限制100w条数据 |
| level | Enum | 否 | 查询请求 | 日志级别，枚举值{"TRACE", "DEBUG", "INFO", "WARN", "ERROR"}，默认为INFO |
| keywords | String | 否· | 查询请求 | 系统支持基于分词的关键词搜索，默认查询全部数据，并采用前缀匹配方式。支持多个关键词的前缀匹配组合搜索。关键词不支持特殊字符的搜索 （\t \n \r " # & ' ( ) , / : ; < = > ? @ [ \ ] { | }） |
响应头域
除公共头域外，无其它特殊头域
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求ID |
| code | String | 返回码 |
| result | Result | 返回结果 |
| message | String | 错误信息，仅当有报错时才有值 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| AccessDenied | 无操作权限 | 403 | 暂无操作权限 |
请求示例
Plain Text
1GET /api/databuilder/v2/workspaces/ws_12345/execution/run_20251023_001/log
2?jobType=WORKFLOW
3&taskId=tid-0
4&limit=100
5&sort=asc响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3Transfer-Encoding: chunked
4Date: Mon, 28 Jul 2025 05:36:55 GMT
5Keep-Alive: timeout=180
6Connection: keep-alive
7{
8 "requestId": "2764bde1-48b5-4060-ae1d-ed1b9a717614",
9 "code": "SUCCESS",
10 "result": {
11 "nextMarker": "CI7o8KOqMxCBgJTo8KOqMxgFIAE",
12 "rows": [
13 {
14 "logTime": "2025-11-21 11:34:33,032",
15 "content": "prepare to submit ray task: ray_9a7cff43866b8aeb",
16 "level": "INFO"
17 },
18 {
19 "logTime": "2025-11-21 11:34:33,167",
20 "content": "job_manager.py:527 -- Runtime env is setting up.",
21 "level": "INFO"
22 },
23 {
24 "logTime": "2025-11-21 11:34:33,179",
25 "content": "success to submit ray task: ray_9a7cff43866b8aeb",
26 "level": "INFO"
27 },
28 {
29 "logTime": "2025-11-21 11:34:35,431",
30 "content": "prepare to submit ray task: ray_task_ea72714b",
31 "level": "INFO"
32 },
33 {
34 "logTime": "2025-11-21 11:34:35,431",
35 "content": "worker.py:1458 -- Using address 10.0.8.43:6379 set in the environment variable RAY_ADDRESS",
36 "level": "INFO"
37 },
38 {
39 "logTime": "2025-11-21 11:34:35,432",
40 "content": "worker.py:1598 -- Connecting to existing Ray cluster at address: 10.0.8.43:6379...",
41 "level": "INFO"
42 },
43 {
44 "logTime": "2025-11-21 11:34:35,438",
45 "content":"worker.py:1774 -- Connected to Ray cluster. View the dashboard at [1m[32m10.0.8.43:8265 [39m[22m\n(write_table pid=618378) Catalog kwargs: None",
46 "level": "INFO"
47 },
48 {
49 "logTime": "2025-11-21 11:34:41.234",
50 "content": "(write_table pid=618378) Reducing the parallelism to 3, as that is thenumber of files\n(write_table pid=618378) Catalog kwargs: None\n(write_table pid=618378) Reducing the parallelism to 3, as that is thenumber of files\n(write_table pid=618378) Starting execution of Dataset. Full logs are in /tmp/ray/session_2025-11-19_20-19-24_073474_1/logs/ray-data\n(write_table pid=618378) Execution plan of Dataset: InputDataBuffer[Input] -> TaskPoolMapOperator[ReadIceberg] -> TaskPoolMapOperator[Map(<lambda>)->Write]\n(write_table pid=618378) Reducing the parallelism to 3, as that is thenumber of files",
51 "level": "INFO"
52 },
53 {
54 "logTime": "2025-11-21 11:34:43,317",
55 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
56 "level": "INFO"
57 },
58 {
59 "logTime": "2025-11-21 11:34:48,275",
60 "content": "write task finished: ray_task_ea72714b, result=None",
61 "level": "INFO"
62 },
63 {
64 "logTime": "2025-11-21 11:34:51.238",
65 "content": "(write_table pid=618378) logical_plan: Read[ReadIceberg] -> MapRows[Map(<lambda>)] -> Write[Write]\n(write_table pid=618378) lineage event: {\"version\": \"1.0.0\", \"eventType\": \"COMPLETE\", \"eventTime\": 1763696087291, \"type\": \"RAY\", \"metastoreId\": \"ab41d4e8f7d13aed\", \"accountId\": \"87fdfba4596e4fe8afbf0556064e6542\", \"userId\": \"35f6a613adb04aaaba98b9e4417c0318\", \"job\": {\"workspaceId\": \"workspace_9fca_9b9f608ce772\", \"notebookId\": \"\", \"workflowJobId\": \"jid_8a8ab3f61215e636\", \"workflowInstanceId\": \"unknown_82c6321709f527ac_1763696073\"}, \"lineage\": {\"relations\": [{\"input\": \"zhaoxiwen02_test3.test_ray.ex_test_ray2\", \"output\": \"zhaoxiwen02_test3.test_ray.test_ray3\"}], \"inputs\": [{\"asset\": \"zhaoxiwen02_test3.test_ray.ex_test_ray2\"}], \"outputs\": [{\"asset\": \"zhaoxiwen02_test3.test_ray.test_ray3\"}]}}",
66 "level": "INFO"
67 },
68 {
69 "logTime": "2025-11-21 11:34:53,412",
70 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
71 "level": "INFO"
72 },
73 {
74 "logTime": "2025-11-21 11:35:03,524",
75 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
76 "level": "INFO"
77 },
78 {
79 "logTime": "2025-11-21 11:35:13,645",
80 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
81 "level": "INFO"
82 },
83 {
84 "logTime": "2025-11-21 11:35:23,764",
85 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
86 "level": "INFO"
87 },
88 {
89 "logTime": "2025-11-21 11:35:33,885",
90 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
91 "level": "INFO"
92 },
93 {
94 "logTime": "2025-11-21 11:35:43,991",
95 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
96 "level": "INFO"
97 },
98 {
99 "logTime": "2025-11-21 11:35:54,105",
100 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
101 "level": "INFO"
102 },
103 {
104 "logTime": "2025-11-21 11:36:04,217",
105 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
106 "level": "INFO"
107 },
108 {
109 "logTime": "2025-11-21 11:36:14,326",
110 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
111 "level": "INFO"
112 },
113 {
114 "logTime": "2025-11-21 11:36:24,448",
115 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is RUNNING",
116 "level": "INFO"
117 },
118 {
119 "logTime": "2025-11-21 11:36:28,375",
120 "content": "sleep done",
121 "level": "INFO"
122 },
123 {
124 "logTime": "2025-11-21 11:36:34,574",
125 "content": "querying taskDetail for task[unifyTaskId: ray_9a7cff43866b8aeb, dbTaskId: jid_8a8ab3f61215e636-875d3a16a92c331a_tid-0_RAY, dbProcessInstanceId:117083] success, status is SUCCEED",
126 "level": "INFO"
127 }
128 ],
129 "isTruncated": false
130 }
131}