Logstash 参考指南(重要更改)

重要更改

我们努力维护小版本之间的向后兼容性(例如6.x到6.y),这样你就可以在不更改任何配置文件的情况下进行升级,重要更改通常只在主要版本(例如5.x到6.y)介绍,有时,为了确保操作的正确性,我们不得不在给定的主要版本中中断兼容性。

本节介绍迁移到Logstash 6.0.0或更高版本时需要注意的更改。

不推荐直接在非连续的主要版本之间迁移(1.x到6.x)。

有重要改变的描述,请参阅这些主题:

  • 在Logstash 6.3.0之前跨PQ版本的重要更改
  • 在6.0中的重要更改

也可以参阅发布说明。

在Logstash 6.3.0之前跨PQ版本的重要更改

如果你正在从Logstash 6.2.x升级或任何早期版本(包括5.x),并启用了持久队列,我们强烈建议你在升级之前耗尽或删除持久队列,有关信息和指令,请参阅启用持久队列进行升级。

我们正在努力解决数据不兼容的问题,以便将来的升级不需要额外的步骤。

在6.0中的重要更改

下面是6.0的重要更改。

Logstash核心中的更改

这些更改可能会影响Logstash的任何实例,并且与插件无关,但只有在使用受影响的特性时才会影响。

应用程序设置

  • 设置config.reload.interval被更改为使用时间值字符串,如5m、10s等,以前,用户必须自己将其转换为毫秒时间值。

RPM/Deb包的更改

  • 对于rpmdeb发布构件,配置文件匹配*.conf glob模式必须在conf.d文件夹中,否则不会加载文件。

命令行接口行为

  • -e-f CLI选项现在相互排斥,这也适用于相应的长表单选项config.stringpath.config,这意味着通过-e提供的任何配置将不再被追加到通过-f提供的配置中。
  • 具有-fconfig.path的配置不会被自动添加到stdin输入和stdout输出中。

插件的更改

Elasticsearch输出的更改

  • 为了与Beats保持一致,默认的document_typelogs更改为doc,此外,建议用户,Elasticsearch 6.0已弃用doctype,7.0会删除它们,有关更多信息,请参见删除映射类型
  • 选项flush_sizeidle_flush_time现在已经过时了。
  • 请注意,_all字段在6.0中已弃用,新的映射模板已经更新以反映这一点,如果你正在使用自定义映射模板,你可能需要更新它以反映这一点。

Kafka输入的更改

  • 将Kafka客户端支持升级到v0.11.0.0,只支持Kafka broker v0.10.x或更高版本。

    • 有关Kafka与Logstash兼容性的信息,请参阅Kafka输入插件文档。
  • 修饰字段现在嵌套在@metadata,以避免与Beats映射冲突。

    • 有关详细信息,请参阅Kafka输入插件文档中的Metadata Fields部分。
  • ssl选项现在已经过时了。

Kafka输出的更改

  • 将Kafka客户端支持升级到v0.11.0.0,只支持Kafka broker v0.10.x或更高版本。

    • 有关Kafka与Logstash兼容性的信息,请参考Kafka输出插件文档。
  • block_on_buffer_fullssltimeout_ms选项已经过时。

Beats输入的更改

  • 当多行编解码器插件与Beats输入插件一起使用时,Logstash将不会再启动。

  • 选项congestion_thresholdtarget_field_for_codec现在已经过时了。

与Logstash绑定的插件列表

下面的插件是基于使用数据从6.0默认捆绑中删除的,你仍然可以手动安装这些插件:

  • logstash-codec-oldlogstashjson
  • logstash-input-couchdb_changes
  • logstash-input-irc
  • logstash-input-log4j
  • logstash-input-lumberjack
  • logstash-filter-uuid
  • logstash-output-xmpp
  • logstash-output-irc
  • logstash-output-statsd

相关推荐