For information about the Kibana 7.12.0 release, review the following information.
Breaking changes can prevent your application from optimal operation and performance. Before you upgrade to 7.12.0, review the breaking changes, then mitigate the impact to your application.
Removes geo threshold alert type
Geo containment alerts and the Geo threshold alert type have similar functionality, so the Geo threshold alert type has been removed. For more information, refer to #89632.
Use Geo containment alerts.
New saved object upgrade migrations algorithm
When you upgrade to 7.12.0, Kibana uses a new algorithm to migrate saved objects to reduce the downtime caused by temporary issues, such as network errors or temporarily overloaded Elasticsearch clusters. With the new algorithm, Kibana now retries the failed migrations without user intervention, which allows the migration to continue after the issues are resolved. For more information, refer to saved object upgrade migrations.
Before you upgrade to 7.12.0, review the documentation for rolling back to a previous version of Kibana.
Kibana support for CCS
In 7.12.0, Kibana introduces a major incompatibility with cross-cluster search. When one or more remote Elasticsearch clusters use a version prior to 7.12.0, Discover, Maps, Canvas, and Logs are unable to display the cluster data. For information about the cross-cluster search limitations in Kibana, refer to #94965.
To display the cluster data in Discover, load documents directly from
- Open the main menu, then click Stack Management > Advanced Settings.
discover:searchFieldsFromSource, then select On.
Saved object migrations
When upgrading to 7.12.0, Kibana retries failed saved object migrations without user intervention.
In 7.12.0, upgrade migrations fail because of a large number of documents in the
.kibanaindex when you use Fleet.
- Corrupt saved objects caused by manual editing or integrations.
User-defined index templates that cause new
.kibana*indices to have incompatible settings or mappings.
- An unhealthy Elasticsearch cluster.
- Different versions of Kibana connected to the same Elasticsearch index.
If your upgrade migration fails repeatedly, refer to preventing migration failures.
Cluster performance degradation
Kibana fails to update and delete search sessions objects created in non-default spaces.
Impact: Cluster performance degrades due to a flooding of async search API usage. For information on the workaround for 7.12.0, refer to #96124.
For information on the fix in 7.12.1, refer to #96123.
The following functionality is deprecated in 7.12.0, and will be removed in 8.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 7.12.0.
services.callCluster in alerts and actions executors
services.callCluster in the alert and action type executors. For more information, refer to #86474.
Deprecates configuring [kib] with a
server.host value of
In the new version of joi,
0 is an invalid hostname. When upgraded, the extra validate function can be removed. For more information, refer to #87114.
To bind to all interfaces, use
Deprecates the use of
logging.verbose: true or
logging.root.level: 'debug', Elasticsearch query logs are now always shown.
In 7.11.0 and earlier, Elasticsearch query logs were not included in verbose logging unless
elasticsearch.logQueries was configured.
For more information, refer to #89296.
To use verbose logging without Elasticsearch query logs, configure the query logs to
off in kibana.yml:
logging: loggers: - name: elasticsearch.query level: off
To log the elasticsearch query only:
logging: loggers: - name: elasticsearch.query level: all appenders: [console]
Kibana 7.12.0 adds the following new and notable features.
- Search alert #88528
- Correlations Beta #89952
- Support IP data type #85087
- Support mapping defined runtime fields in Discover #83891
- Elastic Security
- For the Elastic Security 7.12.0 release information, refer to Elastic Security Solution Release Notes.
- Lens & Visualizations
- Show anomalies across both the log rate and categorization ML jobs in a swimlane visualization #89589
- Machine Learning
- GA Geo containment alerts. Remove Geo containment alert experimental config settings and refs #90301
- Implement custom global header banner #87438
For more information about the features introduced in 7.12.0, refer to What’s new in 7.12.