kibana/docs/CHANGELOG.asciidoc

[[release-notes]]
= Release notes

[partintro]
--
// Use these for links to issue and pulls. Note issues and pulls redirect one to
// each other on Github, so don't worry too much on using the right prefix.
:issue: https://github.com/elastic/kibana/issues/
:pull: https://github.com/elastic/kibana/pull/

Review important information about the {kib} 8.3.x releases.

* <<release-notes-8.3.3>>
* <<release-notes-8.3.2>>
* <<release-notes-8.3.1>>
* <<release-notes-8.3.0>>
//* <<release-notes-8.2.3>>
//* <<release-notes-8.2.2>>
//* <<release-notes-8.2.1>>
//* <<release-notes-8.2.0>>
//* <<release-notes-8.1.3>>
//* <<release-notes-8.1.2>>
//* <<release-notes-8.1.1>>
//* <<release-notes-8.1.0>>
//* <<release-notes-8.0.1>>
//* <<release-notes-8.0.0>>
//* <<release-notes-8.0.0-rc2>>
//* <<release-notes-8.0.0-rc1>>
//* <<release-notes-8.0.0-beta1>>
//* <<release-notes-8.0.0-alpha2>>
//* <<release-notes-8.0.0-alpha1>>

--

[[release-notes-8.3.3]]
== {kib} 8.3.3

Review the following information about the {kib} 8.3.3 release.

[float]
[[known-issue-8.3.3]]
=== Known issues

If you have alerting rules that have been snoozed, do not upgrade {kib} from
8.3.3 to 8.4.0. Upgrade to 8.4.1 instead.

To determine if you have snoozed alerting rules, open the main menu, then click
**{stack-manage-app}** -> **{rac-ui}**. Filter the rule list by selecting
**View** -> **Snoozed**. If you must upgrade to 8.4.0, for each space, cancel
the snooze for all affected rules before you upgrade.

To identify snoozed rules in all Spaces using **Dev Tools**, run the following
query:

[source,console]
----
GET /.kibana/_search
{
  "query": {
    "exists": {
      "field": "alert.isSnoozedUntil"
    }
  }
}
----

If you upgraded {kib} from 8.3.3 to 8.4.0 and you had alerting rules configured to
snooze notifications, you will receive the following error message:

[source,text]
----
FATAL  Error: Unable to complete saved object migrations for the [.kibana] index.
----

To fix that problem, restore your previous version, then upgrade to 8.4.1 instead.

[float]
[[breaking-changes-8.3.3]]
=== Breaking change

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking change, then mitigate the impact to your application.

// tag::notable-breaking-changes[]

There are no breaking changes in {kib} 8.3.3.

