Skip to Content
发布、运维与增长运行日志

日志服务功能与用法

Zion 日志服务提升了系统可观测性，帮助开发者和运维人员快速定位问题、提升开发效率。

日志服务覆盖范围

日志服务记录系统所有关键信息，包括行为流、数据库访问、项目部署发布、AI 运行等。

日志存储周期

日志服务以天数为单位表示存储容量，不同版本项目容量不同：

  • 免费版：1 天
  • 高级版：7 天
  • 专业版：30 天

请结合实际需求选择合适版本。

日志服务入口

在项目详情页点击“运行日志”，或者点击编辑器右上角的日志图标，进入日志服务。

日志查询与分析

日志服务支持多种查询方式，便于精准定位问题：

  • 日志分类：快速查看某类日志
  • 查询条件设置：自定义时间范围、等级、关键字等
  • 柱状图：直观展示日志统计信息，点击可快速设置时间范围
  • 日志详情：点击字段值可快速添加到查询语句

查询语法示例

  • 关键字查询： 
    account
  • 字段查询： 
    requestMethod: POST
  • 模糊查询： 
    traceId: 20241024*
  • 数字范围查询： 
    responseSize: [5000 to 10000]
  • 多条件联合查询： 
    account and status:200 and not requestMethod:GET
  • 多层级字段查询： 
    requestBody.query: mutation*
  • 事件跟踪查询： 
    traceId: "c2ecac0b-cce8-463b-b5d2-7ee7aa8f703020241128114815"

日志分类介绍

  1. 行为流
    日志服务中详细记录了行为流每个节点的运行情况：
  • 每个节点生成两条日志：节点开始时日志、节点结束时日志
  • 代码块中调用 Context.log() 时也会生成一条日志

节点日志字段说明

字段说明
traceId用于事件跟踪查询
nodeType节点的类型
nodeName节点名称
version行为流版本
input节点的输入，包含所有可引用的数据
output节点的运行结果
startAt节点开始时间
endAt节点结束时间

节点在日志中的类型

节点日志中的类型
输入FLOW_START
获取数据QUERY_RECORD
更新数据UPDATE_RECORD
添加数据INSERT_RECORD
删除数据DELETE_RECORD
代码块CUSTUM_CODE
赋予角色ADD_ROLE_TO_ACCOUNT
移除角色REMOVE_ROLE_FROM_ACCOUN
变量赋值UPDATE_GLOBAL_VARIABLES
分支开始BRANCH_SEPARATION
分支结束BRANCH_MERGE

  1. 数据库操作
    记录所有对数据库的操作（增删改），包含触发方式（前端请求、行为流、AI等）及操作的详细内容。

  2. AI
    记录 AI 对话的完整过程，包括大模型型号、消息详情等。

  3. API
    记录 API 请求的详情，包括请求的 Header、Body 等。

  4. 触发器
    记录触发器触发的时间、类型等信息。

  5. 网关
    网关是连接不同网络的中间设备，负责转发数据，让不同系统顺畅交流。在 Zion 平台中，以下请求会经过网关：

    • 前端页面发送给后端的请求
    • 通过 Callback 接收到的请求
    • 因此这个分类下的日志，包含了绝大部分请求，包括数据库的增删改查操作、API、AI 等。不过由于系统限制，在网关日志中只能查看发送出去的请求，无法查看请求的结果。

  6. 部署与发布
    记录每次后端发布、预发布、发布的详情。

  7. GraphQL
    Zion 的后端 API 采用 GraphQL 查询语言，在这个分类下可以看到所有后端的请求。更多内容可前往其官网：GraphQL | A query language for your API 

Last updated on
升级服务器权限