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包的更改

• 对于rpm和deb发布构件，配置文件匹配*.conf glob模式必须在conf.d文件夹中，不然不会加载文件。

命令行接口行为

• -e和-f CLI选项如今相互排斥，这也适用于相应的长表单选项config.string和path.config，这意味着经过-e提供的任何配置将再也不被追加到经过-f提供的配置中。
• 具备-f或config.path的配置不会被自动添加到stdin输入和stdout输出中。

插件的更改

Elasticsearch输出的更改

• 为了与Beats保持一致，默认的document_type从logs更改成doc，此外，建议用户，Elasticsearch 6.0已弃用doctype，7.0会删除它们，有关更多信息，请参见删除映射类型。
• 选项flush_size和idle_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_full、ssl和timeout_ms选项已通过时。

Beats输入的更改

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

  • 建议使用Filebeat中的多行支持做为替代，有关详细信息，请参阅Filebeat中的配置选项。
• 选项congestion_threshold和target_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