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
部分。
- 有关详细信息,请参阅Kafka输入插件文档中的
- 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
相关推荐
goodstudy 2020-08-19
weikaixxxxxx 2020-08-01
liulin0 2020-07-26
AFei00 2020-07-26
娜娜 2020-07-20
偏头痛杨 2020-07-18
winxcoder 2020-07-18
superviser000 2020-06-28
liulin0 2020-06-25
liulin0 2020-06-16
wangfengqingyang 2020-06-11
cullinans 2020-06-09
winxcoder 2020-06-08
citic 2020-06-06
goodstudy 2020-06-05
superviser000 2020-05-30
yuzhongdelei0 2020-05-15
wzhwangzhuohui 2020-05-12
李玉志 2020-05-11