更新时间:2026-11-10 GMT+08:00
分享

日志管理

LakeAgent提供会话日志归档的能力。LakeAgent支持对接华为云LTS(云日志服务),用户配置日志投递参数并开启对接云日志服务 LTS开关后,在每次会话调用结束时,LakeAgent会自动将本次调用的关键信息异步上报到您指定的日志组和日志流,实现会话日志的统一归档与检索,支撑排障、审计和用量统计。

日志配置具有以下特点:

  • 自动归档:每次会话调用结束后,系统自动将本次调用的关键信息异步上报到LTS,无需人工从运行日志中检索。
  • 精确排障:上报日志包含session_id和response_id,可精确定位某一次调用及其完整的消息链。
  • 异步上报:日志上报在后台异步完成,不阻塞会话主流程,不影响对话体验。
  • 开关可配:由管理员控制是否开启日志上报,关闭后立即停止上报。

前提条件

用户已开通华为云云日志服务 LTS。

约束限制

  • 仅具有DAYU Administrator或者Tenant Administrator权限的用户才可以配置日志。
  • 日志上报开关默认为关闭。未开启时,会话日志不会上报到LTS。
  • 开启日志上报前,需先在华为云LTS控制台创建日志组和日志流,LakeAgent不支持自动创建。

配置日志投递

  1. 在华为云云日志服务 LTS中创建日志组和日志流。具体请参见创建日志组和创建日志流。如果已经创建了日志组和日志流,请跳过此步骤执行2.a。
  2. 可选:为了方便进行日志检索,可以配置日志云端结构化解析和创建LTS日志索引。如果不配置也不影响日志投递。

    1. 进入日志流详情页面,配置日志云端结构化解析。具体请参见设置日志云端结构化解析。

      “结构化方法”选择“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日志索引。

      建议保持默认设置,然后单击“自动配置”导入所有字段。

  3. 登录DataArts Studio管理控制台。

    详情请参考访问DataArts Studio实例控制台。

  4. 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
  5. 在左侧导航栏下方单击“设置”。
  6. 在设置页面左侧导航栏选择“日志”。
  7. 单击右侧日志页面中“日志投递配置”后的“编辑”,选择日志组和日志流。
  8. 单击“保存”完成日志配置。

    • 若所选日志组所在的LTS区域与LakeAgent实例部署区域不一致,系统会弹出确认框提示可能存在数据跨境传输风险,确认后方可保存。
    • 日志上报为异步执行,不阻塞会话主流程;上报失败不影响会话的正常返回。
    • 上报日志包含用户输入、Agent回复与工具调用内容,但不包含系统提示词(system prompt)以及Token等密钥信息。
    • 若所选日志组所在区域与LakeAgent实例部署区域不一致,可能涉及数据跨境传输,保存配置时需进行显式确认。

开启和关闭对接云日志服务LTS

  1. 登录DataArts Studio管理控制台。

    详情请参考访问DataArts Studio实例控制台。

  2. 在DataArts Studio控制台首页,选择“LakeAgent”模块,进入LakeAgent页面。
  3. 在左侧导航栏下方单击“设置”。
  4. 在设置页面左侧导航栏选择“日志”。
  5. 在右侧的日志页面打开“对接云日志服务 LTS”开关。

    • 日志上报开关默认为关闭。未开启时,会话日志不会上报到LTS。
    • 关闭日志上报仅停止后续的日志上报,不会删除LTS日志组/日志流中已归档的日志,也不会影响已有会话数据。

相关文档