服务端配置

配置概述

以下配置说明可同时应用于单机或者分布式场景。

Milvus 文件结构

成功启动 Milvus 服务后，你可以在 home/$USER/milvus 的路径下看到 Milvus 的文件夹。其中包含以下文件：

  • milvus/db（数据库存储）
  • milvus/logs（日志存储）

  • milvus/conf（设置文件）

    • milvus.yaml（服务设置）

配置修改

编辑配置文件

你可以直接编辑配置文件对配置进行修改。如果修改了配置文件，你必须重启 Milvus 服务来启用新的更改。

  1. $ docker restart <container id>

下面以 Milvus 的系统配置文件 milvus.yaml 为例，演示如何修改日志级别和日志存储路径：

  1. logs:
  2.   level: info
  3.   path: /var/lib/milvus/logs

运行时修改

你可以使用 Milvus 客户端对 milvus.yaml 的配置进行运行时修改。详情请参考客户端参考。

对以下参数的运行时修改是立即生效的：

  • cache 区域

    • cache_size
    • insert_buffer_size

  • gpu 区域

    • enable
    • cache_size
    • gpu_search_threshold
    • search_devices
    • build_index_devices

对于其它参数，你必须重新启动 Milvus 才能使改动生效。

milvus.yaml 参数说明

若有任何疑问，欢迎在 GitHub 上给我们 创建 issue 或是 加入 Slack 社区讨论。

cluster 区域

参数说明类型默认值
enable是否开启集群模式。
  • true：开启集群模式。
  • false：不开启集群模式。
Booleanfalse
role节点的运行模式，可选配置：
  • rw：读写模式
  • ro：只读模式
Rolerw

general 区域

参数说明类型默认值
timezone使用 UTC-x 或 UTC+x 来指定时区。比如，可以使用 UTC+8 来代表中国标准时间。TimezoneUTC+8
meta_uri元数据存储的 URI。可以使用 SQLite（Milvus 单机版本）或者 MySQL（Milvus 分布式版本）来存储元数据。URI 格式为 dialect://username:password@host:port/database。其中，dialect 可以是 sqlite 或者 mysql，其他文字需要替换成实际值。URIsqlite://:@:/

network 区域

参数说明类型默认值
bind.addressMilvus 服务端监听的 IP 地址。IP0.0.0.0
bind.portMilvus 服务端监听的端口号，范围：[1025, 65534]。Integer19530
http.enable是否开启 HTTP 服务。
  • true：开启 HTTP 服务。
  • false：不开启 HTTP 服务。
Booleantrue
http.portMilvus HTTP 服务监听的端口号，范围：[1025, 65534]。Integer19121

storage 区域

参数说明类型默认值
pathMilvus 数据文件（向量文件、索引文件和元数据）的存储路径。Path/var/lib/milvus
auto_flush_intervalMilvus 定期将缓冲区数据落盘的时间间隔（单位为秒），范围：[0, 3600]。如果该值为 0，则关闭定期落盘功能。Integer1

wal 区域

参数说明类型默认值
enable是否开启 WAL（Write-Ahead Logging，预写式日志）。如果启用 WAL，Milvus 会在更改数据之前将所有数据更改写入日志文件。WAL 确保 Milvus 操作的原子性和耐用性。
  • true：开启 WAL。
  • false：不开启 WAL。
Booleantrue
recovery_error_ignore在通过 WAL 执行恢复操作时，是否忽略出现错误的日志。
  • true：Milvus 重启恢复时，忽略错误的日志。
  • false：Milvus 重启恢复时，会因错误的日志启动失败。
Booleanfalse
buffer_sizeWAL 缓冲区大小，范围：64MB ~ 4096MB。建议该值大于单次插入的数据量两倍，以获取更好的性能。格式请见 空间大小的格式。String256MB
path预写式日志文件存储路径。String/var/lib/milvus/wal

cache 区域

参数说明类型默认值
cache_size内存中用于驻留搜索数据的缓存空间大小。cache_size 和 insert_buffer_size 之和不能超过内存总量。格式请见 空间大小的格式。String4GB
insert_buffer_size用于数据导入的缓冲区所使用的内存量。cache_size 和 insert_buffer_size 之和不能超过内存总量。格式请见 空间大小的格式。String1GB
preload_collection在 Milvus 开启时，需要加载的集合列表。
  • 若要加载所有集合，使用 ‘‘ (包含引号)。例如：preload_collection=’‘。
  • 若要加载指定集合，列出需要加载的集合名（用引号包围每个集合名，并用逗号隔开相邻集合）。例如：preload_collection=[‘collection1’,’collection2’]。
