Elastic Workplace Search 输出插件
编辑Elastic Workplace Search 输出插件编辑
- 是 elastic_enterprise_search 集成插件 的一部分
- 集成版本:v3.0.0
- 发布日期:2023-11-07
- 变更日志
有关其他版本,请参阅 版本化插件文档。
获取帮助编辑
如果您对插件有任何疑问,请在 Discuss 论坛中发布主题。对于错误或功能请求,请在 Github 中创建问题。有关 Elastic 支持的插件列表,请参阅 Elastic 支持矩阵。
描述编辑
此输出允许您将事件发送到 Elastic Workplace Search 解决方案。在从 Logstash 管道接收一批事件后,插件会将事件转换为文档,并使用 Workplace Search 批量 API 在一个请求中索引多个事件。
Workplace Search 不允许字段以 @timestamp
开头。默认情况下,在将事件发送到 Workplace Search 之前,将从每个事件中删除 @timestamp
和 @version
字段。如果您想保留 @timestamp
字段,可以使用 timestamp_destination 选项将时间戳存储在其他字段中。
此 gem 不支持编解码器自定义。
Workplace Search 输出配置选项编辑
此插件支持以下配置选项,以及后面描述的 通用选项。
另请参阅 通用选项,了解所有输出插件支持的选项列表。
document_id
编辑
- 值类型为 字符串
- 没有默认值
Workplace Search 文档的 ID。这可以是插值值,例如 myapp-%{sequence_id}
。重复使用 ID 将导致文档被重写。
source
编辑
- 值类型为 字符串
- 没有默认值
您在 Workplace Search 中创建的源的 ID。 source
字段支持 sprintf 格式,允许从每个事件的字段值中派生源 ID,例如 %{source_id}
。
无效的源 ID 会导致摄取停止,直到字段值可以解析为有效的源 ID。如果插值字段值解析为没有匹配源的值,或者如果事件中缺少该字段并且根本无法解析,则可能会发生这种情况。
考虑在配置中添加“默认”源类型,以在事件中缺少该字段时捕获错误。
示例
input { stdin { codec => json } } filter { if ![source_id] { mutate { add_field => {"source_id" => "default"} } } } output { elastic_workplace_search { source => "%{[source_id]}" access_token => "abracadabra" url => "http://workplace.search.com:3002" } }
ssl_certificate_authorities
编辑
- 值类型为列表 of 路径
- 此设置没有默认值
用于验证服务器证书的 .cer 或 .pem 文件。
您不能同时使用此设置和 ssl_truststore_path
。
ssl_supported_protocols
编辑
- 值类型为 字符串
- 允许的值为:
'TLSv1.1'
、'TLSv1.2'
、'TLSv1.3'
- 默认值取决于所使用的 JDK。使用最新 Logstash 时,默认值为
['TLSv1.2', 'TLSv1.3']
。'TLSv1.1'
不被认为是安全的,仅为旧版应用程序提供。
建立与 Elasticsearch 集群的连接时要使用的允许 SSL/TLS 版本列表。
对于 Java 8,'TLSv1.3'
仅从 8u262(AdoptOpenJDK)开始受支持,但要求您在 Logstash 中设置 LS_JAVA_OPTS="-Djdk.tls.client.protocols=TLSv1.3"
系统属性。
如果您将插件配置为在任何最新的 JVM(例如与 Logstash 打包在一起的 JVM)上使用 'TLSv1.1'
,则该协议默认情况下处于禁用状态,需要通过更改 $JDK_HOME/conf/security/java.security 配置文件中的 jdk.tls.disabledAlgorithms
手动启用。也就是说,需要从列表中删除 TLSv1.1
。
ssl_truststore_path
编辑
- 值类型为 路径
- 此设置没有默认值。
用于验证服务器证书的信任库。它可以是 .jks
或 .p12
。
您不能同时使用此设置和 ssl_certificate_authorities
。
ssl_verification_mode
编辑
- 值可以是以下任何一个:
full
、none
- 默认值为
full
定义如何验证 TLS 连接中另一方提供的证书
full
验证服务器证书的颁发日期是否在 not_before 和 not_after 日期范围内;链接到受信任的证书颁发机构 (CA),并且具有与证书中的名称匹配的主机名或 IP 地址。
none
不执行证书验证。
将证书验证设置为 none
会禁用 SSL/TLS 的许多安全优势,这非常危险。有关禁用证书验证的更多信息,请阅读 https://www.cs.utexas.edu/~shmat/shmat_ccs12.pdf