一、概述

Elasticsearch 是基于 JVM 的搜索和分析引擎。JVM 参数的合理配置直接影响着 Elasticsearch 的性能和稳定性。尽管 Elasticsearch 已经提供了默认的 JVM 设置，但在某些特定场景下，我们可能需要进行适当的调整和优化。

本文将详细讲述如何安全、高效地配置 Elasticsearch JVM 参数，以提高系统性能并保证运行稳定。

二、配置 JVM 参数的方法

Elasticsearch 支持通过 JVM 参数文件和环境变量两种方式来设置 JVM 选项。

1. JVM 参数文件（推荐）

推荐的做法是使用 JVM 参数文件覆盖默认配置：

• 文件扩展名为 .options。
• 文件路径取决于 Elasticsearch 的安装方式：

安装方式	JVM 参数文件路径
tar.gz 或 zip 包	config/jvm.options.d/
Debian 或 RPM 包	/etc/elasticsearch/jvm.options.d/
Docker 容器	/usr/share/elasticsearch/config/jvm.options.d/

例如，设置堆内存为 2GB：

-Xms2g
-Xmx2g

2. 环境变量方式（仅限测试和开发环境）

在生产环境不建议使用环境变量，但测试环境中可采用以下方式：

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

注意：

• Elasticsearch 会忽略 JAVA_TOOL_OPTIONS 和 JAVA_OPTS 变量。
• 使用 ES_JAVA_OPTS 将覆盖所有其他 JVM 设置，因此生产环境避免使用。

三、JVM 参数文件语法规则

JVM 参数文件支持如下语法规则：

• 每个 JVM 参数独占一行，以短横线（-）开头。
• 可以指定特定的 Java 版本：

# 适用于所有版本
-Xmx2g# 仅适用于 Java 17
17:-Xmx2g# 适用于 Java 17 到 18
17-18:-Xmx2g# 适用于 Java 17 及以上版本
17-:-Xmx2g

• 以 # 开头的行视作注释。
• 文件名的字典顺序决定文件加载顺序。

四、设置 JVM 堆内存最佳实践

默认情况下，Elasticsearch 会根据节点角色和总内存自动设置堆大小，官方推荐使用默认配置。但如果需要手动设置，应遵循以下原则：

• 堆内存大小不超过节点总内存的 50%，以便为操作系统文件缓存和 JVM 本身预留足够的空间。
• 当多个 Elasticsearch 节点在同一台主机或容器中运行时，所有节点的堆内存总和不得超过总内存的 50%。
• 建议堆大小不超过 26GB，以保持开启压缩对象指针（compressed ordinary object pointers, OOPs）功能。某些系统最大可设置 30GB，需通过 Elasticsearch 日志或 API 确认：

GET _nodes/_all/jvm

日志示例：

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

合理配置：

-Xms8g
-Xmx8g

五、配置 JVM 堆转储路径

默认情况下，堆内存溢出时会自动转储到 Elasticsearch 日志目录。如果想自定义路径，可在 JVM 参数文件添加：

-XX:HeapDumpPath=/your/custom/path

注意：

• 如果路径指定目录，则 JVM 自动生成文件名。
• 如果路径指定文件名，则在执行堆转储时该文件不得已存在。

六、垃圾回收（GC）日志配置

默认情况下，Elasticsearch 会开启 GC 日志：

• 日志默认保存在 Elasticsearch 日志目录。
• 每个日志文件大小为 64MB，最多占用 2GB 磁盘空间。

若需自定义 GC 日志位置或格式，示例如下：

在 jvm.options.d/gc.options 中：

# 禁用默认GC日志配置
-Xlog:disable# 使用UTC时间，输出警告及以上信息至标准错误流
-Xlog:all=warning:stderr:utctime,level,tags# 自定义 GC 日志位置和详细信息
-Xlog:gc*,gc+age=trace,safepoint:file=/opt/my-app/gc.log:utctime,level,pid,tags:filecount=32,filesize=64m

Docker 容器示例：

MY_OPTS="-Xlog:disable -Xlog:all=warning:stderr:utctime,level,tags -Xlog:gc=debug:stderr:utctime"
docker run -e ES_JAVA_OPTS="$MY_OPTS"

七、JVM 致命错误日志配置

默认情况下，JVM 遇到致命错误（如分段错误）时，会输出到 Elasticsearch 日志目录。若需调整，可通过以下设置：

-XX:ErrorFile=/custom/path/jvm_fatal_error.log

八、性能和稳定性注意事项

• JVM 堆内存过大会导致 GC 停顿更长，降低性能。
• JVM 堆内存设置不合理可能引发节点频繁重启或内存不足（OOM）。
• 强烈建议使用官方推荐的默认设置，仅在明确性能瓶颈和优化需求时再做调整。

九、总结

本文从实际操作出发，全面介绍了 Elasticsearch JVM 参数的配置方法、最佳实践、日志与堆转储路径的设置方法，强调了堆内存设置和 GC 调优的关键点。通过遵循本文的指导，可以有效避免 JVM 配置不当引发的性能问题，确保 Elasticsearch 的高效稳定运行。

以上内容希望能帮助各位在实际的 Elasticsearch 部署和运维中更加得心应手。