Mongodb 输出插件

编辑
  • 插件版本:v3.1.7
  • 发布日期:2022-01-31
  • 变更日志

对于其他版本,请参阅 版本化插件文档

安装

编辑

对于默认情况下未捆绑的插件,可以通过运行 bin/logstash-plugin install logstash-output-mongodb 轻松安装。有关更多详细信息,请参阅 使用插件

获取帮助

编辑

有关插件的问题,请在 Discuss 论坛中发起主题。对于错误或功能请求,请在 Github 中提交问题。有关 Elastic 支持的插件列表,请查阅 Elastic 支持矩阵

描述

编辑

此输出将事件写入 MongoDB。

Mongodb 输出配置选项

编辑

此插件支持以下配置选项以及稍后描述的 通用选项

另请参阅 通用选项,以获取所有输出插件支持的选项列表。

 

bulk

编辑

批量插入标志,设置为 true 以允许批量插入,否则它将逐个插入事件。

bulk_interval

编辑
  • 值类型为 数字
  • 默认值为 2

批量间隔,如果激活了“bulk”标志,则用于定期插入事件。

bulk_size

编辑
  • 值类型为 数字
  • 默认值为 900

批量事件数量,如果要插入集合的事件数量超过该限制,则无论 bulk_interval 值如何,它都将被批量插入(mongodb 硬限制为 1000)。

collection

编辑
  • 这是必需的设置。
  • 值类型为 字符串
  • 此设置没有默认值。

要使用的集合。此值可以使用 %{foo} 值根据事件中的数据动态选择集合。

database

编辑
  • 这是必需的设置。
  • 值类型为 字符串
  • 此设置没有默认值。

要使用的数据库。

generateId

编辑

如果为 true,则在插入之前会将“_id”字段添加到文档中。“_id”字段将使用事件的时间戳,并覆盖事件中现有的“_id”字段。

isodate

编辑

如果为 true,则将 @timestamp 字段存储在 MongoDB 中作为 ISODate 类型而不是 ISO8601 字符串。有关此内容的更多信息,请参阅 http://www.mongodb.org/display/DOCS/Dates

retry_delay

编辑
  • 值类型为 数字
  • 默认值为 3

失败后等待重试的秒数。

  • 这是必需的设置。
  • 值类型为 字符串
  • 此设置没有默认值。

要连接到的 MongoDB URI。请参阅 http://docs.mongodb.org/manual/reference/connection-string/

通用选项

编辑

所有输出插件都支持这些配置选项

设置 输入类型 必填

codec

codec

enable_metric

布尔值

id

字符串

codec

编辑
  • 值类型为 codec
  • 默认值为 "plain"

用于输出数据的编解码器。输出编解码器是在数据离开输出之前对其进行编码的便捷方法,而无需在 Logstash 管道中使用单独的过滤器。

enable_metric

编辑

禁用或启用此特定插件实例的指标日志记录。默认情况下,我们会记录所有可以记录的指标,但您可以禁用特定插件的指标收集。

  • 值类型为 字符串
  • 此设置没有默认值。

向插件配置添加唯一的 ID。如果未指定 ID,Logstash 将生成一个。强烈建议在您的配置中设置此 ID。当您有两个或多个相同类型的插件时,这尤其有用。例如,如果您有两个 mongodb 输出。在这种情况下,添加命名 ID 将有助于在使用监控 API 时监控 Logstash。

output {
  mongodb {
    id => "my_plugin_id"
  }
}

id 字段中的变量替换仅支持环境变量,不支持使用密钥存储中的值。