Elasticsearch的JVM（Java虚拟机）选项配置是优化其性能和稳定性的重要环节。以下是关于如何设置Elasticsearch的JVM选项的详细说明，结合了网页内容和实际操作建议：
---
1.JVM选项文件的使用
Elasticsearch通过JVM选项文件来配置Java虚拟机的行为，这些文件包含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参数，每行一个参数。
• 参数以破折号（`-`）开头。
• 空白行和以`#`开头的注释行将被忽略。
• 不被识别为有效JVM参数的行会导致Elasticsearch启动失败。
版本特定的设置
如果需要为特定版本的Java应用设置，可以在参数前加上版本号或版本范围。例如：
```plaintext
17:-XX:+UseG1GC
```
这表示仅在Java 17版本中启用`UseG1GC`垃圾回收器。
---
2.设置JVM堆大小
JVM堆大小是Elasticsearch性能调优的关键部分。默认情况下，Elasticsearch会根据节点的角色和总内存自动设置堆大小，但也可以手动调整。
调整堆大小
• 最小堆大小（`Xms`）和最大堆大小（`Xmx`）必须设置为相同的值。
• 推荐将堆大小设置为系统总内存的50%以内，以确保Elasticsearch有足够的内存用于堆外缓存和操作系统文件系统缓存。
• 在容器（如Docker）中运行时，堆大小应基于容器的可用内存，而不是宿主机的总内存。
堆大小的限制
• 堆大小还应低于Java的“压缩普通对象指针（OOPs）”阈值，以避免性能下降。通常，26GB是一个安全的上限，某些系统可以支持到30GB。
• 可以通过Elasticsearch日志或节点信息API（`jvm.using_compressed_ordinary_object_pointers`）验证是否启用压缩指针。
配置堆大小
将以下参数添加到`jvm.options.d/`目录下的自定义`.options`文件中：
```plaintext
-Xms2g
-Xmx2g
```
这将堆大小设置为2GB。
---
3.使用环境变量设置JVM选项
虽然在生产环境中推荐使用JVM选项文件，但在开发和测试环境中，可以通过`ES_JAVA_OPTS`环境变量快速设置JVM参数。
设置环境变量
```bash
export ES_JAVA_OPTS="-Xms2g -Xmx2g -Djava.io.tmpdir=/path/to/temp/dir"
./bin/elasticsearch
```
• `ES_JAVA_OPTS`会覆盖所有其他JVM选项。
• 不推荐在生产环境中使用，因为环境变量的设置可能会被意外覆盖或丢失。
---
4.JVM堆转储路径
默认情况下，Elasticsearch会在内存不足异常时将堆转储到默认数据目录。如果需要更改路径，可以在`jvm.options`中设置`-XX:HeapDumpPath`参数。
配置堆转储路径
```plaintext
-XX:HeapDumpPath=/path/to/dump
```
• 如果指定目录，JVM会自动生成文件名。
• 如果指定文件名，该文件在转储时必须不存在，否则会失败。
---
5.JVM日志记录
Elasticsearch默认启用垃圾回收（GC）日志，并将其输出到默认日志目录。可以通过JEP 158（统一JVM日志框架）的选项自定义日志记录。
自定义GC日志路径
创建一个自定义的`.options`文件，例如`gc.options`，并添加以下内容：
```plaintext
-Xlog:disable
-Xlog:gc*,gc+age=trace,safepoint:file=/path/to/gc.log:utctime,level,pid,tags:filecount=32,filesize=64m
```
• `-Xlog:disable`禁用默认日志配置。
• `-Xlog:gc*`启用GC日志记录，并指定文件路径、格式和其他选项。
---
6.JVM致命错误日志
JVM在遇到致命错误（如段错误）时会生成日志文件。默认情况下，这些日志会写入默认日志目录。如果需要更改路径，可以在`jvm.options`中设置`-XX:ErrorFile`参数。
配置致命错误日志路径
```plaintext
-XX:ErrorFile=/path/to/error.log
```
---
7.注意事项
• 不要修改根`jvm.options`文件：所有自定义设置应通过`jvm.options.d/`目录下的文件完成。
• 测试和验证：在生产环境中应用任何JVM设置之前，应在测试环境中验证其效果。
• 默认设置优先：Elasticsearch的默认JVM设置经过优化，通常适用于大多数场景。除非有明确的性能问题，否则建议使用默认设置。
---
通过合理配置JVM选项，可以显著提升Elasticsearch的性能和稳定性。在实际操作中，建议根据集群的硬件资源、数据量和使用场景进行调整。
在Elasticsearch的配置中，`jvm.options`和`jvm.options.d/`是用于设置JVM选项的两个不同机制，它们在功能和使用方式上有一些重要的区别。以下是它们的主要区别和使用场景：
---
1.`jvm.options`文件
`jvm.options`是Elasticsearch默认的JVM配置文件，它包含了Elasticsearch运行时所需的默认JVM参数。这些参数包括堆大小、垃圾回收策略、日志配置等。
特点
• 默认配置文件：这是Elasticsearch启动时加载的基础JVM配置文件。
• 直接修改：你可以直接编辑`jvm.options`文件来修改默认的JVM设置。
• 全局性：该文件中的设置对整个Elasticsearch实例生效。
• 不推荐直接修改：虽然可以直接编辑，但官方不推荐直接修改`jvm.options`文件，因为这可能会影响后续的升级或维护。
位置
• 对于tar.gz或.zip安装包，`jvm.options`位于`config/`目录下。
• 对于Debian或RPM安装包，`jvm.options`位于`/etc/elasticsearch/`目录下。
---
2.`jvm.options.d/`目录
`jvm.options.d/`是一个目录，用于存放用户自定义的JVM选项文件。这些文件可以覆盖或扩展`jvm.options`中的默认设置。
特点
• 扩展性和灵活性：用户可以通过创建多个自定义的`.options`文件来覆盖或扩展默认的JVM设置。
• 文件分割：可以将不同的JVM设置分到多个文件中，便于管理和维护。
• 加载顺序：`jvm.options.d/`目录中的文件会按字典顺序加载。如果存在重复的设置，后面的文件会覆盖前面的设置。
• 推荐使用方式：官方推荐使用`jvm.options.d/`来添加自定义设置，而不是直接修改`jvm.options`文件。
位置
• 对于tar.gz或.zip安装包，`jvm.options.d/`位于`config/`目录下。
• 对于Debian或RPM安装包，`jvm.options.d/`位于`/etc/elasticsearch/`目录下。
• 对于Docker容器，可以将自定义的`.options`文件挂载到`/usr/share/elasticsearch/config/jvm.options.d/`目录下。
---
3.使用场景和区别
直接修改`jvm.options`
• 优点：简单直接，适合快速修改默认设置。
• 缺点：不便于管理，可能会影响后续的升级或维护。如果需要覆盖默认设置，可能会导致配置冲突。
使用`jvm.options.d/`
• 优点：
• 灵活性：可以将不同的设置分到多个文件中，便于管理。
• 可维护性：便于版本控制和升级。
• 覆盖默认设置：可以通过自定义文件覆盖`jvm.options`中的默认设置。
• 缺点：需要额外的文件管理，但这种复杂性通常可以通过清晰的文件命名和注释来解决。
加载顺序
• Elasticsearch启动时，会先加载`jvm.options`文件，然后按字典顺序加载`jvm.options.d/`目录中的所有`.options`文件。
• 如果`jvm.options.d/`中的设置与`jvm.options`中的设置冲突，`jvm.options.d/`中的设置将覆盖`jvm.options`中的设置。
---
4.示例
直接修改`jvm.options`
假设你需要将堆大小从默认值改为2GB，可以直接编辑`jvm.options`文件，将以下内容替换为：
```plaintext
-Xms2g
-Xmx2g
```
使用`jvm.options.d/`
创建一个名为`custom.heap.options`的文件，内容如下：
```plaintext
-Xms2g
-Xmx2g
```
然后将该文件放置在`jvm.options.d/`目录下。这种方式不会直接修改默认的`jvm.options`文件，而是通过扩展的方式覆盖默认设置。
---
总结
• `jvm.options`：默认的JVM配置文件，适合快速修改，但不推荐直接编辑。
• `jvm.options.d/`：推荐的自定义设置方式，提供更高的灵活性和可维护性。
在实际使用中，建议优先使用`jvm.options.d/`目录来管理自定义的JVM设置，以避免直接修改默认配置文件带来的潜在问题。
