From 3b087669a45e6f968bbf4e07adb6d278def8015d Mon Sep 17 00:00:00 2001 From: Clinton Gormley Date: Thu, 15 Nov 2018 09:03:19 +0100 Subject: [PATCH] Docs: Added known bugs to release highlights when upgrading to 6.5.0 --- docs/release-notes/highlights-6.5.0.asciidoc | 136 ++++++++++--------- 1 file changed, 72 insertions(+), 64 deletions(-) diff --git a/docs/release-notes/highlights-6.5.0.asciidoc b/docs/release-notes/highlights-6.5.0.asciidoc index b782607302a66..65412edeb3b48 100644 --- a/docs/release-notes/highlights-6.5.0.asciidoc +++ b/docs/release-notes/highlights-6.5.0.asciidoc @@ -4,38 +4,46 @@ 6.5.0 ++++ -Each release of {kib} brings new features and product improvements. -Here are the highlights of the features that were added in 6.5.0 and +[WARNING] +.Known Bugs +============================ +There is a known bug when upgrading to Kibana 6.5.0 when Security is enabled. +If you are using Security, please wait for 6.5.1 to be released before +upgrading. +============================ + +Each release of {kib} brings new features and product improvements. +Here are the highlights of the features that were added in 6.5.0 and how the user experience improved. -Refer to the <> for a list of bug fixes and +Refer to the <> for a list of bug fixes and other changes. [float] === Organize your work in spaces -<> is one of our most highly requested features. Spaces allow you to organize -your saved objects into meaningful categories. For example, you might place all -sales visuals in a sales space and all logging objects in a logging space. +<> is one of our most highly requested features. Spaces allow you to organize +your saved objects into meaningful categories. For example, you might place all +sales visuals in a sales space and all logging objects in a logging space. [role="screenshot"] image::images/highlights_6_5_select-space.png[Select your space dashboard] -You can create as many spaces as you need, change spaces at any time, and move -saved objects between spaces. With security enabled, you can control which roles +You can create as many spaces as you need, change spaces at any time, and move +saved objects between spaces. With security enabled, you can control which roles and users have access to which spaces using role-based access control (RBAC). -To create, edit, and delete spaces, use *Management > Spaces*. +To create, edit, and delete spaces, use *Management > Spaces*. Or, if you prefer to create your spaces programmatically, you can use the <>. [float] === Monitor cross-cluster replication (beta) -Monitoring includes a new UI for monitoring {ref}/ccr-apis.html[cross-cluster replication] as a beta -feature in 6.5. Cross-cluster replication gives you resiliency in case the primary -cluster fails--a secondary cluster serves as a hot backup. With the UI, you can +Monitoring includes a new UI for monitoring {ref}/ccr-apis.html[cross-cluster replication] as a beta +feature in 6.5. Cross-cluster replication gives you resiliency in case the primary +cluster fails--a secondary cluster serves as a hot backup. With the UI, you can monitor how indices are replicated from one cluster to another and view detailed -information on the leader index, the following indices, and the shards. +information on the leader index, the following indices, and the shards. You’ll also get verification on whether the replication process is viable. [role="screenshot"] @@ -44,17 +52,17 @@ image::images/highlights_6_5_cross-cluster.png[Monitoring for cross-cluster dash [float] === Showcase your data in Canvas (beta) -<> is {kib}’s new place for showcasing your data live in a pixel-perfect design. -Starting with a blank workpad, you can create a story about your data by combining -static content (text, images, and shapes) with data-driven elements (charts, tables, -images, and many others). Each dynamic element is connected to a sample data -source by default, so you can experiment with it before connecting to your own data. -Canvas supports multiple languages for querying Elasticsearch: es docs, SQL, and Timelion syntax. - -Canvas tools have rich styling capabilities, allowing users to change colors and -styles of both static and dynamic elements. Canvas is designed so you can tweak -an element’s content and style using the UI, or go deeper and edit the expressions -that create the element or the css styling. In short, Canvas gives you everything +<> is {kib}’s new place for showcasing your data live in a pixel-perfect design. +Starting with a blank workpad, you can create a story about your data by combining +static content (text, images, and shapes) with data-driven elements (charts, tables, +images, and many others). Each dynamic element is connected to a sample data +source by default, so you can experiment with it before connecting to your own data. +Canvas supports multiple languages for querying Elasticsearch: es docs, SQL, and Timelion syntax. + +Canvas tools have rich styling capabilities, allowing users to change colors and +styles of both static and dynamic elements. Canvas is designed so you can tweak +an element’s content and style using the UI, or go deeper and edit the expressions +that create the element or the css styling. In short, Canvas gives you everything you need to showcase your live data, your way. [role="screenshot"] @@ -64,11 +72,11 @@ image::images/highlights_6_5_canvas.png[Canvas workpad with sample flight data s === Create and manage rollup jobs {kib} has a new <> for creating, starting, stopping, and deleting rollup -jobs. Rollups is a recent addition to Elasticsearch and {ref}/rollup-apis.html[APIs for creating and -managing rollups] have been available since 6.4. A rollup index summarizes historical -data and stores it compactly for future analysis, so you can query, aggregate, -and visualize this data using a fraction of the storage. A rollup job is a periodic -task that aggregates the data for the rollup index. To navigate to the UI, go to +jobs. Rollups is a recent addition to Elasticsearch and {ref}/rollup-apis.html[APIs for creating and +managing rollups] have been available since 6.4. A rollup index summarizes historical +data and stores it compactly for future analysis, so you can query, aggregate, +and visualize this data using a fraction of the storage. A rollup job is a periodic +task that aggregates the data for the rollup index. To navigate to the UI, go to *Management*, and under *Elasticsearch*, click *Rollup Jobs*. [role="screenshot"] @@ -77,12 +85,12 @@ image::images/highlights_6_5_rollup.png[Create a rollup job dashboard] [float] === View rolled up data in visualizations (beta) -{kib} now has <>. -You can create index -patterns that use rollup indices or mix rollup and raw indices to visualize all -data together. Most visualizations support rolled up data, with the exception of -Timelion, Visual Builder, and Vega visualizations. You can also create dashboards -that use visualizations based on rolled up and raw data. Finally, both rolled up +{kib} now has <>. +You can create index +patterns that use rollup indices or mix rollup and raw indices to visualize all +data together. Most visualizations support rolled up data, with the exception of +Timelion, Visual Builder, and Vega visualizations. You can also create dashboards +that use visualizations based on rolled up and raw data. Finally, both rolled up and raw data are available in Discover. [role="screenshot"] @@ -91,12 +99,12 @@ image::images/highlights_6_5_rollup-viz.png[Beats management UI] [float] === Manage your Beats in a central location (beta) -The Beats management UI is your one-stop shop for centrally managing your Beats -deployments. This new UI saves you time because you no longer have to log onto the -machine where the Beat is deployed to conduct configuration updates. From the UI, -you can manage the enrollment of multiple Beats and update their configurations as -a fleet. You must have security enabled to access the Beats UI. This feature is -initially only available for Filebeat and Metricbeat. +The Beats management UI is your one-stop shop for centrally managing your Beats +deployments. This new UI saves you time because you no longer have to log onto the +machine where the Beat is deployed to conduct configuration updates. From the UI, +you can manage the enrollment of multiple Beats and update their configurations as +a fleet. You must have security enabled to access the Beats UI. This feature is +initially only available for Filebeat and Metricbeat. [role="screenshot"] image::images/highlights_6_5_beats.png[Beats management UI] @@ -104,14 +112,14 @@ image::images/highlights_6_5_beats.png[Beats management UI] [float] === Monitor and manage your infrastructure (beta) -{kib} has two new beta features for logging and metrics use cases, Infrastructure -and Logs, both available from the side navigation. With Infrastructure, you can -explore infrastructure metrics and logs for common servers, containers, and services. +{kib} has two new beta features for logging and metrics use cases, Infrastructure +and Logs, both available from the side navigation. With Infrastructure, you can +explore infrastructure metrics and logs for common servers, containers, and services. [role="screenshot"] image::images/highlights_6_5_kubernetes.png[Example infrastructure management dashboard] -Using Logs, you can stream logs in real time or scroll through historical views in +Using Logs, you can stream logs in real time or scroll through historical views in a console-like experience [role="screenshot"] @@ -120,12 +128,12 @@ image::images/highlights_6_5_logs.gif[Animated view of log management features] [float] === Distributed tracing in APM (beta) -The APM UI now supports distributed tracing as a beta feature in 6.5. Distributed -tracing enables you to analyze and view performance throughout your microservices -architecture by tracing all requests. These requests range from the initial web -request to your frontend service to queries made to your backend services. -This gives you a trace of how your services interact with one another and enables -you to pinpoint bottlenecks faster. +The APM UI now supports distributed tracing as a beta feature in 6.5. Distributed +tracing enables you to analyze and view performance throughout your microservices +architecture by tracing all requests. These requests range from the initial web +request to your frontend service to queries made to your backend services. +This gives you a trace of how your services interact with one another and enables +you to pinpoint bottlenecks faster. [role="screenshot"] image::images/highlights_6_5_tracing.png[Example of tracing data in APM UI] @@ -133,15 +141,15 @@ image::images/highlights_6_5_tracing.png[Example of tracing data in APM UI] [float] === Get started with two new sample data sets -{kib} has two new, one-click sample data sets tailored to the new user experience. -If you’re interested in business analytics, install the eCommerce data set, which -has visualizations for product-related information, such as cost, revenue, and price. -If you’re looking to analyze website traffic, check out the web logs sample data set. +{kib} has two new, one-click sample data sets tailored to the new user experience. +If you’re interested in business analytics, install the eCommerce data set, which +has visualizations for product-related information, such as cost, revenue, and price. +If you’re looking to analyze website traffic, check out the web logs sample data set. To access the sample data, go to the {kib} home page and click *Load a data set and a {kib} dashboard*. -Each sample is prepackaged with a dashboard and a Canvas -workpad. The workpad for the eCommerce sample includes two different styles for -the same data. The workpads are a hands-on way for new users to +Each sample is prepackaged with a dashboard and a Canvas +workpad. The workpad for the eCommerce sample includes two different styles for +the same data. The workpads are a hands-on way for new users to learn Canvas. [role="screenshot"] @@ -150,12 +158,12 @@ image::images/highlights_6_5_sample-canvas.png[Canvas workpad included with new [float] === Visualize data from a log file -Machine learning features are now available for users on a Basic license. The Data -Visualizer helps you understand the metrics and fields in your data in preparation -for further analysis. With the new File Data Visualizer, you can upload a CSV, NDJSON, -or log file. The File Data Visualizer uses the new File Structure API to identify -the file format and field mappings. You can then choose to import the data into an -Elasticsearch index. The log file import feature is experimental in 6.5, and is +Machine learning features are now available for users on a Basic license. The Data +Visualizer helps you understand the metrics and fields in your data in preparation +for further analysis. With the new File Data Visualizer, you can upload a CSV, NDJSON, +or log file. The File Data Visualizer uses the new File Structure API to identify +the file format and field mappings. You can then choose to import the data into an +Elasticsearch index. The log file import feature is experimental in 6.5, and is limited to files up to 100 MB in size. [role="screenshot"]