Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Adds content to highlights docs #142419

Merged
merged 13 commits into from
Oct 14, 2022
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-cases-assignees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-cases-view.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-data-view.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-ml-lens.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-ml-log-analysis.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-vis-collapse.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-vis-lens-table.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-vis-normalize.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/images/highlights-vis-time.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
240 changes: 239 additions & 1 deletion docs/user/whats-new.asciidoc
Original file line number Diff line number Diff line change
@@ -1,16 +1,254 @@
[[whats-new]]
== What's new in {minor-version}

coming::[8.5.0]

Here are the highlights of what's new and improved in {minor-version}.
For detailed information about this release,
check the <<release-notes, release notes>>.

Previous versions: {kibana-ref-all}/8.4/whats-new.html[8.4] | {kibana-ref-all}/8.3/whats-new.html[8.3] | {kibana-ref-all}/8.2/whats-new.html[8.2]
Previous versions: {kibana-ref-all}/8.4/whats-new.html[8.4] | {kibana-ref-all}/8.3/whats-new.html[8.3] | {kibana-ref-all}/8.2/whats-new.html[8.2]
| {kibana-ref-all}/8.1/whats-new.html[8.1] | {kibana-ref-all}/8.0/whats-new.html[8.0]

//NOTE: The notable-highlights tagged regions are re-used in the
//Installation and Upgrade Guide

// tag::notable-highlights[]

[discrete]
==== Data views &mdash; use without saving

What if you could explore your data or create a visualization without first creating a {data-source}?
Now you can do just that by selecting *Use without saving* in the *Create {data-source}* form.
This enables you to quickly explore your data in *Discover*, *Lens*, and *Maps*
right after ingesting it.
You can save the {data-source} later
if you create a search or visualization that you want to share.

[role="screenshot"]
image::images/highlights-data-view.png[Create data view form showing Use without saving button]


[discrete]
[[highlights-8.5-discover]]
=== Discover

[discrete]
==== Resize the date histogram

In addition to toggling the display of the histogram, you can now change its height.
Your preferences are saved locally in your browser.

[role="screenshot"]
image::https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltad9e5527c8cc0ece/63445400d7dfe71371560635/highlights-histogram.gif[The histogram includes a resize handle to change its height]

[discrete]
==== More insights in fields list

The field popover in the *Available fields* list now shows
more data, making it similar to the field popovers in *Lens* and *Fields Statistics*:

* Statistics are based on a sample of 5000 records per shard. Previously the sample size was 500 records.
* The popover shows up to top 10 values, instead of just 5.
* The “exist” filter appears at the top of the popover for better visibility.
* The distribution of values is available for aggregatable fields.

[role="screenshot"]
image::https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltdab342886b2fbe00/634453ffb8e4f9110c2ef4aa/highlights-discover-insights.gif[Statistics, top values, exist filter, and distribution of values in the field list popover]

[discrete]
[[highlights-8.5-dashboard]]
=== Dashboard

[discrete]
==== New time slider control

Add the newest control for interacting with your dashboard data, the time slider control.
The time slider allows anyone viewing the dashboard to playback and scrub through the data by time,
or quickly view the data for a specific time range, just like a song or movie.

[role="screenshot"]
image::images/highlights-dashboard-time-slider.png[Time slider control in a dashboard]

[discrete]
==== Filters for panels

When filters are applied to the individual visualization panels on your dashboard,
you can now easily view them without opening the visualization editor and leaving the dashboard.
Simply click *Panel filters* in the header.

[role="screenshot"]
image::images/highlights-dashboard-pan-filters.png[Pan filters applied to the visualizations on a dashboard]

[discrete]
[[highlights-8.5-vis-editors]]
=== Lens visualization editor

[discrete]
==== Add query-based annotations

A key method of troubleshooting metric performance is to analyze the events
that take place at the same time. Now you can add query-based annotations from multiple
data sources to your *Lens* visualizations. This makes it easy to layer time series events
and view the relationships between the annotations and other metrics.
Query-based annotations also come with improved overflow support, additional style options, and a customizable tooltip.


[role="screenshot"]
image::images/highlights-vis-query-annotations.png[Query annotations from separate data views in Lens]

[discrete]
==== Turn table values into links

Visual cues are important to dashboard users, especially when it comes to clickable values.
With the Table visualization in *Lens*, you can now enable *Directly filter on click* to turn
any column value into a link that filters the data, or drills down into the data.

[role="screenshot"]
image::images/highlights-vis-lens-table.png[Table visualization showing links in the top 5 values column, width="75%"]

[discrete]
==== Clone visualization layers

When you create visualization layers in *Lens*, you don’t have to start from a blank slate.
You can now duplicate layers, making it easy to adjust the filters and data options
from a common starting point.

[role="screenshot"]
image::images/highlights-vis-duplicate-layer.png[Actions menu for visualizations open to shoe the Duplicate layer item, width="50%"]

