查询应用访问日志

配置 ClickHouse 访问日志服务器,并在 Edge Admin 中筛选和导出应用访问日志。

Edge Admin 可以从 ClickHouse 日志服务器查询应用访问日志,并按应用、时间和字段 筛选结果。

此功能在 OpenResty Edge 26.12.1-1 中首次引入。

安装 ClickHouse 和 Vector

查询前,请先按照 使用 Vector 和 ClickHouse 采集 OpenResty Edge 日志 安装和配置采集服务。ClickHouse 部署在独立的数据库服务器上,用于集中存储日志; Vector 部署在每个需要采集日志的网关节点上,将本地日志发送到 ClickHouse。

该文档包含部署包下载、ClickHouse 和 Vector 安装、HTTPS 配置、日志读取权限及 采集验证步骤。请使用版本匹配的部署包,并按文档配置包含 app_id 的 JSON 访问日志格式。确认日志已经写入 ClickHouse 后,再配置下述访问日志查询连接。

配置访问日志服务器

打开 全局配置 > 访问日志服务器配置,开启配置并填写以下内容:

  • ClickHouse 服务端点和数据库名。默认数据库名为 app。
  • 查询用户名和密码。默认用户名为 oredge-reader。密码不会回显;编辑配置时 将密码留空会保留原密码。
  • 是否验证 TLS 证书,以及查询超时时间。

保存后,请确认 Edge Admin 能够连接 ClickHouse,并且查询账号只能访问所需的 日志表。

查询日志

打开目标应用的 访问日志 页面。支持 HTTP、TCP、UDP、SSL、MQTT、MQTTS、 正向代理和 SOCKS5 应用。选择时间范围后执行查询;单次查询最多覆盖 31 天。

可用列和筛选字段由日志表元数据决定。一次查询最多添加 32 个筛选条件,所有条件 之间使用 AND 关系:

  • 文本字段支持精确匹配和 * 通配符;请求内容筛选使用不区分大小写的包含匹配。
  • 数值字段支持 =、>、>=、< 和 <=,同一个数值字段可以添加多个条件。

表格支持每页 20、50 或 100 条记录。Edge Admin 会隐藏内部列和原始数据源列, 并自动使用当前应用 ID 限定查询范围。

导出结果

点击 导出 可以下载与当前应用、时间范围和筛选条件相同的结果。导出文件为 Gzip 压缩的 JSON Lines;每一行是一条 JSON 日志记录。

访问日志可能包含 IP 地址、请求头和业务标识等敏感信息。应限制查询和导出权限, 并按照组织的日志保留策略处理导出文件。