StringListN/A

gpu 区域

在该区域选择是否在 Milvus 里启用 GPU 用于搜索和索引创建。同时使用 CPU 和 GPU 可以达到资源的最优利用，在特别大的数据集里做搜索时性能更佳。

若要切换到 CPU-only 模式，只要将 enable 设置为 false。

参数说明类型默认值
enable是否开启 GPU 用于搜索和索引创建。
  • true：开启 GPU。
  • false：不开启 GPU。
Booleanfalse
cache_size显存中用于驻留搜索数据的缓存空间大小。该值不能超过显存总量。格式请见 空间大小的格式。String1GB
gpu_search_threshold使用 GPU 查询的阈值。用 nq 表示单批次查询的向量数，则搜索计算方式如下：
  • nq ≥ gpu_search_threshold：搜索计算只在 GPU 上进行。
  • nq < gpu_search_threshold：搜索计算将在 CPU 和 GPU 上协同进行。
Integer1000
search_devices用于搜索的 GPU 设备，格式为“gpux”。其中“x”是 GPU 的序号，例如“gpu0”。DeviceListgpu0
build_index_devices用于创建索引的 GPU 设备，格式为“gpux”。其中“x”是 GPU 的序号，例如“gpu0”。DeviceListgpu0

在 Milvus 里，创建索引和搜索是两个独立分开的过程，可以只在 CPU，或同时在 CPU 和 GPU 里进行。通过将 GPU 添加至 search_devices 或者 build_index_devices 下方，你可以指定多个 GPU 设备来进行创建索引或搜索。请参考下面的 YAML 示例代码：

  1.     search_devices:
  2.       - gpu0
  3.       - gpu1
  4.     build_index_devices:
  5.       - gpu0
  6.       - gpu1

logs 区域

参数说明类型默认值
level日志打印的最低级别。日志级别：debug < info < warning < error < fatal。Stringdebug
trace.enable是否开启 trace 级别日志打印。
  • true：开启 trace 级别日志打印。
  • false：不开启 trace 级别日志打印。
Booleantrue
path日志存储路径。String/var/lib/milvus/logs
max_log_file_size单个日志文件的大小限制，范围：1024MB ~ 4096MB。格式请见 空间大小的格式。Integer1024MB
log_rotate_num每个日志级别最多保存的文件数量，范围：[0, 1024]。0 代表日志文件数无限制。Integer0

metric_config 区域

参数说明类型默认值
enable是否开启 Prometheus 监控。
  • true：开启 Prometheus 监控。
  • false：不开启 Prometheus 监控。
Booleanfalse
address访问 Prometheus Pushgateway 的 IP 地址。IP127.0.0.1
port访问 Prometheus Pushgateway 的端口号。范围：[1025, 65534]。Integer9091

在 Milvus 配置文件中，空间大小的格式为“数字+单位”，如“4GB”。

  • 数字和单位之间没有空格。
  • 数字必须是整数。
  • 可选单位为 GB、MB、KB。

常见问题

除了配置文件外，怎样可以判断我确实在使用 GPU 做搜索？

有以下三种方式：

如果设置了 preload_collection，必须是等集合全部加载到内存，服务才能访问吗？ 是的。如果是在 milvus.yaml 里设置的，那在启动 Milvus 时就会加载好数据后才开始提供服务。 为什么查询时 GPU 一直空闲？

此时应该是在用 CPU 进行查询。如果要用 GPU 进行查询，需要在配置文件中将 gpu_search_threshold 的值设置为小于 nq (每次查询的向量条数) 。可以将 gpu_search_threshold 的值调整为期望开启 GPU 搜索的 nq 数。若 nq 小于该值，则用 CPU 查询，否则将使用 GPU 查询。不建议在查询批量较小时使用 GPU 搜索。

为什么我的日志文件时间与系统时间不一致？ Docker 镜像内部的日志文件默认使用 UTC 时间。如果宿主机未使用 UTC 时间，就会出现日志文件时间与系统时间不一致的情况。建议在宿主机上挂载日志文件，这样可以保证宿主机上的日志文件和系统时间是一致的。