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

批量事件数,如果插入到集合中的事件数超过该限制,无论批量间隔值如何,都会批量插入(mongodb 硬限制为 1000)。

collection

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

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

database

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

要使用的数据库。

generateId

编辑

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

isodate

编辑

如果为 true,则将 @timestamp 字段以 ISODate 类型而不是 ISO8601 字符串存储在 MongoDB 中。有关这方面的更多信息,请参阅 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。强烈建议在您的配置中设置此 ID。当您有两个或多个相同类型的插件时,这尤其有用。例如,如果您有 2 个 mongodb 输出。在这种情况下添加命名 ID 将有助于在使用监控 API 时监控 Logstash。

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

id 字段中的变量替换仅支持环境变量,不支持使用来自 secret store 的值。