一、概述

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 部署和運維中更加得心應手。