Kibana 8.0.0-beta1edit
Review the Kibana 8.0.0-beta1 changes, then use the Upgrade Assistant to complete the upgrade.
Breaking changesedit
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:
Alertingedit
Removes 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 & visualizationsedit
Removes 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.enabled
withvis_type_metric.enabled
-
Replace
table_vis.enabled
withvis_type_table.enabled
-
Replace
tagcloud.enabled
withvis_type_tagcloud.enabled
-
Replace
metrics.enabled
withvis_type_timeseries.enabled
-
Replace
metrics.chartResolution
andchartResolution
withvis_type_timeseries.chartResolution
-
Replace
metrics.minimumBucketSize
andminimumBucketSize
withvis_type_timeseries.minimumBucketSize
-
Replace
vega.enabled
withvis_type_vega.enabled
-
Replace
vega.enableExternalUrls
withvis_type_vega.enableExternalUrls
-
Remove
vis_type_table.legacyVisEnabled
-
Replace
timelion_vis.enabled
withvis_type_timelion.enabled
-
Replace
timelion.enabled
withvis_type_timelion.enabled
-
Replace
timelion.graphiteUrls
withvis_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.
Logsedit
Removes deprecated alias config entries
Removes configurable fields in settings
Machine learningedit
Grants 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.
Mapsedit
Removes 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.
Operationsedit
Removes 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.
Platformedit
Removes 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.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 #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}.enabled
from kibana.yml. If you use the setting to control user access to Kibana applications, use Features controls instead. -
Replace
xpack.security.enabled
withxpack.security.enabled
in 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.
Reportingedit
Removes 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 APIedit
Removes /api/settings
Details
The /api/settings
REST API has been removed. For more information, refer to #114730.
Impact
Use /api/stats
.
Securityedit
Removes 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.
Deprecationsedit
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 8.0.0-alpha1 release notes.
Featuresedit
The 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
Enhancementsedit
The 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 fixesedit
The 8.0.0-beta1 release includes the following bug fixes.