5.0 中的重大改變 · Kibana 5.2 中文文檔

# 5.0 中的重大改變原文鏈接 : [https://www.elastic.co/guide/en/kibana/5.2/breaking-changes-5.0.html](https://www.elastic.co/guide/en/kibana/5.2/breaking-changes-5.0.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=8159462](http://www.apache.wiki/pages/viewpage.action?pageId=8159462) 貢獻者 : [那伊抹微笑](/display/~wangyangting)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 本節主要討論在將應用程序遷移到 **Kibana 5.0?**時需要注意的改變。 ### 針對 DEB/RPM 軟件包的 URL 改變細節 :?先前的?**`packages.elastic.co`**?**URL** 已更改為?**`artifacts.elastic.co`**`。` 影響 :?確保在運行升級過程之前更新 **repository**（存儲庫）文件，否則您的操作系統可能看不到新的軟件包。 ### Kibana 默認綁定為 localhost [Pull Request 8013](https://github.com/elastic/kibana/pull/8013) 細節 : 為了安全的目的，**Kibana**（如 **Elasticsearch**）現在綁定到 **localhost** 而不是 **0.0.0.0**（所有地址）。以前綁定到 **0.0.0.0** 也導致了 **Windows?**用戶的問題。影響 :?如果在不允許 **localhost?**綁定的容器/環境中運行 **Kibana**，這將導致 **Kibana?**無法啟動，除非在 **kibana.yml** 文件中配置 **server.host?**為有效的 **IP** 地址/主機，等等。 ### Markdown headers（標題） [Pull Request 7855](https://github.com/elastic/kibana/pull/7855) 細節 :?作為解決 **Kibana** 產品中的安全問題[?ESA-2016-03](https://www.elastic.co/community/security)（**CVE-2016-1000220**）中的一部分，**markdown**?發生版本沖突。影響 :?由于修復了 **ESA-2016-03**，**headers**（標題）的 **markdown?**格式略有變化。以前，標題是使用?`###?`后緊跟標題定義的 :? ``` ###Packetbeat: [Dashboard](/#/dashboard/Packetbeat-Dashboard) [Web transactions](/#/dashboard/HTTP) ``` 它現在應該定義如下（＃和標題之間有一個空格）:? ``` ### Packetbeat: [Dashboard](/#/dashboard/Packetbeat-Dashboard) [Web transactions](/#/dashboard/HTTP) ``` ### Linux 軟件包安裝目錄 [Pull Request 7308](https://github.com/elastic/kibana/pull/7308) 細節 :?為了與 **Elasticsearch?**軟件包一致，**Kibana** 現在會將二進制文件安裝在?`**/usr/share/kibana**，并且`配置文件在?**`/etc/kibana`**。以前，他們都位于**?`/opt/kibana`**。影響 :?除了了解 **Kibana** 二進制文件和配置文件的新位置，您可能需要根據需要更新自動化腳本。 ### 插件安裝程序現在有自己的 executable（可執行的）命令 [Pull Request 6402](https://github.com/elastic/kibana/pull/6402) 細節 :?新的安裝程序可以在?`**/bin/kibana-plugin** 找到`。當安裝/刪除 **Kibana?**插件時，現在將調用`**kibana-plugin**?`而不是主要的 **kibana** 腳本。影響 :?您可能需要更新自動化腳本。 ### 只有已列入白名單的客戶端 header 才會發送到 Elasticsearch [Pull Request 6896](https://github.com/elastic/kibana/pull/6896) 細節 :?從瀏覽器客戶端到 **Elasticsearch?**的唯一 **header** 是通過?**`elasticsearch.requestHeadersWhitelist?`**服務器配置設置的。影響 :?如果您依賴 **Elasticsearch?**中的客戶端 **header**，則需要在 **kibana.yml** 文件中將您指定的?**header** 列入白名單。 ### `server.defaultRoute?`現在總是有前綴?`server.basePath` [Pull Request 6953](https://github.com/elastic/kibana/pull/6953) 細節 :?當訪問 **default route**（默認路由）時，**base path**（基本路徑）配置現在位于默認路由配置之前。影響 :?如果你依靠?**`defaultRoute?`**和?**`basePath` **`兩者的`配置，你將需要從你的?**`defaultRoute` **`中刪除``硬編碼`**`?**`basePath`**`**。 ### 靜態資源的目錄列表不再渲染 [Pull Request 6764](https://github.com/elastic/kibana/pull/6764) 細節 :?如果您嘗試訪問目錄，服務器不再顯示靜態文件列表。影響 :?如果您之前依賴此行為，您將需要通過反向代理來顯示基礎目錄列表。 ### 控制臺日志使用 UTC 格式顯示日期/時間 [Pull Request 8534](https://github.com/elastic/kibana/pull/8534) 細節 :?所有服務器日志現在都以 **UTC?**而不是服務器的本地時間顯示。影響 :?如果以自動方式解析 **Kibana?**服務器日志的時間戳，請確保更新自動化以適應 **UTC?**值。 ### 平均列不再與標準差一起呈現 [Pull Request 7827](https://github.com/elastic/kibana/pull/7827) 細節 :?從 **Kibana** 的早期開始，向數據表添加標準差度量也導致將平均列添加到該數據表。現在不再是這樣的。影響 :?如果要在同一個數據表中同時具有標準偏差和平均值，則應像添加其他任何指標一樣添加這兩個列。 ### 聚合的最小大小已從 0 更改為 1 [Pull Request 8339](https://github.com/elastic/kibana/pull/8339) 細節 :?Elasticsearch 已刪除為 **terms aggregations**（詞條聚合）指定大小為 **0** 的功能，因此 **Kibana?**的最小值已調整為更適合的了。影響 :?任何依賴于 **size = 0?**的已保存可視化將需要更新。 ### 5.0 之前創建的 dashboard（儀表盤）細節 :?在 **Kibana 5.0** 中加載 **4.x** 儀表板會導致儀表板的元數據發生內部更改，您可以通過保存儀表板來保留此更改。影響 :?此更改不會影響儀表板本身的功能，但必須在使用某些功能（如 **X-Pack?**報告）之前保存儀表板。 ### 使用先前已棄用的 Elasticsearch 功能保存的對象細節 :?從 **Kibana 4.3** 開始，用戶已經能夠通過通用 **JSON?**編輯器任意修改過濾器。如果用戶以這種方式利用任何已棄用的 **Elasticsearch?**功能，那么它們將在 **Kibana?**中導致錯誤，因為它們已從 **Elasticsearch 5.0?**中刪除。有關更多詳細信息，請參閱 **Elasticsearch?**文檔。影響 :?**Discover**（發現），**Visualize**（可視化）和 **Dashboard**（儀表板）將對依賴于已刪除的 Elasticsearch 功能的任何已保存對象都會發生錯誤。用戶需要更新任何受影響的過濾器的 **JSON**。