系统日志
系统日志用于查询 GatewayRuntime 的后台运行记录、用户操作记录、RPC 调用记录（外部系统调用网关的记录）、SQL 执行记录（数据库执行记录）和安全审计记录（登录与权限记录）。排查问题时，通常先查看后台日志确认运行时异常，再结合操作日志或 RPC 日志定位是谁、在什么时间触发了操作。
先看术语
| 术语 | 现场理解 |
|---|---|
| 后台日志 | 网关程序运行日志，用于看服务启停、插件加载、异常和错误堆栈。 |
| 操作日志 | 用户在 Web 页面点击新增、编辑、删除、启停、导入导出等操作的记录。 |
| RPC 日志 | 外部系统或协议入口对网关发起写入、读取、控制等调用的记录。 |
| SQL 日志 | 数据库执行记录，用于排查入库失败、查询慢、导出慢等问题。 |
| 审计日志 | 登录、权限、账号安全相关记录，适合排查谁登录过、权限是否被调整。 |
| Trace / Debug / Info / Warning / Error | 日志详细程度。Trace、Debug 最详细，联调后应恢复到 Info 或按现场要求配置。 |
功能入口
登录 GatewayRuntime Web 后，点击左侧菜单“系统管理 → 系统日志”。
日志页签
| 页签 | 用途 |
|---|---|
| 后台日志 | 查看服务启停、插件加载、运行异常和错误堆栈等运行时日志。 |
| 操作日志 | 查看用户在 Web 页面执行的新增、编辑、删除、启停等操作记录。 |
| RPC日志 | 查看外部系统通过接口或协议入口发起的写入、读取、控制等调用记录。 |
| SQL日志 | 查看数据库 SQL 执行情况、执行耗时、执行结果和错误信息。 |
| 审计日志 | 查看登录审计、权限审计和用户安全审计记录；该页签需要具备审计日志权限。 |
提示
通道日志和设备日志需要在采集页面查看。进入“开发配置 → 采集配置”，切换到“设备显示”，选择设备后打开“通道日志”或“设备日志”页签。
排障顺序
日志很多时，不建议一开始就全局搜索。先按故障现象定位日志类型，再缩小时间范围。
| 故障现象 | 优先查看 |
|---|---|
| 设备离线、变量无值 | 采集配置中的通道日志、设备日志，再看后台日志。 |
| 数据没有转发 | 数据转发页的转发目标日志、转发组日志，再看后台日志。 |
| 页面操作失败 | 操作日志，再看后台日志中的同一时间段异常。 |
| 外部系统写入失败 | RPC 日志，必要时再看设备日志和后台日志。 |
| 登录、权限或账号异常 | 审计日志、操作日志。 |
| 数据库慢或导出失败 | SQL 日志、后台日志。 |
后台日志
后台日志用于查看 GatewayRuntime 自身运行情况。
| 操作项 | 说明 |
|---|---|
| 日志级别 | 按 Trace、Debug、Info、Warning、Error、Critical 等级筛选。 |
| 时间范围 | 限定日志发生时间。 |
| 关键字 | 按日志内容或异常信息搜索。 |
| 查询 / 重置 | 按条件查询，或恢复默认筛选条件。 |
| 导出 | 导出当前查询范围内的日志。 |
| 自动刷新 | 按页面提供的刷新间隔持续更新日志列表。 |
| 详情 | 打开日志详情，查看完整日志内容和异常信息。 |
| 列 | 说明 |
|---|---|
| 时间 | 日志发生时间。 |
| 级别 | 日志级别。 |
| 来源 | 日志来源。 |
| 日志内容 | 日志消息。 |
| 异常信息 | 异常堆栈或错误详情。 |
操作日志
操作日志用于追踪用户在 Web 页面执行的业务操作。
| 筛选项 | 说明 |
|---|---|
| 操作类别 | 按功能类别筛选，例如配置、权限、运行控制等。 |
| 操作名称 | 按具体操作名称筛选。 |
| 操作账号 | 按执行操作的登录账号筛选。 |
| 执行状态 | 筛选成功或失败记录。 |
| 时间范围 | 限定操作发生时间。 |
| 列 | 说明 |
|---|---|
| 时间 | 操作发生时间。 |
| 类别 / 名称 | 操作所属类别和操作名称。 |
| 方法 | 操作调用的方法名称。 |
| 操作账号 | 执行该操作的用户。 |
| IP地址 | 用户访问来源地址。 |
| 状态 | 操作成功或失败。 |
| 消息 | 操作结果说明。 |
点击“详情”可查看请求方式、请求地址、请求参数、处理结果和错误信息。涉及账号、权限或配置调整的问题，应优先保存操作日志详情。
RPC日志
RPC日志用于查看外部系统对网关发起的调用。
| 筛选项 | 说明 |
|---|---|
| 搜索关键字 | 按调用来源、设备、对象、方法或消息搜索。 |
| 状态 | 筛选成功或失败调用。 |
| 时间范围 | 限定调用时间。 |
| 列 | 说明 |
|---|---|
| 时间 | 调用发生时间。 |
| 操作源 | 调用来源，例如外部系统、协议入口或接口调用方。 |
| 操作设备 | 调用关联的设备。 |
| 操作对象 | 被调用的对象。 |
| 操作方法 | 写入、读取或其他调用方法。 |
| 状态 | 调用是否成功。 |
| 消息 | 调用结果或失败原因。 |
SQL日志
SQL日志用于排查数据库访问问题和慢查询。
| 筛选项 | 说明 |
|---|---|
| SQL关键字 | 按 SQL 语句内容搜索。 |
| 状态 | 筛选成功或失败 SQL。 |
| 时间范围 | 限定 SQL 执行时间。 |
| 列 | 说明 |
|---|---|
| 时间 | SQL 执行时间。 |
| 状态 | 执行成功或失败。 |
| 执行时长 | SQL 执行耗时。 |
| SQL语句 | 执行的 SQL 内容。 |
| 错误消息 | 失败时的错误说明。 |
点击“详情”可查看 SQL 参数、执行耗时、影响行数、数据库配置和完整错误信息。
审计日志
审计日志用于追踪登录、权限调整和用户安全事件。
| 审计类型 | 说明 |
|---|---|
| 登录审计 | 查询登录用户名、登录类型、是否成功、失败原因、IP 地址和 User-Agent。 |
| 权限审计 | 查询角色权限变化，包含调整前、调整后和操作人。 |
| 用户安全审计 | 查询用户锁定、解锁、会话撤销、密码相关安全动作。 |
排查建议
| 现象 | 建议检查 |
|---|---|
| 页面操作失败 | 先看操作日志的失败消息，再看后台日志是否有异常堆栈。 |
| 外部系统写入失败 | 查看 RPC日志，确认操作源、目标设备、方法和失败原因。 |
| 数据库响应慢 | 查看 SQL日志的执行时长和 SQL 语句。 |
| 账号异常登录 | 查看审计日志中的登录审计和用户安全审计。 |