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