› › ›

高级配置

高级配置编辑

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

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

JVM 选项文件必须以 .options 结尾，并包含一个以换行符分隔的 JVM 参数列表。JVM 按字典顺序处理选项文件。

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

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

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

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

在生产环境中，使用 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 环境变量。

默认情况下，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
```
```
GET _nodes/_all/jvm
```

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。

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

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

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

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

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

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