文档中心

云搜索服务

日志查询

集群 IP 溯源

云搜索服务提供集群 IP 溯源功能。开启 IP 溯源日志，将会在日志中记录 HTTP/HTTPS 请求来源的 IP 地址，以帮助用户确定有哪些客户端在访问云搜索服务。

OpenSearch 版本

在集群设置中，设置 logger.org.opensearch.http.HttpTracer 的值为 trace，http.tracer.include 中是需要记录源IP的请求路径，http.tracer.exclude 中是不需要记录源 IP 的请求路径，exclude 的优先级高于 include。请求路径需要全匹配，支持（*）通配符表示，（*）表示零个或多个任意字符，但不支持关键字。在定位源 IP 结束后，需要更新 http 日志级别到 info，设置 logger.org.opensearch.http.HttpTracer:info，以避免打印过多日志。

示例：

Elasticsearch 版本（仅 7.10.2）

在集群设置中，设置 logger.org.elasticsearch.http.HttpTracer 的值为 trace，http.tracer.include 中是需要记录源 IP 的请求路径，http.tracer.exclude 中是不需要记录源 IP 的请求路径，exclude 的优先级高于 include。请求路径需要全匹配，支持（*）通配符表示，（*）表示零个或多个任意字符，但不支持关键字。在定位源 IP 结束后，需要更新 HTTP 日志级别到 INFO，设置 logger.org.elasticsearch.http.HttpTracer:info，以避免打印过多日志。

示例：

在云搜索服务日志查询页面查看 IP 溯源日志

日志样例

在日志查询页面，设置日志级别为 TRACE，选择对应的时间段，通过关键字 received 进行搜索，即可看到相应的日志，其中 remoteAddress 即为访问云搜索服务的客户端 IP。具体如下表所示。

客户端类型	访问方式	日志中 remoteAddress 含义
ECS 实例	公网访问	ECS 公网 IP。
ECS 实例		私网访问	ECS 私网 IP。
VKE Pod	公网访问	Node 有公网 IP：Node 公网 IP。 Node 无公网 IP：VPC NAT 网关公网 IP。
VKE Pod		私网访问	Node 私网 IP 或 Pod IP。
VCI Pod	公网访问	VPC NAT 网关公网 IP。
VCI Pod		私网访问	Pod IP。

最近更新时间：2026.03.31 10:37:34

这个页面对您有帮助吗？

有用

无用