跳到主要内容

慢查询日志参考

慢查询日志以 JSON Lines 格式投递，即每行一个 JSON 对象。每一行都是一个独立的 JSON 对象，表示一次操作。以下示例展示了一条 Search 请求对应的慢查询日志记录：

json
{
  "action": "Search",
  "cluster_id": "inxx-xxxxxxxxxxxxxxx",
  "collection": "medium_articles",
  "connection_uid": "453798218345292801",
  "consistency_level": "Bounded",
  "database": "default",
  "error_code": 0,
  "execution_time": "231.4ms",
  "interface": "Grpc",
  "ip": "203.0.113.10",
  "log_type": "SLOW",
  "output_fields": ["title", "author"],
  "partition": null,
  "sdk": "pymilvus",
  "sdk_version": "2.6.0",
  "status": "Success",
  "timestamp": 1776148276827,
  "trace_id": "f89903d701329910380442aa86941be9",
  "user": "key-ibchakktguxxrvvxseoasz"
}

实际使用中，每条记录在 .log 文件中占据一行。以下章节详细说明每个字段。

日志字段 Schema​

字段是否必填类型说明示例
action否string操作名称，例如 Query、Search 或 Hybrid Search。"Search"
cluster_id是string集群的唯一标识符。下游日志管道需要使用该字段。"inxx-xxxxxxxxxxxxxxx"
collection否string当操作作用于某个 collection 时，表示目标 collection。"medium_articles"
connection_uid否string与请求关联的内部连接标识符。"453798218345292801"
consistency_level否string请求使用的一致性级别。"Bounded"
database否string发生该操作的数据库。"default"
error_code否int请求结果码。0 通常表示成功。0
execution_time否string请求的实际执行耗时，用于判断该请求是否应被输出到慢查询日志。"231.4ms"
interface否string请求接口，通常为 Grpc 或 Restful。"Grpc"
ip否string为该请求记录的客户端 IP 地址。"203.0.113.10"
log_type是string日志类别。对于慢查询日志记录，该值为 SLOW。"SLOW"
output_fields否array请求指定的输出字段（如适用）。["title", "author"]
partition否string 或 null目标 partition。未指定 partition 时，该值为 null。null
sdk否string客户端 SDK 名称。"pymilvus"
sdk_version否string客户端 SDK 版本。"2.6.0"
status否string便于阅读的请求状态。"Success"
timestamp是intUnix 毫秒时间戳。对象存储 sink 在生成最终文件路径时需要使用该字段。1776148276827
trace_id否string唯一的请求追踪标识符，用于关联和排查问题。"f89903d701329910380442aa86941be9"
user是string发起请求的用户名或 API key。日志管道过滤也会使用该字段。"key-ibchakktguxxrvvxseoasz"

支持的操作​

当前慢查询日志功能默认支持以下操作：

操作说明
Search向量相似度搜索
HybridSearch带重排的多向量搜索
Query标量过滤查询

文件路径和命名​

慢查询日志文件会上传到对象存储中的 slow 目录下，并在最终对象 key 中使用 UTC 日期和时间。

plaintext
/<Cluster ID>/slow/<Date>/<File name>.log
组成部分格式示例
Cluster ID集群的唯一标识符。inxx-xxxxxxxxxxxxxxx
日志类型目录固定为 slow。slow
日期UTC 日期，格式为 YYYY-MM-DD。2026-04-14
文件名HH:MM:SS-<UUID>.log，使用 UTC 时间。06:31:16-jz5l7D8Q.log

完整路径示例：

plaintext
/inxx-xxxxxxxxxxxxxxx/slow/2026-04-14/06:31:16-jz5l7D8Q.log
Ctrl I