# 日志管理
LakeAgent提供会话日志归档的能力。LakeAgent支持对接华为云LTS（云日志服务），用户配置日志投递参数并开启对接云日志服务 LTS开关后，在每次会话调用结束时，LakeAgent会自动将本次调用的关键信息异步上报到您指定的日志组和日志流，实现会话日志的统一归档与检索，支撑排障、审计和用量统计。
日志配置具有以下特点：
- 自动归档：每次会话调用结束后，系统自动将本次调用的关键信息异步上报到LTS，无需人工从运行日志中检索。
- 精确排障：上报日志包含session_id和response_id，可精确定位某一次调用及其完整的消息链。
- 异步上报：日志上报在后台异步完成，不阻塞会话主流程，不影响对话体验。
- 开关可配：由管理员控制是否开启日志上报，关闭后立即停止上报。
#### 前提条件
用户已开通华为云云日志服务 LTS。
#### 约束限制
- 仅具有DAYU Administrator或者Tenant Administrator权限的用户才可以配置日志。
- 日志上报开关默认为关闭。未开启时，会话日志不会上报到LTS。
- 开启日志上报前，需先在华为云LTS控制台创建日志组和日志流，LakeAgent不支持自动创建。
 
#### 配置日志投递
1. 在华为云云日志服务 LTS中创建日志组和日志流。具体请参见[创建日志组](https://support.huaweicloud.com/usermanual-lts/lts_04_0003.html#section1)和[创建日志流](https://support.huaweicloud.com/usermanual-lts/lts_04_0004.html#section1)。如果已经创建了日志组和日志流，请跳过此步骤执行[2.a]。
2. **可选：** 为了方便进行日志检索，可以配置日志云端结构化解析和创建LTS日志索引。如果不配置也不影响日志投递。
   
   1. 进入日志流详情页面，配置日志云端结构化解析。具体请参见[设置日志云端结构化解析](https://support.huaweicloud.com/usermanual-lts/lts_0823.html)。
      "结构化方法"选择"JSON"。其余参数建议保持默认值。
      示例日志可以参考以下内容设置。
      ```
      {
          "agent_id": "dd97167b873d4a79b2aad54d4370a3bc",
          "assistant_message": "当前时间是 2026-10-30 15:34:27 CST（UTC+8），对应的 UTC 时间为 07:34:27。",
          "domain_id": "",
          "duration_ms": 3455,
          "error_message": "",
          "estimated_cost_usd": "0.0",
          "input_tokens": 32658,
          "instance_id": "dd97167b873d4a79b2aad54d4370a3bc",
          "model": "xxx-4.6",
          "output_tokens": 112,
          "plan_mode": "auto",
          "project_id": "0833a5737480d53b2f25c010dc1a7b88",
          "region": "cn-north-7",
          "response_id": "resp_aacb9af44f4146e7a1fc100ae1d8",
          "session_id": "scheduled:task_1229025e3a48:exec_aa8ca5a586b1",
          "status": "success",
          "timestamp": "2026-10-30T07:34:25.155732+00:00",
          "tool_calls": [
              {
                  "result": "{\"output\": \"2026-10-30 15:34:27 CST (UTC+0800)\\nUTC: 2026-10-30 07:34:27\", \"exit_code\": 0, \"error\": null}",
                  "tool_call_id": "chatcmpl-tool-a1451c5f5d0f1f2f",
                  "tool_name": "terminal"
              }
          ],
          "total_tokens": 32770,
          "trace_id": "req-c54a55c3dc6a",
          "trigger_type": "SCHEDULED_TASK",
          "user_id": "0833a573fe80d5401f6dc010a775xxxx",
          "user_message": "显示当前使时间",
          "user_name": "ei_abcde",
          "workspace": "3ac34d51083f424a8129225edadf6932"
      }
      ```
      
   
   2. 创建LTS日志索引，具体请参见[创建LTS日志索引](https://support.huaweicloud.com/usermanual-lts/lts_05_0008.html)。
      建议保持默认设置，然后单击"自动配置"导入所有字段。
      
   
   
   
   
3. [登录DataArts Studio管理控制台](https://console.huaweicloud.com/dayu/)。
   
   详情请参考[访问DataArts Studio实例控制台](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_0001.html)。
   
   
4. 在DataArts Studio控制台首页，选择"LakeAgent"模块，进入LakeAgent页面。
5. 在左侧导航栏下方单击"设置"。
6. 在设置页面左侧导航栏选择"日志"。
7. 单击右侧日志页面中"日志投递配置"后的"编辑"，选择日志组和日志流。
8. 单击"保存"完成日志配置。 
   ![](https://support.huaweicloud.com/usermanual-dataartsstudio/public_sys-resources/note_3.0-zh-cn.png)
   - 若所选日志组所在的LTS区域与LakeAgent实例部署区域不一致，系统会弹出确认框提示可能存在数据跨境传输风险，确认后方可保存。
   
   - 日志上报为异步执行，不阻塞会话主流程；上报失败不影响会话的正常返回。
   
   - 上报日志包含用户输入、Agent回复与工具调用内容，但不包含系统提示词（system prompt）以及Token等密钥信息。
   
   - 若所选日志组所在区域与LakeAgent实例部署区域不一致，可能涉及数据跨境传输，保存配置时需进行显式确认。
    
   
   
 
#### 开启和关闭对接云日志服务LTS
1. [登录DataArts Studio管理控制台](https://console.huaweicloud.com/dayu/)。
   
   详情请参考[访问DataArts Studio实例控制台](https://support.huaweicloud.com/usermanual-dataartsstudio/dataartsstudio_01_0001.html)。
   
   
2. 在DataArts Studio控制台首页，选择"LakeAgent"模块，进入LakeAgent页面。
3. 在左侧导航栏下方单击"设置"。
4. 在设置页面左侧导航栏选择"日志"。
5. 在右侧的日志页面打开"对接云日志服务 LTS"开关。 
   ![](https://support.huaweicloud.com/usermanual-dataartsstudio/public_sys-resources/note_3.0-zh-cn.png)
   - 日志上报开关默认为关闭。未开启时，会话日志不会上报到LTS。
   
   - 关闭日志上报仅停止后续的日志上报，不会删除LTS日志组/日志流中已归档的日志，也不会影响已有会话数据。
    
   
   
 
