一、概述
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 部署和运维中更加得心应手。