// end::notable-breaking-changes[]

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.2/release-notes-8.2.0.html#breaking-changes-8.2.0[8.2.0] | {kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[fixes-v8.3.3]]
=== Bug fixes
Dashboard::
* Fixes `z-index` of `embPanel__header--floater` {kibana-pull}136463[#136463]
* Filter out experimental visualizations when labs setting is disabled {kibana-pull}136332[#136332]

Discover::
Fixes filter in / filter out buttons for empty values {kibana-pull}135919[#135919]

Elastic Security::
For the Elastic Security 8.3.3 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
* Pass start_time to actions when the maintenance window for rolling upgrades is set to immediately {kibana-pull}136384[#136384]
* Allow agent bulk actions without specific licence restrictions {kibana-pull}136334[#136334]
* Adds reinstall button to integration settings page {kibana-pull}135590[#135590]

Lens & Visualizations::
Fixes normalizeTable performance bottleneck in *Lens* {kibana-pull}135792[#135792]

[id="release-notes-8.3.2",canonical-url="https://www.elastic.co/guide/en/kibana/current/release-notes.html"]
== {kib} 8.3.2

Review the following information about the {kib} 8.3.2 release.

[float]
[[breaking-changes-8.3.2]]
=== Breaking change

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking change, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.3.2.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.2/release-notes-8.2.0.html#breaking-changes-8.2.0[8.2.0] | {kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[fixes-v8.3.2]]
=== Bug fixes
Alerting::
Fixes an issue where alerting rules that were created or edited in 8.2.0 stopped running when you upgraded {kib} to 8.3.0 or 8.3.1 {kibana-pull}135663[#135663]

Discover::
* Hide Alerts menu item when user does not have access to Stack Rules {kibana-pull}135655[#135655]
* Fixes loading of a single doc JSON when using index alias based data views {kibana-pull}135446[#135446]

Elastic Security::
For the Elastic Security 8.3.2 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
Keep all agents selected in query selection mode {kibana-pull}135530[#135530]

Machine Learning::
* Fixes put anomaly detection job endpoint when payload contains datafeed {kibana-pull}134986[#134986]
* Fixes trained model map associating wrong model to job {kibana-pull}134849[#134849]
* Use time range when validating datafeed preview {kibana-pull}134073[#134073]

Maps::
* Do not show layer error for term joins when terms aggregation does not return results {kibana-pull}135564[#135564]
* Fixes Vector map layers will not render when runtime field has '%' {kibana-pull}135491[#135491]

[[release-notes-8.3.1]]
== {kib} 8.3.1

Review the following information about the {kib} 8.3.1 release.

[float]
[[known-issues-8.3.1]]
=== Known issues

[discrete]
[[known-issue-133965]]
.URL arguments cause API requests in Dev Tools to fail
[%collapsible]
====
*Details* +
When you add any URL arguments, such as `?v` or `?pretty`, to API requests, the requests fail  {kibana-issue}133965[#133965]

*Impact* +
The known issue only impacts {kib} Dev Tools. All other sources of API requests are unaffected, such as curl and Elastic Cloud API console.
====

[discrete]
[[known-issue-alerting-rule]]
.Alerting rules stop running when you upgrade to 8.3.0 or 8.3.1
[%collapsible]
====
*Details* +
In 8.3.0 and 8.3.1, there is a known issue where alerting rules that were created or edited in 8.2.0 stop running when you upgrade {kib}. When you upgrade to 8.3.0 or 8.3.1, and your alerting rules have stopped running, the following error appears:

[source,text]
----
<rule-type>:<UUID>: execution failed - security_exception: [security_exception] Reason: missing authentication credentials for REST request [/_security/user/_has_privileges], caused by: ""
----

*Impact* +
If you have upgraded to 8.3.0 or 8.3.1, and your alerting rules fail, reset the rules by disabling, then re-enabling them. When you disable, then re-enable your alerting rules, {kib} generates a new API key using the credentials of the user that manages the rules. 

To disable, then re-enable your alerting rules:

. Open the main menu, then click *{stack-manage-app} > {rac-ui}*.

. Select the failed alerting rules.

. Click **Manage rules > Disable**, then click **Manage rules > Enable**.

For more details about API key authorization, refer to <<alerting-authorization>>.
====

[float]
[[breaking-changes-8.3.1]]
=== Breaking change

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking change, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.3.1.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.2/release-notes-8.2.0.html#breaking-changes-8.2.0[8.2.0] | {kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[enhancement-v8.3.1]]
=== Enhancements
Operations::
Adds EsArchiver datastream support {kibana-pull}132853[#132853]

[float]
[[fixes-v8.3.1]]
=== Bug fixes
Alerting::
Prevent negative snooze intervals {kibana-pull}134935[#134935]

Elastic Security::
For the Elastic Security 8.3.1 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
* Fixes dropping select all {kibana-pull}135124[#135124]
* Improves bulk actions for more than 10k agents {kibana-pull}134565[#134565]

Infrastructure::
Query persistent queue size for metricbeat documents {kibana-pull}134569[#134569]

Observability::
* Fixes a bug that displayed a toast error when deleting a rule {kibana-pull}135132[#135132]
* Fixes viewInAppUrl for custom metrics for Inventory Threshold Rule {kibana-pull}134114[#134114]

Platform::
* Fixes an issue where importing/copying the same saved object to the same space multiple times using the "Check for existing objects" option could fail or cause duplicates to be created {kibana-pull}135358[#135358]
* Fixes a bug where {es} nodes that stopped, then started again, were unreachable by {kib} for a given amount of requests when {kib} was configured to connect to multiple {es} nodes {kibana-pull}134628[#134628]

[id="release-notes-8.3.0",canonical-url="https://www.elastic.co/guide/en/kibana/current/release-notes.html"]
== {kib} 8.3.0

Review the following information about the {kib} 8.3.0 release.

[float]
[[known-issues-8.3.0]]
=== Known issues

[discrete]
==== Alerting rules stop running on upgrade

Alerting users who are running 8.2 should not upgrade to either 8.3.0 or 8.3.1.
Both 8.3.0 and 8.3.1 have a bug where alerting rules that were created or edited
in 8.2 will stop running on upgrade. If you have upgraded to 8.3.0 or 8.3.1 and
your alerting rules have stopped running with an error similar to the following
example, you will need to go to *{stack-manage-app} > {rac-ui}*, multi-select
the failed rules, click on **Manage rules > Disable** and then click on 
**Manage rules > Enable**. Disabling and re-enabling the rule will generate a 
new API key using the credentials of the user performing these actions and reset 
the rule state. For more details about API key authorization, refer to 
<<alerting-authorization>>.

Example error message::

[source,text]
----
<rule-type>:<UUID>: execution failed - security_exception: [security_exception] Reason: missing authentication credentials for REST request [/_security/user/_has_privileges], caused by: ""
----

[discrete]
==== Snoozed alerting rules need to be cancelled before upgrade

If you have alerting rules that have been snoozed, do not upgrade {kib} from 
8.3.3 to 8.4.0. Upgrade to 8.4.1 instead.

To determine if you have snoozed alerting rules, open the main menu, then click 
**{stack-manage-app}** -> **{rac-ui}**. Filter the rule list by selecting
**View** -> **Snoozed**. If you must upgrade to 8.4.0, for each space, cancel
the snooze for all affected rules before you upgrade.

To identify snoozed rules in all Spaces using **Dev Tools**, run the following 
query:

[source,console]
----
GET /.kibana/_search
{
  "query": {
    "exists": {
      "field": "alert.isSnoozedUntil"
    }
  }
}
----

If you upgraded {kib} from 8.3.3 to 8.4.0 and you had alerting rules configured
to snooze notifications, you will receive the following error message:

[source,text]
----
FATAL  Error: Unable to complete saved object migrations for the [.kibana] index.
----

To fix than problem, restore your previous version, then upgrade to 8.4.1 instead.

[float]
[[breaking-changes-8.3.0]]
=== Breaking change

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking change, then mitigate the impact to your application.

[discrete]
[[breaking-129581]]
.Removes Quandl and Graphite integrations
[%collapsible]
====
*Details* +
The experimental `.quandl` and `.graphite` functions and advanced settings are removed from *Timelion*. For more information, check {kibana-pull}129581[#129581].

*Impact* +
When you use the `vis_type_timelion.graphiteUrls` kibana.yml setting, {kib} successfully starts, but logs a `[WARN ][config.deprecation] You no longer need to configure "vis_type_timelion.graphiteUrls".` warning.

To leave your feedback about the removal of `.quandl` and `.graphite`, go to the link:https://discuss.elastic.co/c/elastic-stack/kibana/7[discuss forum].
====

[discrete]
[[breaking-134855]]
.Makes Osquery All with All base privilege
[%collapsible]
====
*Details* +
The Osquery {kib} privilege has been updated, so that when the *Privileges for all features level* is set to *All*, this now applies *All* to Osquery privileges as well. Previously, users had to choose the *Customize* option to grant any access to Osquery. For more information, refer to {kibana-pull}130523[#130523].

*Impact* +
This impacts user roles that have *Privileges for all features* set to *All*. After this update, users with this role will have access to the Osquery page in {kib}. However, to use the Osquery feature fully, these requirements remain the same: users also need Read access to the logs-osquery_manager.result* index and the Osquery Manager integration must be deployed to Elastic Agents.
====

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.2/release-notes-8.2.0.html#breaking-changes-8.2.0[8.2.0] | {kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[deprecations-8.3.0]]
=== Deprecations

The following functionality is deprecated in 8.3.0, and will be removed in 9.0.0.
Deprecated functionality does not have an immediate impact on your application, but we strongly recommend
you make the necessary updates after you upgrade to 8.3.0.

[discrete]
[[deprecation-132790]]
.Removes `apm_user`
[%collapsible]
====
*Details* +
Removes the `apm_user` role. For more information, check {kibana-pull}132790[#132790].

*Impact* +
In the link:https://www.elastic.co/guide/en/kibana/8.3/xpack-apm.html[APM documentation], the `apm_user`role is replaced with the `viewer` and `editor` built-in roles.
====

[discrete]
[[deprecation-132562]]
.Deprecates input controls
[%collapsible]
====
*Details* +
The input control panels, which allow you to add interactive filters to dashboards, are deprecated. For more information, check {kibana-pull}132562[#132562].

*Impact* +
To add interactive filters to your dashboards, use the link:https://www.elastic.co/guide/en/kibana/8.3/add-controls.html[new controls].
====

[discrete]
[[deprecation-131636]]
.Deprecates anonymous authentication credentials
[%collapsible]
====
*Details* +
The apiKey, including key and ID/key pair, and `elasticsearch_anonymous_user` credential types for anonymous authentication providers are deprecated. For more information, check {kibana-pull}131636[#131636].

*Impact* +
If you have anonymous authentication provider configured with apiKey or `elasticsearch_anonymous_user` credential types, a deprecation warning appears, even when the provider is not enabled.
====

[discrete]
[[deprecation-131166]]
.Deprecates v1 and v2 security_linux and security_windows jobs
[%collapsible]
====
*Details* +
The v1 and v2 job configurations for security_linux and security_windows are deprecated. For more information, check {kibana-pull}131166[#131166].

*Impact* +
The following security_linux and security_windows job configurations are updated to v3:

* security_linux:

** v3_linux_anomalous_network_activity
** v3_linux_anomalous_network_port_activity_ecs
** v3_linux_anomalous_process_all_hosts_ecs
** v3_linux_anomalous_user_name_ecs
** v3_linux_network_configuration_discovery
** v3_linux_network_connection_discovery
** v3_linux_rare_metadata_process
** v3_linux_rare_metadata_user
** v3_linux_rare_sudo_user
** v3_linux_rare_user_compiler
** v3_linux_system_information_discovery
** v3_linux_system_process_discovery
** v3_linux_system_user_discovery
** v3_rare_process_by_host_linux_ecs

* security_windows:

** v3_rare_process_by_host_windows_ecs
** v3_windows_anomalous_network_activity_ecs
** v3_windows_anomalous_path_activity_ecs
** v3_windows_anomalous_process_all_hosts_ecs
** v3_windows_anomalous_process_creation
** v3_windows_anomalous_script
** v3_windows_anomalous_service
** v3_windows_anomalous_user_name_ecs
** v3_windows_rare_metadata_process
** v3_windows_rare_metadata_user
** v3_windows_rare_user_runas_event
** v3_windows_rare_user_type10_remote_login
====

[discrete]
[[deprecation-130336]]
.Updates the default legend size
[%collapsible]
====
*Details* +
In the *Lens* visualization editor, the *Auto* default for *Legend width* has been deprecated. For more information, check {kibana-pull}130336[#130336].

*Impact* +
When you create *Lens* visualization, the default for the *Legend width* is now *Medium*.
====

[discrete]
[[deprecation-122075]]
.Deprecates `xpack.data_enhanced.*`
[%collapsible]
====
*Details* +
In kibana.yml, the `xpack.data_enhanced.*` setting is deprecated. For more information, check {kibana-pull}122075[#122075].

*Impact* +
Use the `data.*` configuration parameters instead.
====

[float]
[[features-8.3.0]]
=== Features

{kib} 8.3.0 adds the following new and notable features.

Alerting::
* Adds circuit breaker for max number of actions by connector type {kibana-pull}128319[#128319]
* Adds `bulkEdit` method to alerting rulesClient and internal _bulk_edit API, that allow bulk editing of rules {kibana-pull}126904[#126904]

Cases::
* Adds average time to close metric in Cases {kibana-pull}131909[#131909]
* View all alerts attached to a case in the alerts table. The feature is experimental {kibana-pull}131883[#131883]
* Adds severity field to Cases {kibana-pull}131626[#131626]
* Adds the ability to delete comments in Cases {kibana-pull}130254[#130254]

Dashboard::
Enables the new controls by default {kibana-pull}131341[#131341]

Discover::
* To enable Threshold Alerts, adds the ability to edit dataView, query, & filters {kibana-pull}131688[#131688]
* To enable Threshold Alerts, extended the {es} query rule with search source-based data fetching {kibana-pull}124534[#124534]

Elastic Security::
For the Elastic Security 8.3.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
Changes to agent upgrade modal to allow for rolling upgrades {kibana-pull}132421[#132421]

Lens & Visualizations::
* Adds method to re-link visualizations with missing `SavedSearch` {kibana-pull}132729[#132729]
* Adds support of Data View switching for Agg-Based visualizations {kibana-pull}132184[#132184]

Machine Learning::
* Adds the ability to create anomaly detection jobs from Lens visualizations {kibana-pull}129762[#129762]
* Adds trained model testing for additional pytorch models {kibana-pull}129209[#129209]

Management::
* Adds saved object relationships to data view management {kibana-pull}132385[#132385]
* Adds support for feature_states {kibana-pull}131310[#131310]

Monitoring::
Adds the Stack monitoring health API {kibana-pull}132705[#132705]

Observability::
* Adds the ability to bulk attach multiple alerts to a Case {kibana-pull}130958[#130958]
* Adds rule details page {kibana-pull}130330[#130330]
* Adds span link {kibana-pull}126630[#126630]
* Adds ML expected model bounds as an option to Comparison controls {kibana-pull}132456[#132456]

Platform::
Adds `xyVis` and `layeredXyVis` {kibana-pull}128255[#128255]

Querying & Filtering::
Improves the current filter/search experience {kibana-pull}128401[#128401]

Sharing::
Adds method to re-link visualizations with missing index-pattern {kibana-pull}132336[#132336]

For more information about the features introduced in 8.3.0, refer to <<whats-new,What's new in 8.3>>.

[[enhancements-and-bug-fixes-v8.3.0]]
=== Enhancements and bug fixes

For detailed information about the 8.3.0 release, review the enhancements and bug fixes.

[float]
[[enhancement-v8.3.0]]
=== Enhancements
Alerting::
* Adds helper text in the edit rule form about the change in privileges when saving the rule {kibana-pull}131738[#131738]
* Display rule API key owner to users who can manage API keys {kibana-pull}131662[#131662]

Canvas::
Fixes reference line overlay {kibana-pull}132607[#132607]

Cases::
* Show a warning for deprecated preconfigured connectors {kibana-pull}132237[#132237]
* Reduce space taken by the reporter column in the all cases table {kibana-pull}132200[#132200]
* Adds a tooltip to show truncate tags in Cases {kibana-pull}132023[#132023]
* Adds the ability to create a case from within the selection case modal {kibana-pull}128882[#128882]

Content Management::
The list view for Dashboard, Visualize Library, Maps, and Graph has a new "Last updated" column to easily access content that has been recently modified {kibana-pull}132321[#132321]

Dashboard::
* Improves the banner {kibana-pull}132301[#132301]
* Adds Analytics No Data Page {kibana-pull}132188[#132188]
* Adds field first control creation {kibana-pull}131461[#131461]
* Make text field based Options list controls case Insensitive {kibana-pull}131198[#131198]
* Allow existing controls to change type {kibana-pull}129385[#129385]

Discover::
* Adds an option to hide specified filter actions from SearchBar filter panels {kibana-pull}132037[#132037]
* Adds Analytics No Data Page {kibana-pull}131965[#131965]
* Adds close button to field popover using Document Explorer {kibana-pull}131899[#131899]
* Adds monospace font in Document Explorer {kibana-pull}131513[#131513]
* Adds a tour for Document Explorer {kibana-pull}131125[#131125]
* Display current interval setting {kibana-pull}130850[#130850]
* Adds a direct link from sample data to Discover {kibana-pull}130108[#130108]

Elastic Security::
For the Elastic Security 8.3.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
* Move integration labels below title and normalise styling {kibana-pull}134360[#134360]
* Adds First Integration Multi Page Steps Flow MVP (cloud only) {kibana-pull}132809[#132809]
* Optimize package installation performance, phase 2 {kibana-pull}131627[#131627]
* Adds APM instrumentation for package install process {kibana-pull}131223[#131223]
* Adds "Label" column + filter to Agent list table {kibana-pull}131070[#131070]
* Adds `cache-control` headers to key `/epm` endpoints in Fleet API {kibana-pull}130921[#130921]
* Optimize package installation performance, phase 1 {kibana-pull}130906[#130906]
* Adds experimental features (feature flags) config to fleet plugin {kibana-pull}130253[#130253]
* Adds redesigned Fleet Server flyout {kibana-pull}127786[#127786]

Lens & Visualizations::
* Renders no data component if there is no {es} data or dataview in *Visualize* {kibana-pull}132223[#132223]
* Swaps dimensions for mosaic in *Lens* {kibana-pull}131945[#131945]
* Adds log and sqrt scale in *Lens* {kibana-pull}131940[#131940]
* Adds collapse fn to table and xy chart in *Lens* {kibana-pull}131748[#131748]
* Allow filtering on metric vis in *Lens* {kibana-pull}131601[#131601]
* Improved interval input in *Lens* {kibana-pull}131372[#131372]
* Adds the Discover drilldown to *Lens* {kibana-pull}131237[#131237]
* Update defaults for metric vis in *Lens* {kibana-pull}129968[#129968]
* Adds range event annotations in *Lens* {kibana-pull}129848[#129848]
* Adds accuracy mode for Top Values in *Lens* {kibana-pull}129220[#129220]
* Adds type murmur3 into the *Lens* fields list {kibana-pull}129029[#129029]

Machine Learning::
* Optimize resize behaviour for the Anomaly Explorer page {kibana-pull}132820[#132820]
* Wizard validation improvements {kibana-pull}132615[#132615]
* Support version fields in anomaly detection wizards {kibana-pull}132606[#132606]
* Context for recovered alerts {kibana-pull}132496[#132496]
* Adding UI for question_answering model testing {kibana-pull}132033[#132033]
* Adds recognized modules links for Index data visualizer {kibana-pull}131342[#131342]
* Anomaly Detection: Adds View in Maps item to Actions menu in the anomalies table {kibana-pull}131284[#131284]
* Adding v3 modules for Security_Linux and Security_Windows and Deprecating v1 + v2 {kibana-pull}131166[#131166]
* Data Frame Analytics creation wizard: add support for filters in saved searches {kibana-pull}130744[#130744]
* Edit job selection on data frame analytics results and map pages {kibana-pull}130419[#130419]
* Resizable/Collapsible Top Influencers section {kibana-pull}130018[#130018]

Management::
* Adds context for recovered alerts {kibana-pull}132707[#132707]
* Adds warnings for managed system policies {kibana-pull}132269[#132269]
* Skip empty prompt screen {kibana-pull}130862[#130862]
* Console now supports properly handling multiple requests. For es errors such as `400`, `405` exception results are displayed with successful request results in the order they called {kibana-pull}129443[#129443]
* Display vector tile API response in Console {kibana-pull}128922[#128922]
* Adds option to disable keyboard shortcuts {kibana-pull}128887[#128887]

Maps::
* Show marker size in legend {kibana-pull}132549[#132549]
* Fixes marker size scale issue for counts {kibana-pull}132057[#132057]
* Scale marker size by area {kibana-pull}131911[#131911]
* Localized basemaps {kibana-pull}130930[#130930]
* Support term joins for Elasticsearch document source with vector tile scaling {kibana-pull}129771[#129771]
* Allow feature editing for document layers with "applyGlobalTime", "applyGlobalQuery", and joins {kibana-pull}124803[#124803]

Observability::
* Bumps synthetics integration package to 0.9.4 {kibana-pull}133423[#133423]
* Immediately re-run monitors in the synthetics service when they're edited {kibana-pull}132639[#132639]
* Enables log flyouts on APM logs tables {kibana-pull}132617[#132617]
* Adds logging to Metric Threshold Rule {kibana-pull}132343[#132343]
* Adds Page load distribution chart to overview page {kibana-pull}132258[#132258]
* Show experimental locations only when a particular flag is enabled {kibana-pull}132063[#132063]
* Trace explorer {kibana-pull}131897[#131897]
* Static Java agent version list becomes stale quickly {kibana-pull}131759[#131759]
* Adds recovery context to Log Threshold rule {kibana-pull}131279[#131279]
* Adds recovery context to the Metric Threshold rule {kibana-pull}131264[#131264]
* Adds context variables to recovery alerts for Inventory Threshold rule {kibana-pull}131199[#131199]
* Copy alert state to alert context and implement alert recovery {kibana-pull}128693[#128693]
* Progressive fetching (experimental) {kibana-pull}127598[#127598]
* Replace environment dropdown with SuggestionsSelect in landing pages and service overview page {kibana-pull}126679[#126679]
* Store Logs UI settings in a dedicated `infrastructure-monitoring-log-view` saved object {kibana-pull}125014[#125014]

Platform::
* The saved objects management table has a new "Last updated" column to easily access recently modified saved objects {kibana-pull}132525[#132525]
* Sync panels tooltips on dashboard level {kibana-pull}130449[#130449]

Querying & Filtering::
* Support fields custom label on filter editor {kibana-pull}130533[#130533]
* Allows comma delimiter on the filters multiple selections dropdowns {kibana-pull}130266[#130266]

Security::
* Disallow creating a role with the existing name in the role management page. Introduce a new optional boolean `createOnly` parameter in the create role API to prevent overwriting existing roles {kibana-pull}132218[#132218]
* Adds experimental `csp.disableUnsafeEval` config option. Set this to `true` to remove the link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src#unsafe_eval_expressions[`unsafe-eval`] source expression from the `script-src` Content Security Policy (CSP) directive. The default value is `false`, which is identical to the original Kibana behavior {kibana-pull}124484[#124484]

[float]
[[fixes-v8.3.0]]
=== Bug fixes
Alerting::
* Don't load connectors and connector types when there isn't an encryptionKey {kibana-pull}133335[#133335]
* Adds cloud icon "ess-icon" at the end of the config keys in "alerting" {kibana-pull}131735[#131735]
* Fixes optional spaceId in rules_client {kibana-pull}130704[#130704]

Content Managment::
Fixes the listingLimit settings url {kibana-pull}129701[#129701]

Dashboard::
* Adds Fatal Error Handling {kibana-pull}133579[#133579]
* Hide in Print Mode {kibana-pull}133446[#133446]
* Send Control State to Reporting Via Locator {kibana-pull}133425[#133425]
* Fixes new controls causing unsaved changes bug {kibana-pull}132850[#132850]

Design::
* Keyboard shortcut popup {kibana-pull}133069[#133069]
* Adding aria-label for discover data grid select document checkbox {kibana-pull}131277[#131277]
* Adds item descriptions to edit button screen reader labels in TableListView {kibana-pull}125334[#125334]

Discover::
* Hide "Add a field", "Edit" and "Create a data view" buttons in viewer mode {kibana-pull}134582[#134582]
* Unify definition of field names and field descriptions {kibana-pull}134463[#134463]
* Address "Don't call Hooks" React warnings {kibana-pull}134339[#134339]
* Include current filters into "Test query" request {kibana-pull}134184[#134184]
* Prevent rule flyout from being open simultaneously with other popovers like search suggestions {kibana-pull}132108[#132108]
* Fixes link to open new window {kibana-pull}131930[#131930]
* Discover Classic View Filter In/Out placement when `truncate:maxHeight` is set to 0 {kibana-pull}129942[#129942]
* Fixes inconsistent usage of arrow icons on Surrounding documents page {kibana-pull}129292[#129292]
* Show a fallback empty message when no results are found {kibana-pull}128754[#128754]

Elastic Security::
For the Elastic Security 8.3.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
* Bulk reassign kuery optimize {kibana-pull}134673[#134673]
* Fixes flickering tabs layout in add agent flyout {kibana-pull}133769[#133769]
* Adds $ProgressPreference to windows install command in flyout {kibana-pull}133756[#133756]
* Fixes sorting by size on data streams table {kibana-pull}132833[#132833]

Infrastructure::
Pass decorated server to routes {kibana-pull}133264[#133264]

Lens & Visualizations::
* Hide null cells in Heatmap {kibana-pull}134450[#134450]
* Fixes formula generate error in *Lens* {kibana-pull}134434[#134434]
* Better default for date_range agg in *Visualize* {kibana-pull}134220[#134220]
* Keep suggestions stable in *Lens* {kibana-pull}134212[#134212]
* Fixes voiceover drag and drop in *Lens* {kibana-pull}134196[#134196]
* Fixes palette bug {kibana-pull}134159[#134159]
* Fixes multi index pattern load on the server in *TSVB* {kibana-pull}134091[#134091]
* Fixes axis title visibility bug in *Lens* {kibana-pull}134082[#134082]
* Fixes broken drilldowns for gauges and heatmaps in *Lens* {kibana-pull}134008[#134008]
* Fixes application of suffix formats in *Lens* {kibana-pull}133780[#133780]
* Do not show edit field for record field in *Lens* {kibana-pull}133762[#133762]
* Fixes discover drilldown for non-time field case in *Lens* {kibana-pull}133334[#133334]
* Do not reset session on Lens load with filters in *Lens* {kibana-pull}133191[#133191]
* Fixes transition issue in *Lens* {kibana-pull}132956[#132956]
* Escape label in lodash set command in *TSVB* {kibana-pull}132932[#132932]
* Changing the `Data View` logic with an initially missed `Data View` does not work in *TSVB* {kibana-pull}132796[#132796]
* Terms with keyword field with "numbers" is displayed with a weird date in *TSVB* {kibana-pull}132226[#132226]
* TSVB] Chart is failing when the user tries to add a percentile_rank {kibana-pull}132105[#132105]
* Fixes metric label font size in *Visualize* {kibana-pull}132100[#132100]
* Datatable: Do not apply truncation in value popover in *Lens* {kibana-pull}132005[#132005]
* Fixes percentile rank math in *TSVB* {kibana-pull}132003[#132003]
* Fixes timezone bucket shift in *Timelion* {kibana-pull}131213[#131213]
* Fixes vega controls layout in *Vega* {kibana-pull}130954[#130954]
* Fixes requesting not permitted or used data views in *Timelion* {kibana-pull}130899[#130899]
* Fixed bugs when using `include/exclude` options for Terms in *TSVB* {kibana-pull}130884[#130884]
* Make series agg work after math in *TSVB* {kibana-pull}130867[#130867]
* Use elastic-charts axis calculation in *Lens* {kibana-pull}130429[#130429]
* Make suggestions depend on active data in *Lens* {kibana-pull}129326[#129326]
* Adds back setMapView function in *Vega* {kibana-pull}128914[#128914]
* Fixes the Order by setting for split chart in metric and custom metric visualizations {kibana-pull}128185[#128185]

Machine Learning::
* Fixes creation of the custom URLs for Kibana Dashboard {kibana-pull}134248[#134248]
* Fixes expanded row stats not loading all correctly whenever sort by cardinality {kibana-pull}134113[#134113]
* Fixes Data visualizer showing 0 count in the doc count chart even though documents do exist {kibana-pull}134083[#134083]
* Fixes querying anomalies for the Single Metric Viewer {kibana-pull}133419[#133419]
* Fixes Anomaly Charts filtering based on the swim lane job selection {kibana-pull}133299[#133299]
* Fixes handling of unrecognised URLs {kibana-pull}133157[#133157]
* Prevent duplicate field selection in detector modal {kibana-pull}133018[#133018]
* Fixes single metric job with doc_count field {kibana-pull}132997[#132997]
* Hide job messages clear notifications tooltip on click {kibana-pull}132982[#132982]
* Filtering category runtime fields in advanced wizard {kibana-pull}132916[#132916]
* Fixes trained model testing so it is available for users with ML read permissions {kibana-pull}132698[#132698]
* Adding type for job summary state {kibana-pull}131643[#131643]

Management::
* Fixes linebreaks (\r\n) mis-applied from history {kibana-pull}131037[#131037]
* Fixes Kibana DevTool Copy as CURL does not url encode special chars in indice date math {kibana-pull}130970[#130970]
* Fixes cat APIs returning as escaped string {kibana-pull}130638[#130638]
* Fixes Elasticsearch doc VIEW IN CONSOLE will clean local Kibana console form history {kibana-pull}127430[#127430]

Maps::
* Fixes icon markers fail to load when browser zoomed out {kibana-pull}134367[#134367]
* Hide create filter UI in canvas {kibana-pull}133943[#133943]
* Use label features from ES vector tile search API to fix multiple labels {kibana-pull}132080[#132080]
* Fixes Map panels should not show the user controls in a dashboard report {kibana-pull}131970[#131970]
* Show "no results" found for vector tile aggregations when there are no results {kibana-pull}130821[#130821]

Monitoring::
* Prevent exceptions in rule when no data present {kibana-pull}131332[#131332]
* Fixes displaying ES version for external collection {kibana-pull}131194[#131194]
* Fixes node type detection for external collection {kibana-pull}131156[#131156]
* Use server.publicBaseUrl in Alert links {kibana-pull}131154[#131154]

Observability::
* Fixes x-axis on error charts {kibana-pull}134193[#134193]
* Display ENVIRONMENT_ALL label instead of value {kibana-pull}133616[#133616]
* Fixes normalizers to not parse list values if they are already parsed {kibana-pull}133563[#133563]
* Change bucket_scripts to use params for thresholds {kibana-pull}133214[#133214]
* Use Observability rule type registry for list of rule types {kibana-pull}132484[#132484]
* APM anomaly rule type should appear in observability rules page {kibana-pull}132476[#132476]
* Fixes monitors details page errors {kibana-pull}132196[#132196]
* Set a valid `service_name` for python APM onboarding {kibana-pull}131959[#131959]
* Rename service groups template titles and links {kibana-pull}131381[#131381]
* Show service group icon only for service groups {kibana-pull}131138[#131138]
* Refactor Metric Threshold rule to push evaluations to Elasticsearch {kibana-pull}126214[#126214]
* Ellipsis truncation issue - dependencies and service section {kibana-pull}122203[#122203]
* Fixes lookback window for anomalies for anomaly alert {kibana-pull}93389[#93389]

Operations::
Fixes error handling on precommit hook {kibana-pull}132998[#132998]

Platform::
Prevents Kibana from bootlooping during migrations when Elasticsearch routing allocation settings are incompatible {kibana-pull}131809[#131809]

Querying & Filtering::
Allows the negative character on the number type fields {kibana-pull}130653[#130653]

Reporting::
Remove controls from reports {kibana-pull}134240[#134240]

Security::
* Session view process events index will now match on prefixed index {kibana-pull}133984[#133984]
* Timestamp issue fix + updated Jest to include mock date format {kibana-pull}132290[#132290]
* Session view alerts loading improvements, and other polish / bug fixes {kibana-pull}131773[#131773]

/////
[[release-notes-8.2.3]]
== {kib} 8.2.3

Review the following information about the {kib} 8.2.3 release.

[float]
[[breaking-changes-8.2.3]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.2.2.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.2/release-notes-8.2.0.html#breaking-changes-8.2.0[8.2.0] | {kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[fixes-v8.2.3]]
=== Bug fixes
Elastic Security::
For the Elastic Security 8.2.3 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Fleet::
* Elastic Agent integration now installs automatically if agent monitoring is turned on in the agent policy {kibana-pull}133530[#133530]
* Removes {beats} tutorials from the Elastic Stack category {kibana-pull}132957[#132957]
Management::
Fixes an edge case in the Inspector request selector where duplicate request names could result in a UI bug {kibana-pull}133511[#133511]
Operations::
Fixes an issue where `node.options` was reset between upgrades in deb and rpm packages {kibana-pull}133249[#133249]
Platform::
defaultIndex attribute was migrated for config saved object {kibana-pull}133339[#133339]

[[release-notes-8.2.2]]
== {kib} 8.2.2

Review the following information about the {kib} 8.2.2 release.

[float]
[[breaking-changes-8.2.2]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.2.2.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.2/release-notes-8.2.0.html#breaking-changes-8.2.0[8.2.0] | {kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[fixes-v8.2.2]]
=== Bug fix
Machine Learning::
Fixes width of icon column in Messages table {kibana-pull}132444[#132444]

[[release-notes-8.2.1]]
== {kib} 8.2.1

Review the following information about the {kib} 8.2.1 release.

[float]
[[breaking-changes-8.2.1]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.2.1.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.2/release-notes-8.2.0.html#breaking-changes-8.2.0[8.2.0] | {kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[enhancement-v8.2.1]]
=== Enhancements
Elastic Security::
For the Elastic Security 8.2.1 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Monitoring::
* Adds the ability collect Telemetry {kibana-pull}130498[#130498]
* Adds the ability to report panels in dashboards by type {kibana-pull}130166[#130166]

[float]
[[fixes-v8.2.1]]
=== Bug fixes
Discover::
* Fixes Document Explorer infinite height growth {kibana-pull}131723[#131723]
* Fixes links in helper callouts {kibana-pull}130873[#130873]
Elastic Security::
For the Elastic Security 8.2.1 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Fleet::
* Removes legacy component templates on package install {kibana-pull}130758[#130758]
Lens & Visualizations::
* Fixes time shift bug in *Lens* {kibana-pull}132000[#132000]
* Fixes single color palette configuration {kibana-pull}131128[#131128]
Machine Learning::
* Removes alerting_rules from general job list items {kibana-pull}131936[#131936]
* Fixes management app docs links {kibana-pull}130776[#130776]
Management::
* Restores data view management field type conflict detail modal {kibana-pull}132197[#132197]
* Fixes test data for import and export between versions tests {kibana-pull}131470[#131470]
* Fixes condition auto-completion for templates in Console {kibana-pull}126881[#126881]
Maps::
* Fixes background tiles in a map panel might not load in a screenshot report {kibana-pull}131185[#131185]
Observability::
* Services without application metrics display an error {kibana-pull}131347[#131347]
* Correctly interprets the `resetting` and `reverting` job states {kibana-pull}129570[#129570]
Platform::
* Migrations incorrectly detects cluster routing allocation setting as incompatible {kibana-pull}131712[#131712]
* Fixes resetting image values {kibana-pull}131610[#131610]
* Fixes a bug causing the newsfeed to not be properly displayed in locales other than english {kibana-pull}131315[#131315]

[[release-notes-8.2.0]]
== {kib} 8.2.0

Review the following information about the {kib} 8.2.0 release.

[float]
[[known-issue-v8.2.0]]
=== Known issue

Lens & visualizations::
A change in the Markdown library that {kib} uses to create *TSVB* *Markdown* visualizations and *Text* dashboard panels renders some tables differently. For more information, check out link:https://github.com/markdown-it/markdown-it/pull/767[#767].

[float]
[[breaking-changes-8.2.0]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.2.0.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.1/release-notes-8.1.0.html#breaking-changes-8.1.0[8.1.0] | {kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[features-8.2.0]]
=== Features
{kib} 8.2.0 adds the following new and notable features.

Alerting::
* Keep the number_of_scheduled_actions in event log {kibana-pull}128438[#128438]
* Remove defaultRuleTaskTimeout and set ruleType specific timeout from kibana.yml {kibana-pull}128294[#128294]
* Limit the executable actions per rule execution {kibana-pull}128079[#128079] and {kibana-pull}126902[#126902]

Cases::
* Adds Cases to the Stack Management page as a technical preview feature {kibana-pull}125224[#125224]

Dashboard::
* Adds time slider control {kibana-pull}128305[#128305]
* Adds Control group search settings {kibana-pull}128090[#128090]
* Adds hierarchical chaining setting to Controls {kibana-pull}126649[#126649]
* Adds options list API and validation system {kibana-pull}123889[#123889]

Discover::
* Enables document explorer by default {kibana-pull}125485[#125485]
* Adds `Copy to clipboard` ability for column name of Document Explorer {kibana-pull}123892[#123892]

Elastic Security::
For the Elastic Security 8.2.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Lens & Visualizations::
* Adds manual annotations in *Lens* {kibana-pull}126456[#126456]
* Adds multi-field group by in *TSVB* {kibana-pull}126015[#126015]
* Adds ability to navigate to *Lens* with your current *TSVB* configuration {kibana-pull}114794[#114794]

Machine Learning::
* Add link to maps in charts section of Anomaly Explorer {kibana-pull}128697[#128697]
* Testing trained models in UI {kibana-pull}128359[#128359]
* Space aware trained models {kibana-pull}123487[#123487]

Management::
* Adds support for auto-complete for data streams {kibana-pull}126235[#126235]
* Adds ability to filter Data View UI for runtime fields {kibana-pull}124114[#124114]
* Adds ability to share data views across spaces via data view management {kibana-pull}123991[#123991]

Observability::
* Adds button which allows users to signup for the Synthetics service public beta {kibana-pull}128798[#128798]
* Adds "View in App URL" {{context.viewInAppUrl}} variable to the rule templating language {kibana-pull}128281[#128281]
* Adds "View in App URL" {{context.viewInAppUrl}} variable to the rule templating language {kibana-pull}128243[#128243]
* Adds "View in App URL" {{context.viewInAppUrl}} variable to the rule templating language {kibana-pull}127890[#127890]
* Adds view in app url as an action variable in the alert message for uptime app {kibana-pull}127478[#127478]

For more information about the features introduced in 8.2.0, refer to <<whats-new,What's new in 8.2>>.

[[enhancements-and-bug-fixes-v8.2.0]]
=== Enhancements and bug fixes

For detailed information about the 8.2.0 release, review the enhancements and bug fixes.

[float]
[[enhancement-v8.2.0]]
=== Enhancements
Alerting::
* Adds error logs in rule details page {kibana-pull}128925[#128925]
* Simplify error banner on rules {kibana-pull}128705[#128705]
* Adds Previous Snooze button {kibana-pull}128539[#128539]
* Adds Snooze UI and Unsnooze API {kibana-pull}128214[#128214]
* Adds aggs to know how many rules are snoozed {kibana-pull}128212[#128212]
* Adds a connector for xMatters {kibana-pull}122357[#122357]

Dashboard::
* Adds option to open dashboard drilldowns in new tab or window {kibana-pull}125773[#125773]
* Adds range slider Control {kibana-pull}125584[#125584]

Discover::
Adds ability to edit histogram as vis {kibana-pull}125705[#125705]

Elastic Security::
For the Elastic Security 8.2.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Enterprise Search::
For the Elastic Enterprise Search 8.2.0 release information, refer to {enterprise-search-ref}/changelog.html[_Elastic Enterprise Search Documentation Release notes_].

Fleet::
* Merge settings & mappings component template in @package {kibana-pull}128498[#128498]
* Redesign agent flyout {kibana-pull}128381[#128381]
* Adds a link from agent details page to agent dashboard {kibana-pull}127882[#127882]
* Update add agent instructions in fleet managed mode for Kubernetes {kibana-pull}127703[#127703]
* Added time_series_metric mapping for metric_type package field {kibana-pull}126322[#126322]
* Added support for dimension field {kibana-pull}126257[#126257]
* Refactor auto upgrade package policies logic {kibana-pull}125909[#125909]
* Move mappings from index template to component template {kibana-pull}124013[#124013]

Lens & Visualizations::
* Adds normalize_by_unit function and option in *Lens* {kibana-pull}128303[#128303]
* Adds suffix formatter in *Lens* {kibana-pull}128246[#128246]
* Adds Xy gap settings in *Lens* {kibana-pull}127749[#127749]
* Implements null instead of zero switch in *Lens* {kibana-pull}127731[#127731]
* Adds ability to include empty rows setting for date histogram in *Lens* {kibana-pull}127453[#127453]
* Adds support for multi rows headers for the table visualization in *Lens* {kibana-pull}127447[#127447]
* Adds ability to open *Lens* visualizations in *Discover* from dashboards {kibana-pull}127355[#127355]
* Auto-set exists filtering for last value in *Lens* {kibana-pull}127251[#127251]
* Adds ability to include number of values in default terms field label in *lens* {kibana-pull}127222[#127222]
* Adds ability to drop partial buckets option in *Lens* {kibana-pull}127153[#127153]
* Addds ability to allow top metric for last value in *Lens* {kibana-pull}127151[#127151]
* Improves Datatable content height with custom row height in *Lens* {kibana-pull}127134[#127134]
* Adds ability to set legend pixel width in *Lens* {kibana-pull}126018[#126018]
* Adds underlying data editor navigation in *Lens* {kibana-pull}125983[#125983]
* Adds top metrics aggregation to AggConfigs, Expressions, and Visualize {kibana-pull}125936[#125936]
* Adds the ability to detach from global time range in *Lens* {kibana-pull}125563[#125563]
* Adds last value, min and max on dates, allow last value on ip_range, number_range, and date_range in *Lens* {kibana-pull}125389[#125389]
* Adds version-aware sorting to data table in *Lens* {kibana-pull}125361[#125361]
* Cancel discarded searches in *Timelion* {kibana-pull}125255[#125255]
* Cancel discarded searches in *TSVB* {kibana-pull}125197[#125197]
* Adds the ability to allow users to disable auto-apply in *Lens* {kibana-pull}125158[#125158]
* Adds Filter custom label for kibanaAddFilter in *Vega* {kibana-pull}124498[#124498]
* Adds metric Viz config options, title position, and sizing in *Lens* {kibana-pull}124124[#124124]
* Adds the ability to make graph edges easier to click {kibana-pull}124053[#124053]
* Adds "Show empty rows" options to intervals function in *Lens* {kibana-pull}118855[#118855]

Machine Learning::
* Combines annotations into one block if multiple annotations overlap {kibana-pull}128782[#128782]
* Adds `throughput_last_minute` to the deployment stats {kibana-pull}128611[#128611]
* Adds new API endpoint to improve anomaly chart performance {kibana-pull}128165[#128165]
* Utilize ML memory stats endpoint for the memory overview chart {kibana-pull}127751[#127751]
* Deleting trained model space checks {kibana-pull}127438[#127438]
* Show at least one correlation value and consolidate correlations columns {kibana-pull}126683[#126683]
* Include fields not in docs in Data Visualizer field name control {kibana-pull}126519[#126519]
* Anomaly Explorer performance enhancements {kibana-pull}126274[#126274]
* Fixes Index data visualizer reaching Elasticsearch rate request limits {kibana-pull}124898[#124898]
* Adds cache for data recognizer module configs to reduce number of privilege checks {kibana-pull}126338[#126338]

Management::
* Extend Transform Health alerting rule with error messages check {kibana-pull}128731[#128731]
* Enable opening queries from any UI {kibana-pull}127461[#127461]
* No Data Views Component {kibana-pull}125403[#125403]

Maps::
* Remove usage of max file size advanced setting 1GB limit in geo file upload {kibana-pull}127639[#127639]
* Adds support for geohex_grid aggregation {kibana-pull}127170[#127170]
* Lens choropleth chart {kibana-pull}126819[#126819]
* Register GeoJson upload with integrations page {kibana-pull}126350[#126350]
* Support custom icons in maps {kibana-pull}113144[#113144]

Observability::
* Guided setup progress {kibana-pull}128382[#128382]
* Enable check for public beta {kibana-pull}128240[#128240]
* Guided setup button on the overview page {kibana-pull}128172[#128172]
* Show warning when users exceed a Synthetics Node throttling limits {kibana-pull}127961[#127961]
* Adds logging to Inventory Threshold Rule {kibana-pull}127838[#127838]
* O11y rules page {kibana-pull}127406[#127406]
* Enrich documents generated by the synthetics service with `port` information {kibana-pull}127180[#127180]
* Make UI indices space aware (support for spaces) {kibana-pull}126176[#126176]
* Setting for default env for service inventory {kibana-pull}126151[#126151]
* Alerts in overview page {kibana-pull}125337[#125337]
* Adds log rate to Exploratory View {kibana-pull}125109[#125109]
* Support switching between log source modes {kibana-pull}124929[#124929]
* Overview style updates {kibana-pull}124702[#124702]
* Adds full screen/copy button ability in browser inline script editing {kibana-pull}124500[#124500]
* Update position of legend and it's controls {kibana-pull}115854[#115854]

Platform::
Allow customizing {es} client maxSockets {kibana-pull}126937[#126937]

[float]
[[fixes-v8.2.0]]
=== Bug Fixes
Alerting::
* Fixes bug when providing a single value to the `fields` query parameter of the Cases find API {kibana-pull}128143[#128143]
* Fixes the count of alerts in the cases table. Only unique alerts are being counted {kibana-pull}127721[#127721]
* Do not show the lens action if Visualize feature is not enabled {kibana-pull}127613[#127613]

Dashboard::
* Fixes control removal {kibana-pull}128699[#128699]
* Select televant data view ID {kibana-pull}128440[#128440]
* Close controls flyouts on unmount, save, and view mode change {kibana-pull}128198[#128198]

Discover::
* Account for hidden time column in default sort {kibana-pull}129659[#129659]
* Make field icons consistent across field list and doc tables {kibana-pull}129621[#129621]
* Fixes `Filter for field present` in expanded document view of Document Explorer {kibana-pull}129588[#129588]
* Cancel long running request after navigating out from Discover {kibana-pull}129444[#129444]
* Fixes height of JSON tab in Document flyout when using Document explorer in Safari {kibana-pull}129348[#129348]
* Fixes stuck action menu in expanded document sidebar {kibana-pull}127588[#127588]

Elastic Security::
For the Elastic Security 8.2.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Lens & Visualizations::
* Fixes multi index pattern load bug in *TSVB* {kibana-pull}130428[#130428]
* Handle empty values for range formatters {kibana-pull}129572[#129572]
* Apply pinned filters to *Lens* {kibana-pull}129503[#129503]
* Imported vislib pie triggers unsaved viz warning when embedded on a dashboard in *Visualize* {kibana-pull}129336[#129336]
* Fixes auto session-renewal on non-timebased data views in *Lens* {kibana-pull}129313[#129313]
* Fixes steps behavior to happen at the change point in *TSVB* {kibana-pull}128741[#128741]
* Improve check for 0 opacity in *TSVB* {kibana-pull}128630[#128630]
* Fixes firefox scrollbars in *Vega* {kibana-pull}128515[#128515]
* Log data tables properly in *Lens* {kibana-pull}128297[#128297]
* Fixes annotation bounds bug in *TSVB* {kibana-pull}128242[#128242]
* Make sure x axis values are always strings in *Lens* {kibana-pull}128160[#128160]
* Use default number formatter as fallback if nothing else is specified in *Timelion* {kibana-pull}128155[#128155]
* Enable Save&Return button for canvas when dashboard permissions are off in *Visualize* {kibana-pull}128136[#128136]
* Fixes permission problem for "Save and return" button in *Lens* {kibana-pull}127963[#127963]
* Restore operation auto switch based on field type in *Lens* {kibana-pull}127861[#127861]
* Fixes mosaic color syncing in *Lens* {kibana-pull}127707[#127707]
* Make edge selection work {kibana-pull}127456[#127456]
* Remove opacity for fitting line series {kibana-pull}127176[#127176]
* Handle line/area fitting function when the editor has started with bar configuration in *Visualize* {kibana-pull}126891[#126891]
* Preserve custom label when changing with multi-terms settings in *Lens* {kibana-pull}126773[#126773]
* Fixes multi terms fields validation in *Lens* {kibana-pull}126618[#126618]
* Make Embeddable resilient when toggling actions in *Lens* {kibana-pull}126558[#126558]
* Make graph app resilient to no fields or missing data views {kibana-pull}126441[#126441]
* Fixes Formula to Quick functions does not preserve custom formatting in *Lens* {kibana-pull}124840[#124840]
* Inspector displays only visible content {kibana-pull}124677[#124677]
* Coloring tooltips in Heatmap are not properly positioned in *Visualize* {kibana-pull}124507[#124507]
* Adds rison helper and URL encoding for drilldown urls in *TSVB* {kibana-pull}124185[#124185]

Machine Learning::
* Fixes alignment of Anomaly Explorer swim lane annotations label on Firefox {kibana-pull}130274[#130274]
* Fixes Single Metric Viewer chart failing to load if no points during calendar event {kibana-pull}130000[#130000]
* Fixes Single Metric Viewer for jobs that haven't been run {kibana-pull}129063[#129063]
* Fix outlier detection results exploration color legend display {kibana-pull}129058[#129058]
* Fixes new anomaly detection job from saved search with no query filter {kibana-pull}129022[#129022]
* Fixes data frame analytics map saved object sync warning {kibana-pull}128876[#128876]
* Adds error toast to Data visualizer when using unpopulated time field {kibana-pull}127196[#127196]

Management::
* Transforms: Fix to not pass on default values in configurations {kibana-pull}129091[#129091]
* Encode + sign in ISO8601 time range in query {kibana-pull}126660[#126660]

Maps::
* Fixes lens region map visualization throws a silent error {kibana-pull}129608[#129608]
* Fixes double click issue when deleting a shape {kibana-pull}124661[#124661]

Monitoring::
* Exclude Malwarescore + Ransomware EP alerts from DRule telemetry {kibana-pull}130233[#130233]
* Rename "APM & Fleet Server" to "Integrations Server" {kibana-pull}128574[#128574]
* Fixes sorting by node status on nodes listing page {kibana-pull}128323[#128323]

Observability::
* Service environment should be selected when you edit the agent configuration {kibana-pull}129929[#129929]
* Adds migration to include synthetics and heartbeat indices on 8.2.0 {kibana-pull}129510[#129510]
* Rules summary on the Alerts view is not showing the count of rules {kibana-pull}129052[#129052]
* Fixes shadow for overview panels {kibana-pull}128878[#128878]
* Ensure rum_allow_origins setting only saves valid YAML strings {kibana-pull}128704[#128704]
* Standardize NOW as startedAt from executor options {kibana-pull}128020[#128020]
* Fixes synthetics recorder file upload {kibana-pull}127614[#127614]
* Service maps popover detail metrics are aggregates over all transaction types {kibana-pull}125580[#125580]

Platform::
* Fixes an issue where duplicate data appears in the inspector datatable in *Lens* for heatmap visualizations, and stale data persists in the inspector datatable when you remove layers {kibana-pull}126786[#126786]
* Fixes an issue that caused {kib} to become unresponsive while generating a PDF report {kibana-pull}124787[#124787]
* Fixes an issue where an unfriendly notification title displays after you create a report {kibana-pull}123607[#123607]

Security::
* Fixes styles for "You do not have permission" screen {kibana-pull}129715[#129715]
* Change session expiration to override on app leave behavior {kibana-pull}129384[#129384]

[[release-notes-8.1.3]]
== {kib} 8.1.3

Review the following information about the {kib} 8.1.3 release.

[float]
[[security-update-v8.1.3]]
=== Security update

The 8.1.3 release contains a fix to a potential security vulnerability. For more information, check link:https://discuss.elastic.co/t/kibana-7-17-3-and-8-1-3-security-update/302826[Security Announcements].

[float]
[[breaking-changes-8.1.3]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.1.3.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[fixes-v8.1.3]]
=== Bug fix
Discover::
* Fixes toggle table column for classic table {kibana-pull}128603[#128603]

[[release-notes-8.1.2]]
== {kib} 8.1.2

	@@ -35,12 +66,8 @@ Review the following information about the {kib} 8.1.2 release.
Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.1.2.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[[release-notes-8.1.2]]
== {kib} 8.1.2

Review the following information about the {kib} 8.1.2 release.

[float]
[[breaking-changes-8.1.2]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.1.2.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[enhancement-v8.1.2]]
=== Enhancement
Dashboard::
Improve controls management UX {kibana-pull}127524[#127524]

[float]
[[fixes-v8.1.2]]
=== Bug fixes
Discover::
* Fixes toggle table column for classic table {kibana-pull}128603[#128603]
* Fixes selection popover close action without making a selection in Document Explorer {kibana-pull}128124[#128124]

Elastic Security::
For the Elastic Security 8.1.2 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Management::
Handle scenario when user has no indices {kibana-pull}128066[#128066]

Monitoring::
Rename "APM & Fleet Server" to "Integrations Server" {kibana-pull}128574[#128574]

Platform::
Fixes KQL typeahead missing description and improve display for long field names {kibana-pull}128480[#128480]

[[release-notes-8.1.1]]
== {kib} 8.1.1

Review the following information about the {kib} 8.1.1 release.

[float]
[[breaking-changes-8.1.1]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade to 8.1.1, review the breaking changes, then mitigate the impact to your application.

There are no breaking changes in {kib} 8.1.1.

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[enhancement-v8.1.1]]
=== Enhancement
Dashboard::
Improves controls empty state {kibana-pull}125728[#125728]

[float]
[[fixes-v8.1.1]]
=== Bug fixes
Data ingest::
The dot expander processor in the Ingest Pipelines UI now allows setting a wildcard (`*`) for the field parameter {kibana-pull}123522[#123522]

Elastic Security::
For the Elastic Security 8.1.1 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Enterprise Search::
For the Elastic Enterprise Search 8.1.1 release information, refer to {enterprise-search-ref}/changelog.html[_Elastic Enterprise Search Documentation Release notes_].

Fleet::
* Adds a new validation message {kibana-pull}127239[#127239]
* Fixes empty assets on package install {kibana-pull}127070[#127070]
* Hide enroll command when user creates a new agent policy in the Add agent flyout {kibana-pull}126431[#126431]
* Makes input IDs unique in agent policy yaml {kibana-pull}127343[#127343]
* Fixes links to Agent logs for APM, Endpoint, Synthetics, and OSQuery {kibana-pull}127480[#127480]

[[release-notes-8.1.0]]
== {kib} 8.1.0

Review the following information about the {kib} 8.1.0 release.

[float]
[[breaking-changes-8.1.0]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade to 8.1.0, review the breaking changes, then mitigate the impact to your application.

[discrete]
[[breaking-121435]]
.Removes legacy CSV export type
[%collapsible]
====
*Details* +
The `/api/reporting/generate/csv` endpoint has been removed. For more information, refer to {kibana-pull}121435[#121435].

*Impact* +
If you are using 7.13.0 and earlier, {kibana-ref-all}/8.1/automating-report-generation.html[regenerate the POST URLs] that you use to automatatically generate CSV reports.
====

[discrete]
[[breaking-121369]]
.Removes legacy PDF shim
[%collapsible]
====
*Details* +
The POST URLs that you generated in {kib} 6.2.0 no longer work. For more information, refer to {kibana-pull}121369[#121369].

*Impact* +
{kibana-ref-all}/8.1/automating-report-generation.html[Regenerate the POST URLs] that you use to automatatically generate PDF reports.
====

To review the breaking changes in previous versions, refer to the following:

{kibana-ref-all}/8.0/release-notes-8.0.0.html#breaking-changes-8.0.0[8.0.0] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc2.html#breaking-changes-8.0.0-rc2[8.0.0-rc2] | {kibana-ref-all}/8.0/release-notes-8.0.0-rc1.html#breaking-changes-8.0.0-rc1[8.0.0-rc1] | {kibana-ref-all}/8.0/release-notes-8.0.0-beta1.html#breaking-changes-8.0.0-beta1[8.0.0-beta1] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha2.html#breaking-changes-8.0.0-alpha2[8.0.0-alpha2] | {kibana-ref-all}/8.0/release-notes-8.0.0-alpha1.html#breaking-changes-8.0.0-alpha1[8.0.0-alpha1]

[float]
[[features-8.1.0]]
=== Features
{kib} 8.1.0 adds the following new and notable features.

Canvas::
* Adds Heatmap {kibana-pull}120239[#120239]
* Adds the *Filters* panel for element settings {kibana-pull}117270[#117270] and {kibana-pull}116592[#116592]

Discover::
* Adds document explorer callout {kibana-pull}123814[#123814]
* Adds ability to create data views from the sidebar {kibana-pull}123391[#123391]
* Adds redirect if there are no data views {kibana-pull}123366[#123366]
* Adds row height options {kibana-pull}122087[#122087]

Elastic Security::
For the Elastic Security 8.1.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Lens & Visualizations::
* Adds the waffle visualization type to *Lens* {kibana-pull}119339[#119339]
* Adds the gauge visualization type to *Lens* {kibana-pull}118616[#118616]
* Adds multi terms support to *Top Values* in *Lens* {kibana-pull}118600[#118600]
* Adds a new heatmap implementation with elastic-charts to *Visualize Library* {kibana-pull}118338[#118338]
* Adds the Mosaic or mekko visualization type to *Lens* {kibana-pull}117668[#117668]
* Adds the ability to configure the Metric visualization type color palette in *Lens* {kibana-pull}116170[#116170]

Machine Learning::
* Enable Field statistics table on by default {kibana-pull}124046[#124046]
* Adds grouping to the side nav {kibana-pull}123805[#123805]
* Integration part 1: Create anomalies layer in maps {kibana-pull}122862[#122862]
* Replace navigation bar with a side nav {kibana-pull}121652[#121652]
* Overview page redesign {kibana-pull}120966[#120966]

Management::
* Support suggesting index templates v2 {kibana-pull}124655[#124655]
* *Console* now supports autocompletion for index templates and component templates introduced in {es} 7.8.0.
* Transforms: Support to set destination ingest pipeline {kibana-pull}123911[#123911]
* Transforms: Adds reset action to transforms management {kibana-pull}123735[#123735]
* Transforms: Support for terms agg in pivot configurations {kibana-pull}123634[#123634]

Observability::
* Adds Tail-based sampling settings {kibana-pull}124025[#124025]
* APM UI changes for serverless services / AWS lambda {kibana-pull}122775[#122775]

For more information about the features introduced in 8.1.0, refer to <<whats-new,What's new in 8.1>>.

[[enhancements-and-bug-fixes-v8.1.0]]
=== Enhancements and bug fixes

For detailed information about the 8.1.0 release, review the enhancements and bug fixes.

[float]
[[enhancement-v8.1.0]]
=== Enhancements
Alerting::
* Adds P50/95/99 for rule execution duration in the rules table {kibana-pull}123603[#123603]
* Adds dropdown for number of executions in Rule Details view {kibana-pull}122595[#122595]

Canvas::
* Adds titles to the heatmap axis {kibana-pull}123992[#123992]
* Adds the esql Monaco editor {kibana-pull}118531[#118531]
* Adds expression `metrisVis` workpad arguments {kibana-pull}114808[#114808]

Dashboard::
Adds the ability to always allow internal URLs in *Vega* {kibana-pull}124705[#124705]

Data ingest::
Adds the ability to create ingest pipelines from a CSV upload that enables mapping custom data source into ECS {kibana-pull}101216[#101216]

Discover::
* Improves the document explorer flyout {kibana-pull}120116[#120116]
* Adds the ability to preserve *Discover* main route state in breadcrumb links {kibana-pull}119838[#119838]
* Adds error state if chart loading fails {kibana-pull}119289[#119289]
* Enable Field statistics table on by default {kibana-pull}124046[#124046]

Elastic Security::
For the Elastic Security 8.1.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
* Adds shipper label {kibana-pull}122491[#122491]
* Adds support for non-superuser access to *Fleet* and *Integrations* {kibana-pull}122347[#122347]
* Adds support for bundling packages as zip archives with {kib} source {kibana-pull}122297[#122297]
* Makes the default integration install explicit {kibana-pull}121628[#121628]

Lens & Visualizations::
* Addx suport for timefilter/min/max in *Vega* URLs {kibana-pull}124077[#124077]
* The filtered field list now uses field caps API in *Lens* {kibana-pull}122915[#122915]
* Updates the *Lens* empty state copy {kibana-pull}122174[#122174]
* Adds a global filter for formulas in *Lens* {kibana-pull}121768[#121768]
* Adds rare terms in *Lens* {kibana-pull}121500[#121500]
* Adds previous time shift back in *Lens* {kibana-pull}121284[#121284]
* Adds the size ratio setting to pie and donut charts in *Lens* {kibana-pull}120101[#120101]
* Adds multi terms dnd support in *Lens* {kibana-pull}119841[#119841]
* Improves the color stop UI in *Lens* {kibana-pull}119165[#119165]
* Enables table pagination in *Lens* {kibana-pull}118557[#118557]
* Adds support for ephemeral sort to the data table embeddable {kibana-pull}117742[#117742]
* Debounce duplicate error messages in *Vega* {kibana-pull}116408[#116408]
* Replaces EUICodeEditor with Monaco in *Vega* {kibana-pull}116041[#116041]

Machine Learning::
* Adds missing document titles {kibana-pull}124125[#124125]
* Synchronize Anomaly charts cursor position for X-axis with *Lens* visualizations in *Dashboard* {kibana-pull}123951[#123951]
* Adds grouping to the side nav {kibana-pull}123805[#123805]
* Adds empty states for the Jobs list pages {kibana-pull}123462[#123462]
* Adds error messages to Index data visualizer and improve distribution charts for fields with low cardinality {kibana-pull}123306[#123306]
* Standardize Add embeddable flow from the Anomaly Explorer page {kibana-pull}123199[#123199]
* Integration part 1: Create anomalies layer in *Maps** {kibana-pull}122862[#122862]
* Adds options to exclude or include frozen data tier for Anomaly detection and Index data visualizer {kibana-pull}122306[#122306]
* Editing semi-structured text fields in grok pattern {kibana-pull}122274[#122274]
* Adds extra search deep links for nodes overview and file upload {kibana-pull}121740[#121740]
* Replace navigation bar with a side nav {kibana-pull}121652[#121652]
* File data visualizer reduce chunk size for slow processors {kibana-pull}121353[#121353]
* Adds ability to save session to Index data visualizer {kibana-pull}121053[#121053]
* Overview page redesign {kibana-pull}120966[#120966]
* Adds *Maps* UI action to Index data visualizer/*Discover* Field statistics {kibana-pull}120846[#120846]
* Adds auto generated drill down link to *Discover* for Anomaly explorer table {kibana-pull}120450[#120450]
* Adds multilayer time axis style to Data visualizer doc count chart {kibana-pull}117398[#117398]

Management::
* Transforms: Add call out warning & delete option if a task exists for a transform without a config {kibana-pull}123407[#123407]
* Adds warnings for actions for managed Anomaly detection jobs and Transforms {kibana-pull}122305[#122305]
* Refresh frequency refinements {kibana-pull}122125[#122125]
* Configure refresh frequency {kibana-pull}121874[#121874]
* Geo point field formatter {kibana-pull}121821[#121821]
* Adds links to docs {kibana-pull}121066[#121066]
* Highlight the tutorial example text with console syntax {kibana-pull}120474[#120474]
* Compress mappings response size for autocomplete {kibana-pull}120456[#120456]
* Handle binary data response {kibana-pull}119586[#119586]
* Improve error handling when local storage quota is full {kibana-pull}118495[#118495]
* Error handling {kibana-pull}109233[#109233]

Maps::
* Adds Shapefile import {kibana-pull}123764[#123764]
* Should be able to zoom in on selected range of timeslider {kibana-pull}122131[#122131]
* Delete button should be toggleable in Edit Features {kibana-pull}122017[#122017]
* Change "show as" from EuiSelect to EuiButtonGroup {kibana-pull}121960[#121960]
* Format counts {kibana-pull}119646[#119646]
* Convert maki icons to SDF sprites on-the-fly {kibana-pull}119245[#119245]
* Convert HeatmapLayer to vector tiles and add support for high resolution grids {kibana-pull}119070[#119070]
* Make the icon for max results limit more evident {kibana-pull}118044[#118044]
* Enable on-prem for *Vega* {kibana-pull}104422[#104422]

Monitoring::
Compatibility for agent data streams {kibana-pull}119112[#119112]

Observability::
* Adds Tail-based sampling settings {kibana-pull}124025[#124025]
* UI Monitor Management - Add namespace field {kibana-pull}123248[#123248]
* Default alert connectors email settings {kibana-pull}123244[#123244]
* Only show span.sync badge when relevant {kibana-pull}123038[#123038]
* Optimize waffle map {kibana-pull}122889[#122889]
* APM UI changes for serverless services / AWS lambda {kibana-pull}122775[#122775]
* Update the style of the service/backend info icons in the selected service/backend header {kibana-pull}122587[#122587]
* Adds basic infra metrics config {kibana-pull}120881[#120881]
* Adds comparision to service maps popover {kibana-pull}120839[#120839]
* Link originating service in traces list table {kibana-pull}120768[#120768]
* Prefer `service.name` for logs correlation {kibana-pull}120694[#120694]
* Query numerator & denominator simultaneously for log threshold alerts {kibana-pull}107566[#107566]

Operations::
Improves the file logging capabilities so that missing directories in the configured file path are now created before {kib} attempts to write to the file {kibana-pull}117666[#117666]

Platform::
* Add a new `elasticsearch.compression` configuration property to enable compression for communications between {kib} and {es} {kibana-pull}124009[#124009]
* Adds support of comments {kibana-pull}122457[#122457]
* Adds support for PNG and PDF reports on Darwin Arm64 architecture {kibana-pull}122057[#122057]
* Short URL client is now accessible on the frontend through plugin contract. *Dashboard* and *Discover* shared short URLs now contain a three word, human-readable slug {kibana-pull}121886[#121886]
* Adds the ability to add URL drilldowns to *Dashboard* panels {kibana-pull}121801[#121801]
* Adds a new structure to the report details flyout to help you find information faster {kibana-pull}120617[#120617]
* Adds HTML tag and impact level to axe-core CI violation reporter {kibana-pull}119903[#119903]
* Exposes {es} accuracy warnings to the user {kibana-pull}116632[#116632]

Querying & Filtering::
Improves the version field type {kibana-pull}123739[#123739]

Security::
* Audit logs now include records for individual saved objects when an entire space is deleted {kibana-pull}124145[#124145]
* User login audit events now include the session ID for better correlation, and single sign-on flows no longer result in an extra `user_logout` event {kibana-pull}124299[#124299]

[float]
[[fixes-v8.1.0]]
=== Bug Fixes
Alerting::
* Fixes the pagination results for fetching existing alerts {kibana-pull}122474[#122474]
* Running disabled rules are now skipped {kibana-pull}119239[#119239]

Canvas::
* Fixes an issue where the image repeat element was not updating {kibana-pull}118701[#118701]
* Fixes an issue where *Canvas* validated values before saving variables {kibana-pull}118694[#118694]

Dashboard::
Adds the listing page callout when new dashboards are in progress {kibana-pull}117237[#117237]

Discover::
* Adds the ability to close the expanded document sidebar when you change data views {kibana-pull}119736[#119736]
* Fixes search on page load tests {kibana-pull}119087[#119087]

Elastic Security::
For the Elastic Security 8.1.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Enterprise Search::
For the Elastic Enterprise Search 8.1.0 release information, refer to {enterprise-search-ref}/changelog.html[_Elastic Enterprise Search Documentation Release notes_].

Fleet::
* Readded missing packages to keep up to date list {kibana-pull}125787[#125787]
* Trimmed whitespace from package policy names {kibana-pull}125400[#125400]

Lens & Visualizations::
* Fixes some dashboard visualizations that could show "Could not located index pattern" errors when copied from one space to another {kibana-pull}126499[#126499]
* Rarity is not allowed in some cases in *Lens* {kibana-pull}125523[#125523]
* Fixes formatting logic for terms in *Lens* {kibana-pull}125408[#125408]
* Fixes focus on submitting filter popover in *Lens* {kibana-pull}125247[#125247]
* Fixes agg filter for sibling pipeline aggs {kibana-pull}125227[#125227]
* Panel intervals are now used for annotations in *TSVB* {kibana-pull}125222[#125222]
* Outdated inspector data is now hidden in *Vega* {kibana-pull}125051[#125051]
* *Vega* visualizations are no longer missing in sample data reports {kibana-pull}124886[#124886]
* Lucene queries on dashboards are now accepted on annotations and tables in *TSVB* {kibana-pull}124802[#124802]
* Top values now work for custom numeric formatters in *Lens* {kibana-pull}124566[#124566]
* Coloring tooltip in Heatmap is now working for `">= n"` values in *Visualize Library* {kibana-pull}124521[#124521]
* Fixes a metric contrast issue in *TSVB* {kibana-pull}124509[#124509]
* Do not refresh session on "now" drift on incoming data in *Lens* {kibana-pull}124389[#124389]
* Coloring tooltips in Pie are not properly positioned in *Visualize* {kibana-pull}124330[#124330]
* Label placeholder always defaults to the lens proposed text in *Lens* {kibana-pull}124222[#124222]
* Show warning for completely static formula in *Lens* {kibana-pull}124213[#124213]
* Adds step value to make Safari validation work properly in *Lens* {kibana-pull}124210[#124210]
* Guard against parse failures in *Visualize* {kibana-pull}124209[#124209]
* Fixes heatmap suggestions in *Lens* {kibana-pull}124099[#124099]
* Fixes the percentage format for percentiles series {kibana-pull}124098[#124098]
* Displays custom bounds error for right axis when lower bound is above 0 in *Lens* {kibana-pull}124037[#124037]
* Clicking a series agg timeseries chart split by terms should not create a filter in *TSVB* {kibana-pull}124031[#124031]
* Save default data view in *TSVB* {kibana-pull}123997[#123997]
* Switch default bar width to 0px in *TSVB* {kibana-pull}123926[#123926]
* Formatting in the left axis is not respected when I have two separate axis in *TSVB* {kibana-pull}123903[#123903]
* Fixes series containing colon in *TSVB* {kibana-pull}123897[#123897]
* Fixes records field name and migrate in *Lens* {kibana-pull}123894[#123894]
* Hides ticks on the y axis for layers with the same format and different template in *TSVB* {kibana-pull}123598[#123598]
* Various fixes for Lens embeddables in *Lens* {kibana-pull}123587[#123587]
* Make sure session is updated and passed to the embeddable in *Visualize* {kibana-pull}123538[#123538]
* Fixes time range issue on save in *Lens* {kibana-pull}123536[#123536]
* Report override data views to the dashboard in *TSVB* {kibana-pull}123530[#123530]
* Handle ignore daylight time correctly and fix shift problem in *TSVB* {kibana-pull}123398[#123398]
* AggConfigs: Make base id check more stable {kibana-pull}123367[#123367]
* TSVB fix flickering {kibana-pull}122921[#122921]
* Hide tooltips while dragging dimensions in *Lens* {kibana-pull}122198[#122198]
* Make sure saved search id is carried over to saved object {kibana-pull}121082[#121082]
* Paginate through index patterns {kibana-pull}120972[#120972]
* Show generic error for invalid time shift string in *Lens* {kibana-pull}120077[#120077]
* Improves column type detection in table for alignment in *Lens* {kibana-pull}120007[#120007]
* Fixes the broken "aggregate function" in *TSVB* table {kibana-pull}119967[#119967]
* Hide fit from suggestions in *Timelion* {kibana-pull}119568[#119568]
* Match visualization type to first series type when available {kibana-pull}119377[#119377]
* Timelion & vega apply dataview from first filter in *Vega* {kibana-pull}119209[#119209]
* Reset filter state whenever group-by changed in *TSVB* {kibana-pull}118953[#118953]
* Prevent KQL Popovers From Stacking in *Lens* {kibana-pull}118258[#118258]
* Improves outside label placement for pie/donut charts in *Lens* {kibana-pull}115966[#115966]

Machine Learning::
* Fixes permission check for 'View examples' link from Anomaly detection explorer page {kibana-pull}125090[#125090]
* Fixes auto-refresh interval {kibana-pull}124851[#124851]
* Fixes permission check for Discover/data view redirect from Anomaly detection explorer page {kibana-pull}124408[#124408]
* Fixes breadcrumbs inconsistencies and titles capitalisation {kibana-pull}123019[#123019]

Management::
* Update painless antlr grammar for fields API $-syntax {kibana-pull}125818[#125818]
* Adds permission check for 'Set as default data view' button on data view detail page {kibana-pull}124897[#124897]
* In *Index Management*, index details now display previously missing values for the number of deleted documents and the primary storage size {kibana-pull}124731[#124731]
* Transforms: Fix retention policy reset {kibana-pull}124698[#124698]
* Transforms: Fix sort on field names containing dots not applied in wizard preview grid {kibana-pull}124587[#124587]
* Transforms: Fix refresh when transform list is filtered {kibana-pull}124267[#124267]
* Fixes autocomplete inserting comma in triple quotes {kibana-pull}123572[#123572]
* Encode pathname {kibana-pull}122080[#122080]
* Autocomplete missing comma on correct location {kibana-pull}121611[#121611]
* Fixes wrong values in field format editor; fix wrong value formatting in field preview {kibana-pull}121300[#121300]
* Fixes autocomplete suggestions for lowercase methods and other related bug {kibana-pull}121033[#121033]
* Fixes autocomplete suggestions for repository of type `fs` (typo) {kibana-pull}120775[#120775]
* Fixes editor error while adding second request {kibana-pull}120593[#120593]
* Dev Tools Console: Expose the error_trace parameter for completion {kibana-pull}120290[#120290]
* Auto complete for script suggests deprecated query type {kibana-pull}120283[#120283]
* Fixes "Expected one of GET/POST/PUT/DELETE/HEAD" for lowercase methods {kibana-pull}120209[#120209]
* Make the Define script label non clickable {kibana-pull}119947[#119947]
* Fixes error markers in editor output {kibana-pull}119831[#119831]
* Change suggestions for Sampler and Diversified sampler aggregations {kibana-pull}119355[#119355]
* Adds Autocompletion for boxplot aggregation in Kibana Dev tools {kibana-pull}117024[#117024]
* Adds overrides for request parameters for Logstash PUT Pipeline API {kibana-pull}116450[#116450]
* @timestamp as default for timestamp field name in index pattern {kibana-pull}116126[#116126]

Maps::
* Fixes vector tile URL not properly encoded {kibana-pull}126208[#126208]
* Allows feature editing with vector tile scaling {kibana-pull}123409[#123409]
* Fixes Error rendering cluster layer of geoshape documents styled by category {kibana-pull}123308[#123308]
* Fetch geometry from fields API {kibana-pull}122431[#122431]
* Fixes vector tile double counting geo_shapes that cross tile boundaries {kibana-pull}121703[#121703]
* Refactor map telemetry to incrementally calculate usage stats {kibana-pull}121467[#121467]
* Fixes creating filter from array fields {kibana-pull}119548[#119548]

Monitoring::
* Stronger typing for monitoring configs {kibana-pull}125467[#125467]
* Fixes Alerts and Rules menu persisting to other apps {kibana-pull}124291[#124291]
* Fixes Logstash Pipeline hover timestamp isn't visible {kibana-pull}123091[#123091]
* Fixes date picker range options {kibana-pull}121295[#121295]

Observability::
* Set display names for columns and fix reason message {kibana-pull}124570[#124570]
* Rename Backend to Dependency {kibana-pull}124067[#124067]
* Enable parseTechnicalFields to accept partial alert documents {kibana-pull}123983[#123983]
* Include error documents in fallback query for services {kibana-pull}123554[#123554]
* Rewrite the data fetching for Inventory Threshold rule {kibana-pull}123095[#123095]
* Optimizations for Inventory Threshold Alerts {kibana-pull}122460[#122460]
* Increase composite size to 10K for Metric Threshold Rule and optimize processing {kibana-pull}121904[#121904]
* Fixes missing EUI theme in context {kibana-pull}121796[#121796]
* Rename alerting types in triggers_actions_ui {kibana-pull}121107[#121107]
* Fixes loading message for correlations table {kibana-pull}120921[#120921]
* Prefer host.name over host.hostname {kibana-pull}119952[#119952]

Platform::
* Improve `bfetch` error handling {kibana-pull}123455[#123455]
* Fixes a CSV export Reporting issue where expensive queries were used to collect the data when they were not needed {kibana-pull}123412[#123412]
* Fixes URL drilldown placeholder text and add placeholder capability to Monaco {kibana-pull}121420[#121420]
* Consider expired tasks invalid {kibana-pull}119664[#119664]
* `columns`. Fixes Bugs caused by using name instead of ID {kibana-pull}118470[#118470]

Security::
User login audit events now include the session ID for better correlation, and single sign-on flows no longer result in an extra `user_logout` event {kibana-pull}124299[#124299]

[[release-notes-8.0.0]]
== {kib} 8.0.0

Review the {kib} 8.0.0 changes, then use the {kibana-ref-all}/7.17/upgrade-assistant.html[Upgrade Assistant] to complete the upgrade.

[float]
[[breaking-changes-8.0.0]]
=== Breaking change

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade to 8.0.0, review the breaking change, then mitigate the impact to your application.

[discrete]
[[breaking-123754]]
.Removes the `console.ssl` setting
[%collapsible]
====
*Details* +
The `console.ssl` setting has been removed. For more information, refer to {kibana-pull}123754[#123754].

*Impact* +
Before you upgrade to 8.0.0, remove `console.ssl` from kibana.yml.
====

To review the breaking changes in previous versions, refer to the following:

<<breaking-changes-8.0.0-rc2,8.0.0-rc2>> | <<breaking-changes-8.0.0-rc1,8.0.0-rc1>> | <<breaking-changes-8.0.0-beta1,8.0.0-beta1>> | <<breaking-changes-8.0.0-alpha2,8.0.0-alpha2>> |
<<breaking-changes-8.0.0-alpha1,8.0.0-alpha1>>

[float]
[[deprecations-8.0.0]]
=== Deprecation

The following functionality is deprecated in 8.0.0, and will be removed in 9.0.0.
Deprecated functionality does not have an immediate impact on your application, but we strongly recommend
you make the necessary updates after you upgrade to 8.0.0.

[discrete]
[[deprecation-123229]]
.Removes support for `monitoring.cluster_alerts.allowedSpaces`
[%collapsible]
====
*Details* +
The `monitoring.cluster_alerts.allowedSpaces` setting, which {kib} uses to create Stack Monitoring alerts, has been removed. For more information, refer to {kibana-pull}123229[#123229].

*Impact* +
Before you upgrade to 8.0.0, remove `monitoring.cluster_alerts.allowedSpaces` from kibana.yml.
====

To review the deprecations in previous versions, refer to the following:

<<deprecations-8.0.0-rc1,8.0.0-rc1>> | <<deprecations-8.0.0-alpha1,8.0.0-alpha1>>

[float]
[[known-issue-8.0.0]]
=== Known issue

[discrete]
[[known-issue-123550]]
.Importing and copying saved objects causes weak links to break
[%collapsible]
====
*Details* +
{kib} supports weak links in some saved objects. For example, a dashboard may include a Markdown panel that contains a relative URL to
another dashboard. Weak links are defined by free text, _not_ the saved object's relationships, and can break if **both** of the following
conditions are true:

* You are importing saved objects into multiple spaces, _OR_ you are copying saved objects into another space
* Before you upgraded to 8.0.0, the saved objects did not already exist in the destinations

In 8.0.0 and later, weak links break because <<saved-object-ids-impact-when-using-import-and-copy,saved object IDs can change during import or copy>>.
This applies to both the UI and the API.
This issue will be fixed 8.0.1 and 8.1.0. For more information, refer to {kibana-issue}123550[#123550].

*Impact* +
Saved objects in 7.x that are migrated during upgrade are **not** impacted.
Only _new_ saved objects that are imported or copied _multiple times_ (causing object IDs to change) are impacted.
If you are impacted, you can re-import or re-copy your saved objects after the fix is
implemented to preserve the weak links.
====

[float]
[[features-8.0.0]]
=== Features
For information about the features introduced in 8.0.0, refer to <<whats-new,What's new in 8.0>>.

Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

To review the features in previous versions, refer to the following:

<<features-8.0.0-rc2,8.0.0-rc2>> | <<features-8.0.0-rc1,8.0.0-rc1>> | <<features-8.0.0-beta1,8.0.0-beta1>> | <<features-8.0.0-alpha2,8.0.0-alpha2>>

[[enhancements-and-bug-fixes-v8.0.0]]
=== Enhancements and bug fixes

For detailed information about the 8.0.0 release, review the enhancements and bug fixes.

[float]
[[enhancement-v8.0.0]]
==== Enhancements
Dashboard::
Clone ReferenceOrValueEmbeddables by value {kibana-pull}122199[#122199]

Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

[float]
[[fixes-v8.0.0]]
==== Bug Fixes
APM::
Restrict aggregated transaction metrics search to date range {kibana-pull}123445[#123445]

Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].

Fleet::
Allow empty strings for required text fields in package policies {kibana-pull}123610[#123610]

Maps::
Fixes Label border color is not removed from legend when disabled {kibana-pull}122705[#122705]

Monitoring::
Ensure logstash getNodes always contains a uuid {kibana-pull}124201[#124201]

Security::
Long-running requests no longer cause sporadic logouts in certain cases, even when user sessions are active {kibana-pull}122155[#122155]

[[release-notes-8.0.0-rc2]]
== {kib} 8.0.0-rc2

For information about the {kib} 8.0.0-rc2 release, review the following information.

[float]
[[breaking-changes-8.0.0-rc2]]
=== Breaking change

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking change, then mitigate the impact to your application.

[discrete]
[[breaking-122722]]
.Removes the ability to use `elasticsearch.username: elastic` in production
[%collapsible]
====
*Details* +
In production, you are no longer able to use the `elastic` superuser to authenticate to {es}. For more information, refer to {kibana-pull}122722[#122722].

*Impact* +
When you configure `elasticsearch.username: elastic`, {kib} fails.
====

To review the breaking changes in previous versions, refer to the following:

<<breaking-changes-8.0.0-rc1,8.0.0-rc1>> | <<breaking-changes-8.0.0-beta1,8.0.0-beta1>> | <<breaking-changes-8.0.0-alpha2,8.0.0-alpha2>> |
<<breaking-changes-8.0.0-alpha1,8.0.0-alpha1>>

[float]
[[features-8.0.0-rc2]]
=== Features
{kib} 8.0.0-rc2 adds the following new and notable features.

Dashboard::
Dashboard Integration {kibana-pull}115991[#115991]
Elastic Security::
For the Elastic Security 8.0.0-rc2 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Monitoring::
Enterprise Search Stack Monitoring {kibana-pull}114303[#114303]
Observability::
* Adds Agent Keys in APM settings - Create agent keys {kibana-pull}120373[#120373]
* Adds Agent Keys in APM settings - Agent key table {kibana-pull}119543[#119543]
* Allows users to set Download Speed, Upload Speed, and Latency for their synthetic monitors in Uptime {kibana-pull}118594[#118594]
Platform::
Changes saved objects management inspect view to a read-only JSON view of the whole saved object {kibana-pull}112034[#112034]

[[enhancements-and-bug-fixes-v8.0.0-rc2]]
=== Enhancements and bug fixes

For detailed information about the 8.0.0-rc2 release, review the enhancements and bug fixes.

[float]
[[enhancement-v8.0.0-rc2]]
==== Enhancements
Elastic Security::
For the Elastic Security 8.0.0-rc2 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Security::
Adds session cleanup audit logging {kibana-pull}122419[#122419]
Observability::
Make a monitor's steps details page work on mobile resolutions in Uptime {kibana-pull}122171[#122171]

[float]
[[fixes-v8.0.0-rc2]]
==== Bug Fixes
Alerting::
Fixes PagerDuty timestamp validation {kibana-pull}122321[#122321]
Dashboard::
* Creates Explicit Diffing System {kibana-pull}121241[#121241]
* Fixes blank panel save and display issue {kibana-pull}120815[#120815]
* Fixes full screen error when pressing back arrow on browser {kibana-pull}118113[#118113]
Elastic Security::
For the Elastic Security 8.0.0-rc2 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Maps::
* Fixes Point to point and Tracks layers label properties not showing in the legend {kibana-pull}122993[#122993]
* Fixes Color ramp UI for percent of a top term in join layer is broken {kibana-pull}122718[#122718]
Observability::
* Updates index pattern permission error in APM {kibana-pull}122680[#122680]
* Honor time unit for Inventory Threshold in Metrics {kibana-pull}122294[#122294]
* Adds locator to aid other plugins in linking properly to Uptime {kibana-pull}123004[#123004]
* Fixes a bug in which headers would be incorrectly centered on desktop in Uptime {kibana-pull}122643[#122643]

[[release-notes-8.0.0-rc1]]
== {kib} 8.0.0-rc1

Review the {kib} 8.0.0-rc1 changes, then use the <<upgrade-assistant,Upgrade Assistant>> to complete the upgrade.

[float]
[[breaking-changes-8.0.0-rc1]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance.
Before you upgrade, review the breaking changes, then mitigate the impact to your application.

[discrete]
[[breaking-118854]]
.Splits package policy `upgrade` endpoint for Fleet
[%collapsible]
====
*Details* +
For package policy upgrades, the packagePolicy `upgrade` endpoint format supports a mutative upgrade operation (when `dryRun: false`) and a read-only dry run operation (when `dryRun: true`):

[source,text]
--
 POST /package_policies/upgrade
 {
   packagePolicyIds: [...],
   dryRun: false
 }
--

For more information, refer to {kibana-pull}118854[#118854].

*Impact* +
The endpoint is now split into two separate endpoints:

[source,text]
--
 POST /package_policies/upgrade
 {
   packagePolicyIds: [...]
 }

 POST /package_policies/upgrade/dry_run
 {
   packagePolicyIds: [...]
 }
--
====

[discrete]
[[breaking-119945]]
.Removes APM jobs from Machine Learning
[%collapsible]
====
*Details* +
APM Node.js and RUM JavaScript anomaly detection job modules have been removed. For more information, refer to {kibana-pull}119945[#119945].

*Impact* +
When you upgrade to 8.0.0, you are unable to create and view the APM Node.js and RUM JavaScript jobs in Machine Learning.
====

[discrete]
[[breaking-118300]]
.Fails migrations for unknown types
[%collapsible]
====
*Details* +
Unknown saved object types now cause {kib} migrations to fail. For more information, refer to {kibana-issue}107678[#107678].

*Impact* +
To complete the migration, re enable plugins or delete documents from the index in the previous version.
====

[discrete]
[[breaking-116821]]
.Removes deprecated config fields from Logs and Metrics APIs and saved objects
[%collapsible]
====
*Details* +
On the Logs and Metrics UIs, references to the following API and saved object deprecated fields have been removed:

* `timestamp`
* `tiebreaker`
* `container`
* `pod`
* `host`

For more information, refer to {kibana-pull}116821[#116821] and {kibana-pull}115874[#115874].

*Impact* +
When you upgrade to 8.0.0, you are unable to use references to the deprecated fields.
====

To review the breaking changes in previous versions, refer to the following:

<<breaking-changes-8.0.0-beta1,8.0.0-beta1>> | <<breaking-changes-8.0.0-alpha2,8.0.0-alpha2>> |
<<breaking-changes-8.0.0-alpha1,8.0.0-alpha1>>

[float]
[[deprecations-8.0.0-rc1]]
=== Deprecations

Deprecated functionality does not have an immediate impact on your application, but we strongly recommend you make the necessary updates after you complete the upgrade.

[discrete]
[[deprecation-120689]]
.Renames the `autocreate` data view APM setting
[%collapsible]
====
*Details* +
The `xpack.apm.autocreateApmIndexPattern` APM setting has been removed. For more information, refer to {kibana-pull}120689[#120689].

*Impact* +
To automatically create data views in APM, use `xpack.apm.autoCreateApmDataView`.
====

[discrete]
[[deprecation-119494]]
.Updates Fleet API to improve consistency
[%collapsible]
====
*Details* +
The Fleet API has been updated to improve consistency:

* Hyphens are changed to underscores in some names.
* The `pkgkey` path parameter in the packages endpoint is split.
* The `response` and `list` properties are renamed to `items` or `item` in some
responses.

For more information, refer to {kibana-pull}119494[#119494].

*Impact* +
When you upgrade to 8.0.0, use the following API changes:

* Use `enrollment_api_keys` instead of `enrollment-api-keys`.

* Use `agent_status` instead of `agent-status`.

* Use `service_tokens` instead of `service-tokens`.

* Use `/epm/packages/{packageName}/{version}` instead of `/epm/packages/{pkgkey}`.

* Use `items[]` instead of `response[]` in:
+
[source,text]
--
/api/fleet/enrollment_api_keys
/api/fleet/agents
/epm/packages/
/epm/categories
/epm/packages/_bulk
/epm/packages/limited
/epm/packages/{packageName}/{version} <1>
--
<1> Use `items[]` when the verb is `POST` or `DELETE`. Use `item` when the verb
is `GET` or `PUT`.

For more information, refer to {fleet-guide}/fleet-api-docs.html[Fleet APIs].

====

To review the deprecations in previous versions, refer to the <<deprecations-8.0.0-alpha1,8.0.0-alpha1 release notes>>.


[float]
[[features-8.0.0-rc1]]
=== Features
{kib} 8.0.0-rc1 adds the following new and notable features.

Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Management::
Display managed badge for transforms {kibana-pull}117679[#117679]
Monitoring::
Enterprise Search Stack Monitoring {kibana-pull}114303[#114303]
Observability::
* Adds ability to create agent keys in APM settings {kibana-pull}120373[#120373]
* Adds Agent key table in APM settings {kibana-pull}119543[#119543]
* Allows users to set Download Speed, Upload Speed, and Latency for their synthetic monitors {kibana-pull}118594[#118594]

[[enhancements-and-bug-fixes-v8.0.0-rc1]]
=== Enhancements and bug fixes

For detailed information about the 8.0.0-rc1 release, review the enhancements and bug fixes.

[float]
[[enhancement-v8.0.0-rc1]]
=== Enhancements
Canvas::
Reverts By-Value Embeddables {kibana-pull}117613[#117613]
Discover::
Adds multi-layer time axis for opt-out only {kibana-pull}115853[#115853]
Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Fleet::
Adds consistent `_meta` property to all Fleet ES assets {kibana-pull}119380[#119380]
Kibana Home & Add Data::
Moves overview page and link to the accordion solution title {kibana-pull}114018[#114018]
Lens & Visualizations::
* Handle removal of deprecated date histogram interval in *Vega* {kibana-pull}109090[#109090]
* Adds value labels to Heatmap in *Lens* {kibana-pull}106406[#106406]
Machine Learning::
* Adds support for `force` stop deployment {kibana-pull}118563[#118563]
* Refactors data view loading to remove unnecessary searches {kibana-pull}116455[#116455]
Observability::
* Service maps: Adds sparklines to the detail popover {kibana-pull}120021[#120021]
* Offer users upgrade to multi-metric job {kibana-pull}119980[#119980]
* Display relevant anomalies from multi-metric job {kibana-pull}119709[#119709]
* Adds service icon for the originating service in traces table {kibana-pull}119421[#119421]
* Auto attachment for java agent beta in APM integration settings {kibana-pull}119131[#119131]
* Errors: Enhancements to the Errors list page (part II) {kibana-pull}118878[#118878]
* Store Alerts View table state in localStorage {kibana-pull}118207[#118207]
* Handle other values popup when correlated value is not in top 10 {kibana-pull}118069[#118069]
* Adds links to navigate from alerts table to rule {kibana-pull}118035[#118035]
* Reinstates ML multi-metric job {kibana-pull}117836[#117836]
* Re-enables metric-based UI {kibana-pull}117021[#117021]
* Make Alerts page use shared {kib} time range {kibana-pull}115192[#115192]
* Adds enabled toggle {kibana-pull}119994[#119994]
* Adds missing tooltip to the report metric badge in *Exploratory View* {kibana-pull}119940[#119940]
* Adds step duration in step list {kibana-pull}116266[#116266]
Platform::
Moves developer architecture docs to user docs {kibana-pull}119125[#119125]
Reporting::
* Decouples screenshotting plugin from the reporting {kibana-pull}120110[#120110]
* Updates the design of the *Reports* management UI, including the addition of a link to {kib} app where the report was generated {kibana-pull}111412[#111412]
Security::
Adds ability to clone role mappings {kibana-pull}118434[#118434]
Adds user logout audit events {kibana-pull}121455[#121455]

[float]
[[fixes-v8.0.0-rc1]]
=== Bug Fixes
Canvas::
* Fixes Error overflow {kibana-pull}122158[#122158]
* Fixes expression input {kibana-pull}121490[#121490]
* Hides edit menu when in view-only mode {kibana-pull}118779[#118779]
Dashboard::
* Allow text wrapping for panel titles and dashboard descriptions for PDF generation {kibana-pull}121360[#121360]
* Page now resets to zero when rows per page is changed on *Add from Library* window {kibana-pull}118627[#118627]
* Fixes full screen error when pressing back arrow in browser {kibana-pull}118113[#118113]
Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Fleet::
* Adds `installed_kibana_space_id` to `epm-packages` saved objects {kibana-pull}120517[#120517]
* Handle Saved Object ID changes {kibana-pull}119527[#119527]
* Fixes upgradeable agents filter {kibana-pull}119338[#119338]
Lens & Visualizations::
* Enables normal mode for percentage charts in *Lens* {kibana-pull}120197[#120197]
* Fixes existing fields query for epoch_millis dates in *Lens* {kibana-pull}119508[#119508]
* Include frozen indices in *Lens* {kibana-pull}118555[#118555]
* Fixes focus on legend action popovers in *Lens* {kibana-pull}115066[#115066]
Machine Learning::
* Fixes data view search based on title {kibana-pull}120737[#120737]
* Data frame analytics wizard: Only allow data view creation if job will be started immediately {kibana-pull}120042[#120042]
* Fixes anomaly detection module manifest queries to ignore frozen and cold data tiers {kibana-pull}119635[#119635]
* Catches syntax error in job wizard editor {kibana-pull}119457[#119457]
* Fixes error handling for missing data view in data frame analytics wizard {kibana-pull}119455[#119455]
* Ensures auto refresh interval is used in Data Frame Analytics list {kibana-pull}117959[#117959]
* Ignores frozen indices in data recognizer {kibana-pull}117208[#117208]
Management::
* Fixes data grid column actions button when histogram charts are visible {kibana-pull}120202[#120202]
* Disables delete data view for data frame analytics and transforms wizards {kibana-pull}119732[#119732]
* Check {kib} capabilities for all saving, editing, and deleting {kibana-pull}118480[#118480]
* Adds autocomplete for search_after and pit in search query {kibana-pull}117864[#117864]
* Autocomplete for t_test aggregation {kibana-pull}117782[#117782]
* Disables create data view for data frame analytics and transforms wizards {kibana-pull}117690[#117690]
Maps::
* Fixes an issue where drawings do not show when there is a global filter {kibana-pull}121239[#121239]
* Use minimum symbol size if meta is not loaded {kibana-pull}119119[#119119]
* Do not fail migration when JSON.parse fails {kibana-pull}117342[#117342]
* Do not allow label overlap {kibana-pull}116190[#116190]
Monitoring::
Correct linear regression formula {kibana-pull}120222[#120222]
Observability::
* Renames alerting types in Infra {kibana-pull}121061[#121061]
* Renames occurrences of `alert_type` to `rule_type` in Infra {kibana-pull}120455[#120455]
* Fixes failing alerts table pagination functional tests {kibana-pull}119985[#119985]
* Switch to _source for updating documents instead of fields API {kibana-pull}118245[#118245]
* Fixes an issue where search terms with certain characters caused the APM UI to crash {kibana-pull}118063[#118063]
* Ignore unavailable indices for ML jobs {kibana-pull}117632[#117632]
* Disables the actions button when users have inadequate privileges {kibana-pull}117488[#117488]
* Replaces manual rate calculation with `rate` agg {kibana-pull}115651[#115651]
* Adds migration to fix incorrect action group spelling {kibana-pull}119626[#119626]
* Fixes bug with manage views button {kibana-pull}118547[#118547]
* Disables No Data checkboxes for doc count alerts {kibana-pull}117194[#117194]
* Prevent event propagation on step_duration {kibana-pull}122039[#122039]
* Disables the button to create alerts in Uptime when users do not have permissions to do so {kibana-pull}120379[#120379]
* Fixes a bug that prevented users from saving Uptime configurations when the `inspect` option was turned on {kibana-pull}119142[#119142]
* Adds a callout to informs users that they do not have permissions to create ML jobs for Uptime monitors {kibana-pull}117684[#117684]
Platform::
Fixes font glitches in code editor {kibana-pull}121392[#121392]
Reporting::
Fixes an issue where PDF and PNG reports break on Windows operating systems when the {kib} server hostname is `0.0.0.0` {kibana-pull}117022[#117022]

[[release-notes-8.0.0-beta1]]
== {kib} 8.0.0-beta1

Review the {kib} 8.0.0-beta1 changes, then use the <<upgrade-assistant,Upgrade Assistant>> to complete the upgrade.

[float]
[[breaking-changes-8.0.0-beta1]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance. Review the following breaking changes, then mitigate the impact to your application.

To review the breaking changes in previous versions, refer to the following:

<<breaking-changes-8.0.0-alpha2,8.0.0-alpha2>> | <<breaking-changes-8.0.0-alpha1,8.0.0-alpha1>>

[float]
[[alerting-breaking-changes-8.0.0-beta1]]
==== Alerting

[discrete]
[[breaking-114558]]
.Removes `xpack.task_manager.index`
[%collapsible]
====
*Details* +
The `xpack.task_manager.index` setting has been removed. For more information, refer to {kibana-pull}114558[#114558].

*Impact* +
Before you upgrade to 8.0.0, remove `xpack.task_manager.index` from kibana.yml.
====

[discrete]
[[breaking-113461]]
.Removes ability to remove plugins
[%collapsible]
====
*Details* +
The `xpack.actions.enabled` setting has been removed. For more information, refer to {kibana-pull}113461[#113461].

*Impact* +
Before you upgrade to 8.0.0, remove `xpack.actions.enabled` from kibana.yml.
====

[float]
[[lens-visualizations-breaking-changes-8.0.0-beta1]]
==== Lens & visualizations

[discrete]
[[breaking-113516]]
.Removes display options from legacy gauge
[%collapsible]
====
*Details* +
The *Display warnings* option has been removed from the aggregation-based gauge visualization. For more information, refer to {kibana-pull}113516[#113516].

*Impact* +
When you create aggregation-based gauge visualizations, the *Display warnings* option is no longer available in *Options > Labels*.
====

[discrete]
[[breaking-112643]]
.Removes settings from visEditors plugins
[%collapsible]
====
*Details* +
The following deprecated visEditors plugin settings have been removed:

* `metric_vis.enabled`
* `table_vis.enabled`
* `tagcloud.enabled`
* `metrics.enabled`
* `metrics.chartResolution`
* `chartResolution`
* `metrics.minimumBucketSize`
* `minimumBucketSize`
* `vega.enabled`
* `vega.enableExternalUrls`
* `vis_type_table.legacyVisEnabled`
* `timelion_vis.enabled`
* `timelion.enabled`
* `timelion.graphiteUrls`
* `timelion.ui.enabled`

For more information, refer to {kibana-pull}112643[#112643].

*Impact* +
Before you upgrade, make the following changes in kibana.yml:

* Replace `metric_vis.enabled` with `vis_type_metric.enabled`
* Replace `table_vis.enabled` with `vis_type_table.enabled`
* Replace `tagcloud.enabled` with `vis_type_tagcloud.enabled`
* Replace `metrics.enabled` with `vis_type_timeseries.enabled`
* Replace `metrics.chartResolution` and `chartResolution` with `vis_type_timeseries.chartResolution`
* Replace `metrics.minimumBucketSize` and `minimumBucketSize` with `vis_type_timeseries.minimumBucketSize`
* Replace `vega.enabled` with `vis_type_vega.enabled`
* Replace `vega.enableExternalUrls` with `vis_type_vega.enableExternalUrls`
* Remove `vis_type_table.legacyVisEnabled`
* Replace `timelion_vis.enabled` with `vis_type_timelion.enabled`
* Replace `timelion.enabled` with `vis_type_timelion.enabled`
* Replace `timelion.graphiteUrls` with `vis_type_timelion.graphiteUrls`
* Remove `timelion.ui.enabled`

====

[discrete]
[[breaking-111704]]
.Removes dimming opacity setting
[%collapsible]
====
*Details* +
The *Dimming opacity* setting in *Advanced Settings* has been removed. For more information, refer to {kibana-pull}111704[#111704].

*Impact* +
When you upgrade to 8.0.0, you are no longer able to configure the dimming opactiy for visualizations.
====

[discrete]
[[breaking-110985]]
.Removes Less stylesheet support
[%collapsible]
====
*Details* +
In *TSVB*, custom Less stylesheets have been removed. For more information, refer to {kibana-pull}110985[#110985].

*Impact* +
Existing less stylesheets are automatically converted to CSS stylesheets.
====

[discrete]
[[breaking-110571]]
.Disables the input string mode
[%collapsible]
====
*Details* +
In *TSVB*, the *Index pattern selection mode* option has been removed. For more information, refer to {kibana-pull}110571[#110571].

*Impact* +
To use index patterns and {es} indices in *TSVB* visualizations:

. Open the main menu, then click *Stack Management > Advanced Settings*.

. Select *Allow string indices in TSVB*.

. Click *Save changes*.
====

[float]
[[logs-breaking-changes-8.0.0-beta1]]
==== Logs

[discrete]
[[breaking-115974]]
.Removes deprecated alias config entries
[%collapsible]
====
*Details* +
The deprecated `xpack.infra.sources.default.logAlias` and `xpack.infra.sources.default.logAlias` settings have been removed. For more information, refer to {kibana-pull}115974[#115974].

*Impact* +
Before you upgrade, remove the settings from kibana.yml, then configure the settings in <<logs-app,Logs>>.
====

[discrete]
[[breaking-61302]]
.Removes configurable fields in settings
[%collapsible]
====
*Details* +
The *Logs* and *Metrics* configurable fields settings have been removed. For more information, refer to {kibana-pull}61302[#61302].

*Impact* +
Configure the settings in https://www.elastic.co/guide/en/ecs/current/ecs-reference.html[ECS].
====

[float]
[[machine-learning-breaking-changes-8.0.0-beta1]]
==== Machine learning

[discrete]
[[breaking-115444]]
.Grants access to machine learning features when base privileges are used
[%collapsible]
====
*Details* +
Machine learning features are included as base privileges. For more information, refer to {kibana-pull}115444[#115444].

*Impact* +
If you do not want to grant users privileges to machine learning features, update <<xpack-security,*Users* and *Roles*>>.
====

[float]
[[maps-breaking-changes-8.0.0-beta1]]
==== Maps

[discrete]
[[breaking-116184]]
.Removes proxyElasticMapsServiceInMaps
[%collapsible]
====
*Details* +
The `map.proxyElasticMapsServiceInMaps` setting has been removed. For more information, refer to {kibana-pull}116184[#116184].

*Impact* +
Install the on-prem version of the <<maps-connect-to-ems,Elastic Maps Service>>, which is a Docker service that resides in the Elastic Docker registry, in an accessible location on your internal network. When you complete the installation, update kibana.yml to point to the service.
====

[float]
[[operations-breaking-changes-8.0.0-beta1]]
==== Operations

[discrete]
[[breaking-111535]]
.Removes environment variables
[%collapsible]
====
*Details* +
The `CONFIG_PATH` and `DATA_PATH` environment variables have been removed. For more information, refer to {kibana-pull}111535[#111535].

*Impact* +
Replace the `CONFIG_PATH` environment variable with `KBN_PATH_CONF`, and replace `DATA_PATH` with the `path.data` setting.
====

[float]
[[platform-breaking-changes-8.0.0-beta1]]
==== Platform

[discrete]
[[breaking-114379]]
.Removes supports for csp.rules configuration
[%collapsible]
====
*Details* +
Support for the `csp.rules` configuration property has been removed. For more information, refer to {kibana-pull}114379[#114379].

*Impact* +
Configuring the default `csp.script_src`, `csp.workers_src`, and `csp.style_src` values is not required.
====

[discrete]
[[breaking-113653]]
.Changes and removes deprecated core settings and deprecated settings from core plugins
[%collapsible]
====
*Details* +
The deprecation notice for `server.cors` has changed from `level:critical` to `level:warning`.

The following settings have changed:

* The `xpack.banners.placement` value has been renamed
* The `newsfeed.defaultLanguage` newsfeed item retrieval method and default language has changed

Support for the following configuration settings has been removed:

* `newsfeed.defaultLanguage`
* `cpu.cgroup.path.override`
* `cpuacct.cgroup.path.override`
* `server.xsrf.whitelist`
* `xpack.xpack_main.xpack_api_polling_frequency_millis`
* `KIBANA_PATH_CONF`

For more information, refer to {kibana-pull}113653[#113653].

*Impact* +
* The `header` value provided to the `xpack.banners.placement` configuration has been renamed to 'top'
* The `newsfeed.defaultLanguage` newsfeed items are retrieved based on the browser locale and default to English
* Replace `cpu.cgroup.path.override` with `ops.cGroupOverrides.cpuPath`
* Replace `cpuacct.cgroup.path.override` with `ops.cGroupOverrides.cpuAcctPath`
* Replace `server.xsrf.whitelist` with `server.xsrf.allowlist`
* Replace `xpack.xpack_main.xpack_api_polling_frequency_millis` with `xpack.licensing.api_polling_frequency`
* Replace `KIBANA_PATH_CONF` path to the {kib} configuration file using the `KBN_PATH_CONF` environment variable
====

[discrete]
[[breaking-113495]]
.Removes `enabled` settings from plugins
[%collapsible]
====
*Details* +
Using `{plugin_name}.enabled` to disable plugins has been removed. Some plugins, such as `telemetry`, `newsfeed`, `reporting`, and the various `vis_type` plugins will continue to support this setting. All other {kib} plugins will not support this setting. Any new plugin will support this setting only when specified in the `configSchema`. For more information, refer to {kibana-pull}113495[#113495].

The `xpack.security.enabled` setting has been removed. For more information, refer to {kibana-pull}111681[#111681].

*Impact* +
Before you upgrade to 8.0.0:

* Remove `{plugin_name}.enabled` from kibana.yml. If you use the setting to control user access to {kib} applications, use <<tutorial-secure-access-to-kibana,*Features* controls>> instead.
* Replace `xpack.security.enabled` with {ref}/security-settings.html#general-security-settings[`xpack.security.enabled`] in elasticsearch.yml.
====

[discrete]
[[breaking-113367]]
.Removes `--plugin-dir` cli option
[%collapsible]
====
*Details* +
The `plugins.scanDirs` setting and `--plugin-dir` cli option have been removed. For more information, refer to {kibana-pull}113367[#113367].

*Impact* +
Before you upgrade to 8.0.0, remove `plugins.scanDirs` from kibana.yml.
====

[discrete]
[[breaking-113296]]
.Removes support for `optimize.*` settings
[%collapsible]
====
*Details* +
The legacy `optimize.*` settings have been removed. If your configuration uses the following legacy `optimize.*` settings, {kib} fails to start:

* `optimize.lazy`
* `optimize.lazyPort`
* `optimize.lazyHost`
* `optimize.lazyPrebuild`
* `optimize.lazyProxyTimeout`
* `optimize.enabled`
* `optimize.bundleFilter`
* `optimize.bundleDir`
* `optimize.viewCaching`
* `optimize.watch`
* `optimize.watchPort`
* `optimize.watchHost`
* `optimize.watchPrebuild`
* `optimize.watchProxyTimeout`
* `optimize.useBundleCache`
* `optimize.sourceMaps`
* `optimize.workers`
* `optimize.profile`
* `optimize.validateSyntaxOfNodeModules`

For more information, refer to {kibana-pull}113296[#113296].

*Impact* +
To run the `@kbn/optimizer` separately in development, pass `--no-optimizer` to `yarn start`. For more details, refer to {kibana-pull}73154[#73154].
====

[discrete]
[[breaking-113173]]
.Removes `so/server/es` settings
[%collapsible]
====
*Details* +
Some of the `so/server/es` settings have been removed. If your configuration uses the following settings, {kib} fails to start:

* `savedObjects.indexCheckTimeout`
* `server.xsrf.token`
* `elasticsearch.preserveHost`
* `elasticsearch.startupTimeout`

For more information, refer to {kibana-pull}113173[#113173].

*Impact* +
Before you upgrade to 8.0.0., remove these settings from kibana.yml.
====

[discrete]
[[breaking-113068]]
.Adds requirement for inline scripting
[%collapsible]
====
*Details* +
To start {kib}, you must enable inline scripting in {es}. For more information, refer to {kibana-pull}113068[#113068].

*Impact* +
Enable link:https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting-security.html[inline scripting].
====

[discrete]
[[breaking-112773]]
.Removes `kibana.index` settings
[%collapsible]
====
*Details* +
The `kibana.index`, `xpack.reporting.index`, and `xpack.task_manager.index` settings have been removed. For more information, refer to {kibana-pull}112773[#112773].

*Impact* +
Use spaces, cross-cluster replication, or cross-cluster search. To migrate to <<xpack-spaces,spaces>>, export your <<managing-saved-objects, saved objects>> from a tenant into the default space. For more details, refer to link:https://github.com/elastic/kibana/issues/82020[#82020].
====

[discrete]
[[breaking-112305]]
.Removes legacy logging
[%collapsible]
====
*Details* +
The logging configuration and log output format has changed. For more information, refer to {kibana-pull}112305[#112305].

*Impact* +
Use the new <<logging-configuration, logging system configuration>>.
====

[float]
[[reporting-breaking-changes-8.0.0-beta1]]
==== Reporting

[discrete]
[[breaking-114216]]
.Removes reporting settings
[%collapsible]
====
*Details* +
The following settings have been removed:

* `xpack.reporting.capture.concurrency`

* `xpack.reporting.capture.settleTime`

* `xpack.reporting.capture.timeout`

* `xpack.reporting.kibanaApp`

For more information, refer to {kibana-pull}114216[#114216].

*Impact* +
Before you upgrade to 8.0.0, remove the settings from kibana.yml.
====

[float]
[[rest-api-breaking-changes-8.0.0-beta1]]
==== REST API

[discrete]
[[breaking-114730]]
.Removes `/api/settings`
[%collapsible]
====
*Details* +
The `/api/settings` REST API has been removed. For more information, refer to {kibana-pull}114730[#114730].

*Impact* +
Use `/api/stats`.
====

[float]
[[security-breaking-changes-8.0.0-beta1]]
==== Security

[discrete]
[[breaking-116191]]
.Removes legacy audit logger
[%collapsible]
====
*Details* +
The legacy audit logger has been removed. For more information, refer to {kibana-pull}116191[#116191].

*Impact* +
Audit logs will be written to the default location in the new ECS format. To change the output file, filter events, and more, use the <<audit-logging-settings, audit logging settings>>.
====

[float]
[[deprecations-8.0.0-beta1]]
=== Deprecations

Deprecated functionality does not have an immediate impact on your application, but we strongly recommend you make the necessary updates after you complete the upgrade.

To review the 8.0.0 depcrecations, refer to the <<deprecations-8.0.0-alpha1,8.0.0-alpha1 release notes>>.

[float]
[[features-8.0.0-beta1]]
=== Features
The 8.0.0-beta1 release adds the following new and notable features.

Dashboard::
* Dashboard Integration {kibana-pull}115991[#115991]
Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Machine Learning::
* Addition of new Model Management tab {kibana-pull}115772[#115772]
Platform::
* Changes edit view to json read-only view {kibana-pull}112034[#112034]

[float]
[[enhancement-v8.0.0-beta1]]
=== Enhancements

The 8.0.0-beta1 release includes the following enhancements.

Canvas::
* By-Value embeddables {kibana-pull}113827[#113827]
* Toolbar UI updates {kibana-pull}113329[#113329]
Elastic Security::
For the Elastic Security 8.0.0 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Lens & Visualizations::
* Handle removal of deprecated date histogram interval in *Vega* {kibana-pull}109090[#109090]
* Adds value labels to Heatmap in *Lens* {kibana-pull}106406[#106406]
Logs::
* Make Alerts page use shared Kibana time range {kibana-pull}115192[#115192]
Machine Learning::
* Adds support to {fleet} {integrations} for installing ML models {kibana-pull}107710[#107710]
* Adds Index data visualizer grid embeddable as extra view within Discover {kibana-pull}107184[#107184]
Maps::
* Use Elastic Maps Service v8.0 {kibana-pull}116217[#116217]
* Use desaturated map tiles instead of bright map tiles by default {kibana-pull}116179[#116179]
* Use ES mvt {kibana-pull}114553[#114553]
Security::
* Register "minimal" feature privileges regardless of the current license level {kibana-pull}115992[#115992]
Uptime::
* Uptime index config using kibana.yml {kibana-pull}115775[#115775]

[float]
[[fixes-v8.0.0-beta1]]
=== Bug fixes

The 8.0.0-beta1 release includes the following bug fixes.

Management::
* Removes freeze action from Cold phase {kibana-pull}116160[#116160]
* Disallow creating runtime and scripted fields with * in the name {kibana-pull}116119[#116119]
Querying & Filtering::
* Fixes Add filter button doesnt close popup after openning {kibana-pull}111917[#111917]

[[release-notes-8.0.0-alpha2]]
== {kib} 8.0.0-alpha2

Review the {kib} 8.0.0-alpha2 changes, then use the <<upgrade-assistant,Upgrade Assistant>> to complete the upgrade.

[float]
[[breaking-changes-8.0.0-alpha2]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance. Review the following breaking changes, then mitigate the impact to your application.

To review the breaking changes in the previous version, refer to <<breaking-changes-8.0.0-alpha1,8.0.0-alpha1>>.

[discrete]
[[breaking-110830]]
.Changes the `GET /api/status` default behavior
[%collapsible]
====
*Details* +
`GET /api/status` reports a new and more verbose payload. For more information, refer to {kibana-pull}110830[#110830].

*Impact* +
To retrieve the {kib} status in the previous format, use `GET /api/status?v7format=true`.
====

[discrete]
[[breaking-110738]]
.Removes support for legacy exports
[%collapsible]
====
*Details* +
In {kib} 8.0.0 and later, the legacy format from {kib} 6.x is unsupported. For more information, refer to {kibana-pull}110738[#110738]

*Impact* +
Using the user interface to import saved objects is restricted to `.ndjson` format imports.
====

[discrete]
[[breaking-109896]]
.Removes `map.regionmap.*`
[%collapsible]
====
*Details* +
The deprecated `map.regionmap.*` setting in kibana.yml has been removed. For more information, refer to {kibana-pull}109896[#109896].

*Impact* +
If you have maps that use `map.regionmap` layers:

. Remove the `map.regionmap` layer.

. To recreate the choropleth layer, use <<import-geospatial-data,GeoJSON upload>> to index your static vector data into {es}.

. Create a choropleth layer from the indexed vector data.
====

[discrete]
[[breaking-109798]]
.Removes `kibana.defaultAppId`
[%collapsible]
====
*Details* +
The deprecated `kibana.defaultAppId` setting in kibana.yml, which is also available as `kibana_legacy.defaultAppId`, has been removed. For more information, refer to {kibana-pull}109798[#109798].

*Impact* +
When you upgrade, remove `kibana.defaultAppId` from your kibana.yml file. To configure the default route for users when they enter a space, use the <<defaultroute,`defaultRoute`>> in *Advanced Settings*.
====

[discrete]
[[breaking-109350]]
.Removes `courier:batchSearches`
[%collapsible]
====
*Details* +
The deprecated `courier:batchSearches` setting in *Advanced Settings* has been removed. For more information, refer to {kibana-pull}109350[#109350].

*Impact* +
When you upgrade, the `courier:batchSearches` setting will no longer be available.
====

[discrete]
[[breaking-108111]]
.Removes `xpack.task_manager.index`
[%collapsible]
====
*Details* +
The deprecated `xpack.task_manager.index` setting in kibana.yml has been removed. For more information, refer to {kibana-pull}108111[#108111].

*Impact* +
When you upgrade, remove `xpack.task_manager.index` from your kibana.yml file.
====

[discrete]
[[breaking-108103]]
.Removes dashboard-only mode
[%collapsible]
====
*Details* +
The legacy dashboard-only mode has been removed. For more information, refer to {kibana-pull}108103[#108103].

*Impact* +
To grant users access to only dashboards, create a new role, then assign only the *Dashboard* feature privilege. For more information, refer to <<kibana-feature-privileges,{kib} privileges>>.
====

[discrete]
[[breaking-105979]]
.Removes `xpack.maps.showMapVisualizationTypes`
[%collapsible]
====
*Details* +
The deprecated `xpack.maps.showMapVisualizationTypes` setting in kibana.yml has been removed. For more information, refer to {kibana-pull}105979[#105979]

*Impact* +
When you upgrade, remove `xpack.maps.showMapVisualizationTypes` from your kibana.yml file.
====

[float]
[[deprecations-8.0.0-alpha2]]
=== Deprecations

Deprecated functionality does not have an immediate impact on your application, but we strongly recommend you make the necessary updates after you complete the upgrade.

To review the 8.0.0 depcrecations, refer to the <<deprecations-8.0.0-alpha1,8.0.0-alpha1 release notes>>.

[float]
[[features-8.0.0-alpha2]]
=== Features
The 8.0.0-alpha2 release adds the following new and notable feature.

Security::
* Adds the interactive setup mode {kibana-pull}106881[#106881]

[float]
[[enhancement-v8.0.0-alpha2]]
=== Enhancements
The 8.0.0-alpha2 release includes the following enhancements.

Elastic Security::
For the Elastic Security 8.0.0-alpha2 release information, refer to {security-guide}/release-notes.html[_Elastic Security Solution Release Notes_].
Security::
* Interactive setup mode {kibana-pull}106881[#106881]

[[release-notes-8.0.0-alpha1]]
== {kib} 8.0.0-alpha1

Review the {kib} 8.0.0-alpha1 changes, then use the <<upgrade-assistant,Upgrade Assistant>> to complete the upgrade.

[float]
[[breaking-changes-8.0.0-alpha1]]
=== Breaking changes

Breaking changes can prevent your application from optimal operation and performance. Review the breaking changes, then mitigate the impact to your application.

[float]
[[enterprise-search-change]]
==== Enterprise Search changes

[discrete]
[[breaking-106307]]
.Required security plugin in 8.0
[%collapsible]
====
*Details* +
Enterprise Search now requires that you enable X-Pack Security. For more information, refer to {kibana-pull}106307[#106307]

*Impact* +
Enable X-Pack Security.
====

[float]
[[index-pattern-change]]
==== Index pattern changes

[discrete]
[[breaking-35173]]
.Removed support for time-based interval index patterns
[%collapsible]
====
*Details* +
Time-based interval index patterns were deprecated in 5.x. In 6.x, you could no longer create time-based interval index patterns, but they continued to function as expected. Support for these index patterns has been removed in 8.0. For more information, refer to {kibana-pull}35173[#35173]

*Impact* +
You must migrate your time_based index patterns to a wildcard pattern. For example, logstash-*.
====

[float]
[[operations-changes]]
==== Operations changes

[discrete]
[[breaking-93835]]
.Removed platform from archive root directory
[%collapsible]
====
*Details* +
After you extract an archive, the output directory no longer includes the target platform. For example, `kibana-8.0.0-linux-aarch64.tar.gz` produces a `kibana-8.0.0` folder. For more information, refer to {kibana-pull}93835[#93835].

*Impact* +
To use the new folder, update the configuration management tools and automation.
====

[discrete]
[[breaking-90511]]
.Removed default support for TLS v1.0 and v1.1
[%collapsible]
====
*Details* +
The default support for TLS v1.0 and v1.1 has been removed. For more information, refer to {kibana-pull}90511[#90511].

*Impact* +
To enable support, set `--tls-min-1.0` in the `node.options` configuration file. To locate the configuration file, go to the kibana/config folder or any other configuration with the `KBN_PATH_CONF` environment variable. For example, if you are using a Debian-based system, the configuration file is located in /etc/kibana.
====

[discrete]
[[breaking-74424]]
.Removed support for sysv init
[%collapsible]
====
*Details* +
All supported operating systems use systemd service files. Any system that doesn’t have `service` aliased to use kibana.service should use `systemctl start kibana.service` instead of `service start kibana`. For more information, refer to {kibana-pull}74424[#74424].

*Impact* +
If your installation uses .deb or .rpm packages with SysV, migrate to systemd.
====

[discrete]
[[breaking-42353]]
.Disabled response logging as a default
[%collapsible]
====
*Details* +
In previous versions, all events are logged in `json` when `logging.json:true`. With the new logging configuration, you can choose the `json` and pattern output formats with layouts. For more information, refer to {kibana-pull}42353[#42353].

*Impact* +
To restore the previous behavior, configure the logging format for each custom appender with the `appender.layout property` in kibana.yml. There is no default for custom appenders, and each appender must be configured expilictly.

[source,yaml]
-------------------
logging:
  appenders:
    custom_console:
      type: console
      layout:
        type: pattern
    custom_json:
      type: console
      layout:
        type: json
  loggers:
    - name: plugins.myPlugin
      appenders: [custom_console]
  root:
    appenders: [default, custom_json]
    level: warn
-------------------
====

[float]
[[reporting-changes-8.0.0-alpha1]]
==== Reporting changes

[discrete]
[[breaking-52539]]
.Legacy job parameters are no longer supported
[%collapsible]
====
*Details* +
*Reporting* is no longer compatible with POST URL snippets generated with {kib} 6.2.0 and earlier. For more information, refer to {kibana-pull}52539[#52539]

*Impact* +
If you use POST URL snippets to automatically generate PDF reports, regenerate the POST URL strings.
====

[float]
[[rest-api-changes]]
==== Security changes

[discrete]
[[breaking-47929]]
.Removed `/api/security/v1/saml` route
[%collapsible]
====
*Details* +
The `/api/security/v1/saml` route has been removed and is reflected in the kibana.yml `server.xsrf.whitelist` setting, {es}, and the Identity Provider SAML settings. For more information, refer to {kibana-pull}47929[#47929]

*Impact* +
Use the `/api/security/saml/callback` route, or wait to upgrade to 8.0.0-alpha2 when the `/api/security/saml/callback` route breaking change is reverted.
====

[discrete]
[[breaking-41700]]
.Reject legacy browsers by default
[%collapsible]
====
*Details* +
To provide the maximum level of protection for most installations, the csp.strict config is now enabled by default. Legacy browsers not supported by Kibana, such as Internet Explorer 11, are unable to access {kib} unless explicitly enabled. All browsers officially supported by Kibana do not have this issue. For more information, refer to {kibana-pull}41700[#41700]

*Impact* +
To enable support for legacy browsers, set `csp.strict: false` in kibana.yml. To effectively enforce the security protocol, we strongly discourage disabling `csp.strict` unless it is critical that you support Internet Explorer 11.
====

[float]
[[settings-changes-8.0.0-alpha1]]
==== Settings changes

[discrete]
[[breaking-106061]]
.Use new session timeout defaults
[%collapsible]
====
*Details* +
The default values for the session timeout `xpack.security.session.{lifespan|idleTimeout}` settings have changed. For more information, refer to {kibana-pull}106061[#106061]

*Impact* +
Use the following default values:

* `xpack.security.session.idleTimeout: 8h`
* `xpack.security.session.lifespan: 30d`
====

[discrete]
[[breaking-87114]]
.Removed support for setting `server.host` to '0'
[%collapsible]
====
*Details* +
Support for configuring {kib} with `0` as the `server.host` has been removed. Please use `0.0.0.0` instead. For more information, refer to {kibana-pull}87114[#87114]

*Impact* +
You are now unable to use `0` as the `server.host`.
====

[discrete]
[[breaking-38657]]
.Removed `xpack.security.public` and `xpack.security.authProviders`
[%collapsible]
====
*Details* +
The `xpack.security.public` and `xpack.security.authProviders` settings have been removed. For more information, refer to {kibana-pull}38657[#38657]

*Impact* +
Use the `xpack.security.authc.saml.realm` and `xpack.security.authc.providers` settings.
====

[discrete]
[[breaking-22696]]
.Removed useUTC deprecation
[%collapsible]
====
*Details* +
The `logging.useUTC` setting has been removed. For more information, refer to {kibana-pull}22696[#22696]

*Impact* +
The default timezone is UTC. To change the timezone, set `logging.timezone: false` in kibana.yml. Change the timezone when the system, such as a docker container, is configured for a nonlocal timezone.
====

[discrete]
[[breaking-32049]]
.Removed environment variables `CONFIG_PATH` and `DATA_PATH`
[%collapsible]
====
*Details* +
The environment variables `CONFIG_PATH` and `DATA_PATH` have been removed.  For more information, refer to {kibana-pull}32049[#32049]

*Impact* +
Use the environment variable `KBN_PATH_CONF` instead of `CONFIG_PATH`.  Use the setting `path.data` instead of `DATA_PATH`.
====

[float]
[[deprecations-8.0.0-alpha1]]
=== Deprecations

The following functionality is deprecated in 8.0.0, and will be removed in 9.0.0. Deprecated functionality does not have an immediate impact on your application, but we strongly recommend you make the necessary updates after you complete the upgrade.

[discrete]
[[deprecation-74424]]
.Removed support for SysV init
[%collapsible]
====
*Details* +
Systems that don't have `service` aliased to use kibana.service are unable to use `service start kibana`. For more information, refer to {kibana-pull}74424[#74424]

*Impact* +
If your system doesn't have `service` aliased to use kibana.service, use `systemctl start kibana.service`.
====

[discrete]
[[deprecation-33603]]
.Removed `xpack:defaultAdminEmail` setting
[%collapsible]
====
*Details* +
The `xpack:default_admin_email` setting for monitoring use has been removed. For more information, refer to {kibana-pull}33603[#33603]

*Impact* +
Use the `xpack.monitoring.clusterAlertsEmail` in kibana.yml.
====

[float]
[[enhancements-and-bug-fixes-v8.0.0-alpha1]]
=== Bug fix

The 8.0.0-alpha1 release includes the following bug fix.

Operations::
* Moves systemd service to /usr/lib/systemd/system {kibana-pull}83571[#83571]
/////