重要的 Elasticsearch 配置

Elasticsearch 启动时需要极少的配置，但是在生产环境中使用集群之前，有许多项是必须考虑的。

我们的 Elastic Cloud 服务会自动配置这些项，使您的集群在默认情况下即可用于生产环境。

Elasticsearch 将您索引的数据写入到索引和数据流的 data 目录中。Elasticsearch 将其自己的应用程序日志（其中包含有关集群健康状况和操作的信息）写入到 logs 目录中。

对于 macOS .tar.gz、 Linux .tar.gz 和 Windows .zip 安装，默认情况下 data 和 logs 是 $ES_HOME 的子目录。但是，$ES_HOME 中的文件在升级期间有被删除的风险。

在生产环境中，我们强烈建议您在 elasticsearch.yml 中将 path.data 和 path.logs 设置为 $ES_HOME 之外的位置。默认情况下，Docker、Debian 和 RPM 安装会将数据和日志写入到 $ES_HOME 之外的位置。

支持的 path.data 和 path.logs 值因平台而异

path:
  data: /var/data/elasticsearch
  logs: /var/log/elasticsearch

path:
  data: "C:\\Elastic\\Elasticsearch\\data"
  logs: "C:\\Elastic\\Elasticsearch\\logs"

如果需要，您可以在 path.data 中指定多个路径。Elasticsearch 将节点的数据存储在所有提供的路径中，但将每个分片的数据保留在同一路径上。

Elasticsearch 不会跨节点的多个数据路径平衡分片。单个路径中的高磁盘使用率可能会触发整个节点的高磁盘使用率水位线。如果触发，Elasticsearch 将不会向节点添加分片，即使节点的其他路径有可用的磁盘空间。如果需要额外的磁盘空间，我们建议您添加一个新节点而不是额外的数据路径。

path:
  data:
    - /mnt/elasticsearch_1
    - /mnt/elasticsearch_2
    - /mnt/elasticsearch_3

path:
  data:
    - "C:\\Elastic\\Elasticsearch_1"
    - "E:\\Elastic\\Elasticsearch_1"
    - "F:\\Elastic\\Elasticsearch_3"

对多个数据路径的支持已在 7.13 中弃用，并将在未来的版本中删除。

作为多个数据路径的替代方案，您可以使用硬件虚拟化层（如 RAID）或软件虚拟化层（如 Linux 上的逻辑卷管理器 (LVM) 或 Windows 上的存储空间）创建一个跨多个磁盘的文件系统。如果希望在单个计算机上使用多个数据路径，则必须为每个数据路径运行一个节点。

如果您当前在高可用集群中使用多个数据路径，则可以使用类似于滚动重启的过程，在不中断服务的情况下迁移到为每个节点使用单个路径的设置：依次关闭每个节点，并将其替换为一个或多个配置为使用单个数据路径的节点。更详细地说，对于当前具有多个数据路径的每个节点，您应该遵循以下过程。原则上，您可以在滚动升级到 8.0 期间执行此迁移，但我们建议在开始升级之前迁移到单数据路径设置。

您也可以向集群添加一些单数据路径节点，使用分配过滤器将所有数据迁移到这些新节点，然后从集群中删除旧节点。此方法将暂时使集群的大小翻倍，因此只有在您有能力这样扩展集群时才有效。

如果您当前使用多个数据路径，但您的集群不是高可用的，则可以通过拍摄快照、使用所需的配置创建一个新集群并将快照还原到其中来迁移到非弃用的配置。

仅当节点与其他集群中的所有节点共享其 cluster.name 时，节点才能加入集群。默认名称为 elasticsearch，但是您应该将其更改为描述集群用途的适当名称。

cluster.name: logging-prod

Elasticsearch 使用 node.name 作为 Elasticsearch 特定实例的人可读标识符。此名称包含在许多 API 的响应中。节点名称默认为 Elasticsearch 启动时计算机的主机名，但可以在 elasticsearch.yml 中显式配置。

node.name: prod-data-2

默认情况下，Elasticsearch 仅绑定到环回地址，例如 127.0.0.1 和 [::1]。这足以在单个服务器上运行一个或多个节点的集群进行开发和测试，但是弹性生产集群必须涉及其他服务器上的节点。有许多网络设置，但通常您只需要配置 network.host

network.host: 192.168.1.10

在投入生产之前，配置两个重要的发现和集群形成设置，以便集群中的节点可以相互发现并选出一个主节点。

开箱即用，无需任何网络配置，Elasticsearch 将绑定到可用的环回地址并扫描本地端口 9300 到 9305，以便与在同一服务器上运行的其他节点连接。此行为提供自动集群体验，而无需进行任何配置。

当您想与其他主机上的节点组成集群时，请使用静态 discovery.seed_hosts 设置。此设置提供集群中其他符合主节点资格且可能处于活动状态并可联系的节点列表，以便为发现过程提供种子。此设置接受 YAML 序列或集群中所有符合主节点资格的节点的地址数组。每个地址可以是 IP 地址或主机名，该主机名通过 DNS 解析为一个或多个 IP 地址。

