New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« Elasticsearch 中的 Watcher 设置 重要的系统配置 »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›设置 Elasticsearch ›配置 Elasticsearch

高级配置

编辑

高级配置

编辑

通常不建议修改高级设置，这可能会对性能和稳定性产生负面影响。在大多数情况下，建议使用 Elasticsearch 提供的默认值。

设置 JVM 选项

编辑

如果需要，您可以通过添加自定义选项文件（首选）或设置 ES_JAVA_OPTS 环境变量来覆盖默认的 JVM 选项。

JVM 选项文件必须带有后缀 .options，并且包含以换行符分隔的 JVM 参数列表。JVM 进程按照字典顺序处理选项文件。

JVM 选项文件的放置位置取决于安装类型

  • tar.gz 或 .zip：将自定义 JVM 选项文件添加到 config/jvm.options.d/。
  • Debian 或 RPM：将自定义 JVM 选项文件添加到 /etc/elasticsearch/jvm.options.d/。
  • Docker：将自定义 JVM 选项文件绑定挂载到 /usr/share/elasticsearch/config/jvm.options.d/。

不要修改根目录下的 jvm.options 文件。请改用 jvm.options.d/ 中的文件。

JVM 选项语法

编辑

JVM 选项文件包含以换行符分隔的 JVM 参数列表。参数前面有一个破折号 (-)。要将设置应用于特定版本，请在前面加上版本或版本范围，后跟一个冒号。

  • 将设置应用于所有版本

    -Xmx2g

  • 将设置应用于特定版本

    17:-Xmx2g

  • 将设置应用于一系列版本

    17-18:-Xmx2g

    要将设置应用于特定版本和任何更高版本，请省略范围的上限。例如，此设置适用于 Java 8 及更高版本

    17-:-Xmx2g

空行将被忽略。以 # 开头的行被视为注释并被忽略。未注释且未被识别为有效 JVM 参数的行将被拒绝，并且 Elasticsearch 将无法启动。

使用环境变量设置 JVM 选项

编辑

在生产环境中，请使用 JVM 选项文件来覆盖默认设置。在测试和开发环境中，您还可以通过 ES_JAVA_OPTS 环境变量来设置 JVM 选项。

export ES_JAVA_OPTS="$ES_JAVA_OPTS -Djava.io.tmpdir=/path/to/temp/dir"
./bin/elasticsearch

如果您使用的是 RPM 或 Debian 包，则可以在系统配置文件中指定 ES_JAVA_OPTS。

Elasticsearch 会忽略 JAVA_TOOL_OPTIONS 和 JAVA_OPTS 环境变量。

设置 JVM 堆大小

编辑

默认情况下，Elasticsearch 会根据节点的角色和总内存自动设置 JVM 堆大小。建议在大多数生产环境中使用默认大小调整。

要覆盖默认堆大小，请设置最小和最大堆大小设置，Xms 和 Xmx。最小值和最大值必须相同。

堆大小应基于可用的 RAM

  • 将 Xms 和 Xmx 设置为不超过总内存的 50%。Elasticsearch 需要内存用于 JVM 堆以外的目的。例如，Elasticsearch 使用堆外缓冲区进行高效的网络通信，并依赖操作系统的文件系统缓存来高效访问文件。JVM 本身也需要一些内存。Elasticsearch 使用的内存超过使用 Xmx 设置配置的限制是正常的。

    在容器（如 Docker）中运行时，总内存定义为容器可见的内存量，而不是主机上的总系统内存。

  • 将 Xms 和 Xmx 设置为不超过压缩普通对象指针 (oops) 的阈值。确切的阈值有所不同，但在大多数系统上 26GB 是安全的，在某些系统上可以高达 30GB。要验证您是否低于阈值，请检查 Elasticsearch 日志中是否有如下条目

    heap size [1.9gb], compressed ordinary object pointers [true]

    或者使用节点信息 API检查节点的 jvm.using_compressed_ordinary_object_pointers 值

    resp = client.nodes.info(
    node_id="_all",
    metric="jvm",
)
print(resp)
    response = client.nodes.info(
  node_id: '_all',
  metric: 'jvm'
)
puts response
    const response = await client.nodes.info({
  node_id: "_all",
  metric: "jvm",
});
console.log(response);
    GET _nodes/_all/jvm
    Copy as curlTry in Elastic 

Elasticsearch 可用的堆越多，它可用于内部缓存的内存就越多。这会减少操作系统用于文件系统缓存的内存。更大的堆也会导致更长的垃圾回收暂停。

要配置堆大小，请将 Xms 和 Xmx JVM 参数添加到带有扩展名 .options 的自定义 JVM 选项文件中，并将其存储在 jvm.options.d/ 目录中。例如，要将最大堆大小设置为 2GB，请将 Xms 和 Xmx 都设置为 2g

-Xms2g
-Xmx2g

为了进行测试，您还可以使用 ES_JAVA_OPTS 环境变量设置堆大小

ES_JAVA_OPTS="-Xms2g -Xmx2g" ./bin/elasticsearch

ES_JAVA_OPTS 变量会覆盖所有其他 JVM 选项。我们不建议在生产环境中使用 ES_JAVA_OPTS。

如果您以 Windows 服务形式运行 Elasticsearch，则可以使用服务管理器更改堆大小。请参阅在 Windows 上安装 Elasticsearch 并作为服务运行。

启用 Elasticsearch TCP 就绪端口

编辑

此功能处于技术预览阶段，可能会在未来的版本中更改或删除。Elastic 将努力修复任何问题，但技术预览版的功能不受官方 GA 功能的支持 SLA 的约束。

如果配置了，当节点处于就绪状态时，它可以打开一个 TCP 端口。当节点成功加入集群时，该节点被视为就绪。在单节点配置中，当节点能够接受请求时，它就被认为是就绪的。

要启用就绪 TCP 端口，请使用 readiness.port 设置。就绪服务将绑定到所有主机地址。

如果节点离开集群，或者使用Shutdown API将节点标记为关闭，则就绪端口会立即关闭。

成功连接到就绪 TCP 端口表示 Elasticsearch 节点已就绪。当客户端连接到就绪端口时，服务器只会终止套接字连接。不会将数据发送回客户端。如果客户端无法连接到就绪端口，则表示该节点未就绪。

« Elasticsearch 中的 Watcher 设置 重要的系统配置 »