重要更改

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

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

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

有重要改变的描述，请参阅这些主题：

也可以参阅发布说明。

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

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

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

下面是6.0的重要更改。

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

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

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

将Kafka客户端支持升级到v0.11.0.0，只支持Kafka broker v0.10.x或更高版本。
- 有关Kafka与Logstash兼容性的信息，请参阅Kafka输入插件文档。
修饰字段现在嵌套在@metadata，以避免与Beats映射冲突。
- 有关详细信息，请参阅Kafka输入插件文档中的Metadata Fields部分。
ssl选项现在已经过时了。

将Kafka客户端支持升级到v0.11.0.0，只支持Kafka broker v0.10.x或更高版本。
- 有关Kafka与Logstash兼容性的信息，请参考Kafka输出插件文档。
block_on_buffer_full、ssl和timeout_ms选项已经过时。

当多行编解码器插件与Beats输入插件一起使用时，Logstash将不会再启动。
- 建议使用Filebeat中的多行支持作为替代，有关详细信息，请参阅Filebeat中的配置选项。
选项congestion_threshold和target_field_for_codec现在已经过时了。

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