Kibana 8.0.0-beta1
editKibana 8.0.0-beta1
editReview the Kibana 8.0.0-beta1 changes, then use the Upgrade Assistant to complete the upgrade.
Breaking changes
editBreaking 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:
Alerting
editRemoves xpack.task_manager.index
Details
The xpack.task_manager.index setting has been removed. For more information, refer to #114558.
Impact
Before you upgrade to 8.0.0, remove xpack.task_manager.index from kibana.yml.
Removes ability to remove plugins
Details
The xpack.actions.enabled setting has been removed. For more information, refer to #113461.
Impact
Before you upgrade to 8.0.0, remove xpack.actions.enabled from kibana.yml.
Lens & visualizations
editRemoves display options from legacy gauge
Details
The Display warnings option has been removed from the aggregation-based gauge visualization. For more information, refer to #113516.
Impact
When you create aggregation-based gauge visualizations, the Display warnings option is no longer available in Options > Labels.
Removes settings from visEditors plugins
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 #112643.
Impact
Before you upgrade, make the following changes in kibana.yml:
-
Replace
metric_vis.enabledwithvis_type_metric.enabled -
Replace
table_vis.enabledwithvis_type_table.enabled -
Replace
tagcloud.enabledwithvis_type_tagcloud.enabled -
Replace
metrics.enabledwithvis_type_timeseries.enabled -
Replace
metrics.chartResolutionandchartResolutionwithvis_type_timeseries.chartResolution -
Replace
metrics.minimumBucketSizeandminimumBucketSizewithvis_type_timeseries.minimumBucketSize -
Replace
vega.enabledwithvis_type_vega.enabled -
Replace
vega.enableExternalUrlswithvis_type_vega.enableExternalUrls -
Remove
vis_type_table.legacyVisEnabled -
Replace
timelion_vis.enabledwithvis_type_timelion.enabled -
Replace
timelion.enabledwithvis_type_timelion.enabled -
Replace
timelion.graphiteUrlswithvis_type_timelion.graphiteUrls -
Remove
timelion.ui.enabled
Removes dimming opacity setting
Details
The Dimming opacity setting in Advanced Settings has been removed. For more information, refer to #111704.
Impact
When you upgrade to 8.0.0, you are no longer able to configure the dimming opactiy for visualizations.
Removes Less stylesheet support
Details
In TSVB, custom Less stylesheets have been removed. For more information, refer to #110985.
Impact
Existing less stylesheets are automatically converted to CSS stylesheets.
Disables the input string mode
Details
In TSVB, the Index pattern selection mode option has been removed. For more information, refer to #110571.
Impact
To use index patterns and Elasticsearch indices in TSVB visualizations:
- Open the main menu, then click Stack Management > Advanced Settings.
- Select Allow string indices in TSVB.
- Click Save changes.
Logs
editRemoves deprecated alias config entries
Removes configurable fields in settings
Machine learning
editGrants access to machine learning features when base privileges are used
Details
Machine learning features are included as base privileges. For more information, refer to #115444.
Impact
If you do not want to grant users privileges to machine learning features, update Users and Roles.
Maps
editRemoves proxyElasticMapsServiceInMaps
Details
The map.proxyElasticMapsServiceInMaps setting has been removed. For more information, refer to #116184.
Impact
Install the on-prem version of the 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.
Operations
editRemoves environment variables
Details
The CONFIG_PATH and DATA_PATH environment variables have been removed. For more information, refer to #111535.
Impact
Replace the CONFIG_PATH environment variable with KBN_PATH_CONF, and replace DATA_PATH with the path.data setting.
Platform
editRemoves supports for csp.rules configuration
Details
Support for the csp.rules configuration property has been removed. For more information, refer to #114379.
Impact
Configuring the default csp.script_src, csp.workers_src, and csp.style_src values is not required.
Changes and removes deprecated core settings and deprecated settings from core plugins
Details
The deprecation notice for server.cors has changed from level:critical to level:warning.
The following settings have changed:
-
The
xpack.banners.placementvalue has been renamed -
The
newsfeed.defaultLanguagenewsfeed 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 #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 Kibana configuration file using the KBN_PATH_CONF environment variable
Removes enabled settings from plugins
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 Kibana plugins will not support this setting. Any new plugin will support this setting only when specified in the configSchema. For more information, refer to #113495.
The xpack.security.enabled setting has been removed. For more information, refer to #111681.
Impact
Before you upgrade to 8.0.0:
-
Remove
{plugin_name}.enabledfrom kibana.yml. If you use the setting to control user access to Kibana applications, use Features controls instead. -
Replace
xpack.security.enabledwithxpack.security.enabledin elasticsearch.yml.
Removes --plugin-dir cli option
Details
The plugins.scanDirs setting and --plugin-dir cli option have been removed. For more information, refer to #113367.
Impact
Before you upgrade to 8.0.0, remove plugins.scanDirs from kibana.yml.
Removes support for optimize.* settings
Details
The legacy optimize.* settings have been removed. If your configuration uses the following legacy optimize.* settings, Kibana 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 #113296.
Impact
To run the @kbn/optimizer separately in development, pass --no-optimizer to yarn start. For more details, refer to #73154.
Removes so/server/es settings
Details
Some of the so/server/es settings have been removed. If your configuration uses the following settings, Kibana fails to start:
-
savedObjects.indexCheckTimeout -
server.xsrf.token -
elasticsearch.preserveHost -
elasticsearch.startupTimeout
For more information, refer to #113173.
Impact
Before you upgrade to 8.0.0., remove these settings from kibana.yml.
Adds requirement for inline scripting
Details
To start Kibana, you must enable inline scripting in Elasticsearch. For more information, refer to #113068.
Impact
Enable inline scripting.
Removes kibana.index settings
Details
The kibana.index, xpack.reporting.index, and xpack.task_manager.index settings have been removed. For more information, refer to #112773.
Impact
Use spaces, cross-cluster replication, or cross-cluster search. To migrate to spaces, export your saved objects from a tenant into the default space. For more details, refer to #82020.
Removes legacy logging
Details
The logging configuration and log output format has changed. For more information, refer to #112305.
Impact
Use the new logging system configuration.
Reporting
editRemoves reporting settings
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 #114216.
Impact
Before you upgrade to 8.0.0, remove the settings from kibana.yml.
REST API
editRemoves /api/settings
Details
The /api/settings REST API has been removed. For more information, refer to #114730.
Impact
Use /api/stats.
Security
editRemoves legacy audit logger
Details
The legacy audit logger has been removed. For more information, refer to #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.
Deprecations
editDeprecated 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 8.0.0-alpha1 release notes.
Features
editThe 8.0.0-beta1 release adds the following new and notable features.
- Dashboard
-
- Dashboard Integration #115991
- Elastic Security
- For the Elastic Security 8.0.0 release information, refer to Elastic Security Solution Release Notes.
- Machine Learning
-
- Addition of new Model Management tab #115772
- Platform
-
- Changes edit view to json read-only view #112034
Enhancements
editThe 8.0.0-beta1 release includes the following enhancements.
- Canvas
- Elastic Security
- For the Elastic Security 8.0.0 release information, refer to Elastic Security Solution Release Notes.
- Lens & Visualizations
- Logs
-
- Make Alerts page use shared Kibana time range #115192
- Machine Learning
- Maps
- Security
-
- Register "minimal" feature privileges regardless of the current license level #115992
- Uptime
-
- Uptime index config using kibana.yml #115775
Bug fixes
editThe 8.0.0-beta1 release includes the following bug fixes.