[discrete]
==== Normalize by unit

Need to use *Normalize by unit* for more than just date histogram visualizations in *Lens*?
Now you can! Suppose you have a metric visualization that displays the count of the
records field. With *Normalize by unit*, you can view a per minute calculation of the field.

[role="screenshot"]
image::images/highlights-vis-normalize.png[Menu item for viewing a per minute calculation of a field]

[discrete]
==== Display the current time

Markers make it easy for anyone viewing your dashboard to quickly understand important
events on visualizations. With the new *Show current time marker* axis option,
you can add a red line to signify where “now” is on time series visualizations.

[role="screenshot"]
image::images/highlights-vis-time.png[Visualization showing a red line that indicates the current time, width="75%"]

[discrete]
==== Collapse by option

Let’s say you’re creating a partition chart with sampled data, such as metrics,
and want to break down the last values from each reporting dimension, such as hosts.
You can use the new *Collapse by* option to break down and summarize the
result of each last value from hosts without displaying the detailed reporting dimension.

[role="screenshot"]
image::images/highlights-vis-collapse.png[Collapse by option for breaking down and summarizing the last value, width="75%"]

[discrete]
[[highlights-8.5-maps]]
=== Maps &mdash; hide tooltips

Tooltips display when you hover over a document or cluster in a map.
Don't want to display them? Turn them off with
the new *Show tooltips* toggle in *Layer settings*.

[role="screenshot"]
image::https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt553f1d51649d508d/63445a7f2a8d0a11633dbb8f/highlights-maps.gif[Show tooltips control in Layer settings]


[discrete]
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lcawl can you please review the sections. on machine learning and cases?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yup, we might add another blurb, but this LGTM for now.

[[highlights-8.5-machine-learning]]
=== Machine Learning

[discrete]
==== Anomaly detection jobs from Lens

You can now create anomaly detection jobs from the flyout of a *Lens* visualization.
Enter a job ID before creating the job, so it starts automatically after saving.
For a more advanced configuration, follow the link that takes you to the ML job wizard.

[role="screenshot"]
image::images/highlights-ml-lens.png[Flyout for creating an anomaly detection job from Lens]

[discrete]
==== Log pattern analysis

You can now select a data view and message field,
apply optional filters, and then run on-demand categorization analysis.
Messages that are similar are grouped using the same underlying algorithms
as a machine learning categorization job. The distribution of the documents in each category
are highlighted on the main chart. You can then open *Discover*,
use one or more of these categories as a filter to view the matching documents,
and continue your investigation.

[role="screenshot"]
image::images/highlights-ml-log-analysis.png[Chart showing the distribution of documents in each cateogry]

[discrete]
==== Locations of anomalous results in Maps

This release adds a link to *Maps* in the *Anomaly Explorer* and *Single Metric Viewer*
for any anomalies where the source data contains geo fields,
even if the analysis does not use the location field directly.
View the anomaly on the map by following the link.
For example, view the location of a client making an unusually high number of
requests that failed with a `page not found` 404 error.

[discrete]
[[highlights-8.5-security]]
=== Access agreement enhanced

The {kibana-ref}/xpack-security-access-agreement.html[access agreement]
now allows admins to set a default access
agreement message that applies to all authentication providers.
If you set the new `xpack.security.accessAgreement.message` setting, it will apply to all providers
for which you do not specify an access agreement.

[discrete]
[[highlights-8.5-collaboration]]
=== Collaboration with Cases

[discrete]
==== Case assignment

This release adds the ability to assign a {kibana-ref}/cases.html[case] to users.
You can do so either while creating a case or in an existing case by using
the “assignees” UI in *Observability*, *Elastic Security*, and *Stack Management*.

[role="screenshot"]
image::images/highlights-cases-assignees.png[Collaborate with Cases UI]

You can assign one or more users (and unassign as needed).
The UI builds on previous releases, which introduced the ability for users
to customize their avatars by selecting an image or color.
Avatars add visual help in easily identifying and disambiguating users.

The assignees and their avatars show up in each case.
They also now appear in the central *Cases* view that lists all existing
cases in *Observability*, *Elastic Security*, and *Stack Management*.
On this view, you can easily filter through the cases assigned to you and all other users.

[role="screenshot"]
image::images/highlights-cases-view.png[Cases view listing that lists all assigned users]

[discrete]
==== User search

You can now search for users by their full name,
username, or email as part of the case assignment flow.
{kib} users from all authentication realms are searchable. On first access,
{kib} creates a user profile and surfaces it in the user search results.

The user search UI includes auto-complete and search highlights.

[role="screenshot"]
image::images/highlights-cases-user-search.png[User search view with auto-complete, highlights, user avatars, user email, width="75%"]

User search adheres to {kib} role-based access control. Users who do not have access to *Cases* within the
space will not surface in the results. For more details, go to {kibana-ref}/setup-cases.html[Configure access to cases].

// end::notable-highlights[]