查询应用访问日志
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 地址、请求头和业务标识等敏感信息。应限制查询和导出权限, 并按照组织的日志保留策略处理导出文件。