文档中心

Appearance

查询日志与导出业务日志 ​

排查“谁改了配置”时查看操作日志；排查“请求是否到达、为何报错”时查看业务日志。两类日志不能相互替代，也不能当作可恢复的系统备份。

操作前准备 ​

  • 记录问题发生时间、站点、路径及现象，确认问题请求应经过哪台 HiHTTPS 实例。
  • 使用有相应日志权限的账号。默认管理员和审计员可查看操作日志；操作员可查看业务日志，但默认不能查看操作日志，详见管理用户与角色。
  • 确认 HiHTTPS 服务器运行时区；查询和本地筛选日期应使用同一时区。准备受控的日志存放位置，共享前检查敏感内容。
日志适合排查的问题使用说明
操作日志谁修改了服务、证书、用户或系统设置管理员和有相应权限的审计员可查看；当前页面不提供导出按钮
业务日志某个请求是否到达、返回何种状态、代理是否报错按页面提供的条件筛选访问/错误日志，可在权限允许时导出 JSON 或 CSV

查询操作日志 ​

  1. 根据问题发生时间和资源名称确定查询线索，例如“某网站在修改路由后返回错误”。
  2. 进入 审计日志 -> 操作日志，按域名、账号或事件相关关键字查询；默认按时间倒序展示。
  3. 找到对应事件，核对操作者、事件摘要与时间，点击 查看详情 查看记录中的请求或配置快照。

操作日志的事件详情弹窗

  1. 将变更记录与实际服务配置、业务日志对照，确认是否存在配置变更；日志详情不是一份可直接恢复的备份文件。

当前操作日志页面不提供导出按钮。详情中可能有域名、地址或请求内容，向支持人员提供前仍需检查并脱敏，不假定所有敏感数据都已自动处理。

查询与导出业务日志 ​

  1. 进入 审计日志 -> 业务日志。
  2. 选择 日志类型，按需要查看访问日志或错误日志；选择最近 1 天、3 天 或 7 天，填写站点、路径或 IP 等关键字，点击 查询。访问日志还可按 2xx / 3xx / 4xx / 5xx 筛选，错误日志不使用 HTTP 状态分类。

业务日志的筛选条件、列表与导出入口

  1. 对访问记录核对时间、站点、方法、路径、状态、来源 IP 和耗时；对错误记录查看具体错误。返回 502 时可结合错误日志判断后端连接是否失败。
  2. 需要最新记录时点击 刷新。找不到预期记录，先重置过窄的筛选，再检查请求是否真的经过当前实例。列表为空时导出按钮不可用，可先扩大查询范围。
  3. 点击 导出，选择 JSON 或 CSV，核对时间范围后提交。列表与导出共用同一时间范围，在导出弹窗改动天数也会更新列表范围；导出沿用当前日志类型、状态和已提交的关键字条件，而不是把两个时间条件取交集。
  4. 打开下载文件，抽查问题时段和站点是否包含在内；共享前删除不应外发的 IP、请求参数及认证内容。

理解自然日窗口 ​

时间窗口按 HiHTTPS 服务器运行时区的自然日计算：“最近 1 天”从当天 00:00 起，不是向前滚动 24 小时，也不是昨天；“最近 3 天”包括今天及前两天，“最近 7 天”包括今天及前六天。界面不提供任意起止时间或“仅昨天”的直接导出。

例如，要排查昨天 app.example.com 的 5xx，选择访问日志、5xx、最近 3 天，输入域名并点击 查询 后导出，再在本地按日志时间筛选目标日期 00:00 至次日 00:00 的记录。先确认时间戳和目标日期采用同一时区；最终日期筛选不是仅靠页面关键字查询完成。若需分别保留访问和错误日志，应分别选择类型导出。

检查导出格式和范围 ​

导出按所选时间窗口和筛选条件读取，不是只导出当前分页。JSON 文件是数组，CSV 带 UTF-8 BOM；数据较多时可能下载为 .json.gz 或 .csv.gz，应先用支持 gzip 的工具解压，不要把它当作损坏的 CSV 或 ZIP 文件。

导出不是永久日志归档策略，过旧或已清理的数据不会因导出恢复。需要集中接收新的业务日志时，另行对接外部 Syslog。

完成检查 ​

  • 操作日志中的操作者、变更时间和资源与排查对象相符，已将详情与实际配置对照，而不是直接把快照用于恢复。
  • 业务日志导出文件可以打开，时间、站点、类型和筛选条件与所需范围相符，不把导出范围误认为当前页。
  • 排查昨天的记录时，已在包含昨天的自然日窗口内导出，并按同一时区的目标日期完成本地筛选。
  • 对外提供材料前已检查并脱敏 IP、请求参数、认证内容和不应外发的配置。

常见问题与下一步 ​

  • 没有查到预期记录：不等于操作或请求从未发生；先核对时间窗口、筛选条件、账号权限、当前实例及日志保留范围。
  • 导出按钮不可用：先检查列表是否为空；重置过窄条件或扩大时间范围，再确认是否有记录和导出权限。
  • 下载的 CSV 无法直接打开：检查扩展名是否为 .csv.gz，先解压；不要将 gzip 文件当作 ZIP 文件。
  • 业务请求返回 502 或超时：结合错误日志查看网站返回 502 或访问超时。
  • 需要系统级恢复材料：使用系统加密备份，不以日志导出代替备份。