Elasticsearch 通知设置
此页面记录了将 Elasticsearch 服务配置为目标的设置存储桶通知.发布事件到 Elasticsearch有关使用这些设置的教程。
您可以通过定义以下内容来建立或修改设置：
an 环境变量在启动或重启 MinIO 服务器之前，请在主机系统上设置此环境变量。 有关如何定义环境变量，请参阅操作系统的文档。
a 配置设置使用
mc admin config set.
如果您同时定义了环境变量和类似的配置设置，MinIO 将使用环境变量的值。
某些设置只有环境变量或配置设置，但没有两者都提供。
重要
每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前，先在较低环境（如开发环境或测试环境）中测试配置变更。
多个 Elasticsearch 目标
您可以通过附加唯一标识符来指定多个 Elasticsearch 服务端点_ID对于每组相关设置。
例如，以下命令设置两个不同的 Elasticsearch 服务端点作为PRIMARY和SECONDARY分别：
示例
export MINIO_NOTIFY_ELASTICSEARCH_ENABLE_PRIMARY="on"
export MINIO_NOTIFY_ELASTICSEARCH_URL_PRIMARY="https://user:password@elasticsearch-endpoint.example.net:9200"
export MINIO_NOTIFY_ELASTICSEARCH_INDEX_PRIMARY="bucketevents"
export MINIO_NOTIFY_ELASTICSEARCH_FORMAT_PRIMARY="namespace"
export MINIO_NOTIFY_ELASTICSEARCH_ENABLE_SECONDARY="on"
export MINIO_NOTIFY_ELASTICSEARCH_URL_SECONDARY="https://user:password@elasticsearch-endpoint.example.net:9200"
export MINIO_NOTIFY_ELASTICSEARCH_INDEX_SECONDARY="bucketevents"
export MINIO_NOTIFY_ELASTICSEARCH_FORMAT_SECONDARY="namespace"
mc admin config set notify_elasticsearch:primary \
url="user:password@https://elasticsearch-endpoint.example.net:9200" \
index="bucketevents" \
format="namespace" \
[ARGUMENT=VALUE ...]
mc admin config set notify_elasticsearch:secondary \
url="user:password@https://elasticsearch-endpoint.example.net:9200" \
index="bucketevents" \
format="namespace" \
[ARGUMENT=VALUE ...]
请注意，对于配置设置，唯一标识符会附加到notify_elasticsearch仅对整体，不对每个单独的参数。
设置
启用
必需
指定on以启用将存储桶通知发布到 Elasticsearch 服务端点的功能。
默认值为off.
如果设置为，需要指定以下额外的环境变量on:
- notify_elasticsearch
用于定义 Elasticsearch 服务端点的顶级配置键MinIO 存储桶通知.
使用
mc admin config set要设置或更新 Elasticsearch 服务端点。 以下参数是必需对于每个目标：将其他可选参数指定为空格分隔的
" ")-分隔的列表。mc admin config set notify_elasticsearch \ url="https://user:password@elasticsearch.example.com:9200" \ [ARGUMENT="VALUE"] ... \
URL
必需
指定 MinIO 发布存储桶事件到的 Elasticsearch 服务端点。
例如，https://elasticsearch.example.com:9200.
MinIO支持使用URL参数传递认证信息，格式如下PROTOCOL://USERNAME:PASSWORD@HOSTNAME:PORT.
Changed in version RELEASE.2023-05-27T05-56-19Z:MinIO 在添加目标之前会检查指定 URL 的健康状态（是否可解析和可达）。 即使现有通知目标处于离线状态，MinIO 也不再阻止添加新的通知目标。
Index
必需
指定用于存储或更新 MinIO 存储桶事件的 Elasticsearch 索引名称。 如果该索引不存在，Elasticsearch 会自动创建它。
格式
必需
指定写入 Elasticsearch 索引的事件数据格式。 MinIO 支持以下值：
namespace对于每个存储桶事件，MinIO 会创建一个 JSON 文档，将事件中的存储桶和对象名称作为文档 ID，并将实际事件作为文档正文的一部分。 对该对象的后续更新会修改该对象的现有索引条目。 同样地，删除对象也会删除相应的索引条目。
access对于每个存储桶事件，MinIO 会创建一个包含事件详情的 JSON 文档，并使用 Elasticsearch 生成的随机 ID 将其附加到索引中。 对对象的其他更新会产生新的索引条目，而现有条目保持不变。
用户名
可选
用于连接到需要身份验证的 Elasticsearch 服务端点的用户名。
密码
可选
连接到需要身份验证的 Elasticsearch 服务端点时使用的密码。
在版本 RELEASE.2023-06-23T20-26-00Z 中的变更：MinIO 在作为部分结果返回时会遮蔽此值mc admin config get.
队列目录
可选
指定目录路径以启用 MinIO 的持久化事件存储，用于存放未送达的消息，例如/opt/minio/events.
MinIO 在 Elasticsearch 服务离线期间将未送达的事件存储在指定存储中，并在连接恢复时重放已存储的事件。
队列限制
可选
指定未送达消息的最大限制。
默认值为100000.
评论
可选
指定要与 Elasticsearch 配置关联的注释。