discovery.seed_hosts:
   - 192.168.1.10:9300
   - 192.168.1.11 
   - seeds.mydomain.com 
   - [0:0:0:0:0:ffff:c0a8:10c]:9301 

如果您的符合主节点资格的节点没有固定的名称或地址，请使用替代主机提供程序来动态查找其地址。

当您首次启动 Elasticsearch 集群时，集群引导步骤会确定在第一次选举中计算其投票的符合主节点资格的节点集。在开发模式下，如果没有配置任何发现设置，此步骤将由节点本身自动执行。

由于自动引导本质上是不安全的，因此在生产模式下启动新集群时，您必须显式列出在第一次选举中应计算其投票的符合主节点资格的节点。您可以使用每个符合主节点资格的节点上的 cluster.initial_master_nodes 设置来设置此列表。不要在不符合主节点资格的节点上配置此设置。

discovery.seed_hosts:
   - 192.168.1.10:9300
   - 192.168.1.11
   - seeds.mydomain.com
   - [0:0:0:0:0:ffff:c0a8:10c]:9301
cluster.initial_master_nodes: 
   - master-node-a
   - master-node-b
   - master-node-c

请参阅引导集群和发现和集群形成设置。

默认情况下，Elasticsearch 会根据节点的角色和总内存自动设置 JVM 堆大小。我们建议大多数生产环境使用默认大小。

如果需要，您可以通过手动设置 JVM 堆大小来覆盖默认大小。

默认情况下，Elasticsearch 配置 JVM 在内存不足异常时将堆转储到默认数据目录。在RPM和Debian软件包上，数据目录是 /var/lib/elasticsearch。在Linux 和 MacOS以及Windows发行版中，data 目录位于 Elasticsearch 安装的根目录下。

如果此路径不适合接收堆转储，请修改 jvm.options 中的 -XX:HeapDumpPath=... 条目。

默认情况下，Elasticsearch 启用垃圾收集 (GC) 日志。这些日志在 jvm.options 中配置，并输出到与 Elasticsearch 日志相同的默认位置。默认配置每 64 MB 轮换日志，最多可占用 2 GB 的磁盘空间。

您可以使用 JEP 158：统一 JVM 日志记录中描述的命令行选项重新配置 JVM 日志记录。除非您直接更改默认的 jvm.options 文件，否则 Elasticsearch 默认配置将添加到您自己的设置中。要禁用默认配置，请首先通过提供 -Xlog:disable 选项来禁用日志记录，然后提供您自己的命令行选项。这将禁用所有 JVM 日志记录，因此请务必查看可用选项并启用您需要的所有内容。

要查看原始 JEP 中未包含的更多选项，请参阅使用 JVM 统一日志记录框架启用日志记录。

通过创建包含一些示例选项的 $ES_HOME/config/jvm.options.d/gc.options，将默认 GC 日志输出位置更改为 /opt/my-app/gc.log

# Turn off all previous logging configuratons
-Xlog:disable

# Default settings from JEP 158, but with `utctime` instead of `uptime` to match the next line
-Xlog:all=warning:stderr:utctime,level,tags

# Enable GC logging to a custom location with a variety of options
-Xlog:gc*,gc+age=trace,safepoint:file=/opt/my-app/gc.log:utctime,level,pid,tags:filecount=32,filesize=64m

配置 Elasticsearch Docker 容器以将 GC 调试日志发送到标准错误 (stderr)。这让容器编排器处理输出。如果使用 ES_JAVA_OPTS 环境变量，请指定

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

默认情况下，Elasticsearch 使用一个私有临时目录，该目录由启动脚本在系统临时目录下方立即创建。

在某些 Linux 发行版上，如果长时间未访问，系统实用程序将从 /tmp 中清理文件和目录。如果长时间未使用需要临时目录的功能，则此行为可能会导致在 Elasticsearch 运行时删除私有临时目录。如果随后使用了需要此目录的功能，则删除私有临时目录会导致问题。

如果您使用 .deb 或 .rpm 软件包安装 Elasticsearch 并在 systemd 下运行它，则 Elasticsearch 使用的私有临时目录将从定期清理中排除。

如果您打算在 Linux 或 MacOS 上长时间运行 .tar.gz 发行版，请考虑为 Elasticsearch 创建一个专用的临时目录，该目录不在将从中清理旧文件和目录的路径下。此目录应设置权限，以便只有运行 Elasticsearch 的用户才能访问它。然后，在启动 Elasticsearch 之前，将 $ES_TMPDIR 环境变量设置为指向此目录。

默认情况下，Elasticsearch 配置 JVM 将致命错误日志写入默认日志记录目录。在RPM和Debian软件包上，此目录为 /var/log/elasticsearch。在Linux 和 MacOS以及Windows发行版中，logs 目录位于 Elasticsearch 安装的根目录下。

这些是 JVM 在遇到致命错误（例如分段错误）时生成的日志。如果此路径不适合接收日志，请修改 jvm.options 中的 -XX:ErrorFile=... 条目。

在灾难中，快照可以防止永久数据丢失。快照生命周期管理是定期备份集群的最简单方法。有关更多信息，请参阅创建快照。