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