This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Elasticsearch version 8.12.0
editElasticsearch version 8.12.0
editAlso see Breaking changes in 8.12.
Known issues
edit-
int8_hnsw
vector index format may fail to merge segments and prevent from indexing documents (issue: #104617)When using
int8_hnsw
and the defaultconfidence_interval
(or anyconfidence_interval
less than1.0
) and when there are deleted documents in the segments, quantiles may fail to build and prevent merging.This issue is fixed in 8.12.1.
- When upgrading clusters from version 8.11.4 or earlier, if your cluster contains non-master-eligible nodes, information about the new functionality of these upgraded nodes may not be registered properly with the master node. This can lead to some new functionality added since 8.12.0 not being accessible on the upgraded cluster. If your cluster is running on ECK 2.12.1 and above, this may cause problems with finalizing the upgrade. To resolve this issue, perform a rolling restart on the non-master-eligible nodes once all Elasticsearch nodes are upgraded. This issue is fixed in 8.15.0.
Breaking changes
editThere are no breaking changes in 8.12
Notable changes
editThere are notable changes in 8.12 that you need to be aware of but that we do not consider breaking, items that we may consider as notable changes are
- Changes to features that are in Technical Preview.
- Changes to log formats.
- Changes to non-public APIs.
-
Behaviour changes that repair critical bugs.
- Authorization
-
Fixed JWT principal from claims #101333
- ES|QL
-
[ES|QL] pow function always returns double #102183 (issue: #99055)
- Infra/Plugins
- Remove Plugin.createComponents method in favour of overload with a PluginServices object #101457
Bug fixes
edit- Aggregations
-
- Adjust Histogram’s bucket accounting to be iteratively #102172
- Aggs error codes part 1 #99963
- Skip global ordinals loading if query does not match after rewrite #102844
- Trigger parent circuit breaker when building scorers in filters aggregation #102511
-
Unwrap
ExecutionException
when loading from cache inAbstractIndexOrdinalsFieldData
#102476
- Application
-
- [Connector API] Fix bug with nullable tooltip field in parser #103427
-
[Connectors API] Fix
ClassCastException
when creating a new sync job #103508 -
[Connectors API] Fix bug with missing TEXT
DisplayType
enum #103430 -
[Connectors API] Handle nullable fields correctly in the
ConnectorSyncJob
parser #103183 - [Profiling] Query in parallel only if beneficial #103061
- [Search Applications] Return 400 response when template rendering produces invalid JSON #101474
- Authentication
- Authorization
-
- Fix cache invalidation on privilege modification #102193
- Data streams
-
- Use dataset size instead of on-disk size for data stream stats #103342
- Distributed
- Downsampling
- EQL
- ES|QL
-
-
ESQL: Fix
to_degrees()
returning infinity #103209 (issue: #102987) - ESQL: Fix planning of MV_EXPAND with foldable expressions #101385 (issue: #101118)
- ESQL: Fix rare bug with empty string #102350 (issue: #101969)
- ESQL: Fix resolution of MV_EXPAND after KEEP * #103339 (issue: #103331)
- ESQL: Fix single value query #102317 (issue: #102298)
- ESQL: Improve local folding of aggregates #103670
- ESQL: Improve pushdown of certain filters #103671
- ESQL: Narrow catch in convert functions #101788 (issue: #100820)
- ESQL: Update the use of some user-caused exceptions #104046
-
ESQL: remove
time_zone
request parameter #102767 (issue: #102159) - ES|QL: Fix NPE on single value detection #103150 (issue: #103141)
-
ES|QL: Improve resolution error management in
mv_expand
#102967 (issue: #102964) - Fix layout for MV_EXPAND #102916 (issue: #102912)
- Fix now in millis for ESQL search contexts #103474 (issue: #103455)
- Fix planning of duplicate aggs #102165 (issue: #102083)
-
Fix the transport version of
PlanStreamOutput
#103758 -
AsyncOperator#isFinished
must never return true on failure #104029
-
ESQL: Fix
- Engine
-
-
Fix
lastUnsafeSegmentGenerationForGets
for realtime get #101700
-
Fix
- Geo
- ILM+SLM
- Indices APIs
- Infra/Core
- Infra/Node Lifecycle
-
- Wait for reroute before acking put-shutdown #103251
- Infra/Plugins
- Infra/Scripting
- Infra/Settings
-
- Report full stack trace for non-state file settings transforms #101346
- Ingest Node
-
-
Sending an index name to
DocumentParsingObserver
that is not ever null #100862
-
Sending an index name to
- License
-
- Error log when license verification fails locally #102919
- Machine Learning
-
-
Catch exceptions during
pytorch_inference
startup #103873 - Exclude quantiles when fetching model snapshots where possible #103530
-
Fix
frequent_item_sets
aggregation on empty index #103116 (issue: #103067) - If trained model download task is in progress, wait for it to finish before executing start trained model deployment #102944
- Persist data counts on job close before results index refresh #101147
- Preserve response headers in Datafeed preview #103923
- Prevent attempts to access non-existent node information during rebalancing #103361
- Prevent resource over-subscription in model allocation planner #100392
- Start a new trace context before loading a trained model #103124
- Wait for the model results on graceful shutdown #103591 (issue: #103414)
-
Catch exceptions during
- Mapping
-
- Revert change #103865
- Monitoring
-
- [Monitoring] Dont get cluster state until recovery #100565
- Network
-
-
Ensure the correct
threadContext
forRemoteClusterNodesAction
#101050
-
Ensure the correct
- Ranking
- Reindex
- Search
-
-
Add JIT compiler excludes for
computeCommonPrefixLengthAndBuildHistogram
#103112 - Check that scripts produce correct json in render template action #101518 (issue: #101477)
-
Fix NPE & empty result handling in
CountOnlyQueryPhaseResultConsumer
#103203 -
Fix format string in
OldLuceneVersions
#103185 - Handle timeout on standalone rewrite calls #103546
-
Introduce Elasticsearch
PostingFormat
based on Lucene 90 positing format using PFOR #103601 (issue: #103002) - Restore inter-segment search concurrency with synthetic source is enabled #103690
- Support complex datemath expressions in index and index alias names #100646
-
Add JIT compiler excludes for
- Snapshot/Restore
- TSDB
-
-
Throw when wrapping rate agg in
DeferableBucketAggregator
#101032
-
Throw when wrapping rate agg in
- Transform
-
- Add an assertion to the testTransformFeatureReset test case #100287
- Consider search context missing exceptions as recoverable #102602
- Consider task cancelled exceptions as recoverable #100828
-
Fix NPE that is thrown by
_update
API #104051 (issue: #104048) - Log stacktrace together with log message in order to help debugging #101607
- Split comma-separated source index strings into separate indices #102811 (issue: #99564)
- Vector Search
-
- Disallow vectors whose magnitudes will not fit in a float #100519
- Watcher
Enhancements
edit- Aggregations
-
- Check the real memory circuit breaker when building global ordinals #102462
- Disable concurrency for sampler and diversified sampler #102832
- Disable parallelism for composite agg against high cardinality fields #102644
- Enable concurrency for multi terms agg #102710
- Enable concurrency for scripted metric agg #102461
- Enable inter-segment concurrency for terms aggs #101390
- Export circuit breaker trip count as a counter metric #101423
- Introduce fielddata cache ttl #102682
- Status codes for Aggregation errors, part 2 #100368
- Support keyed histograms #101826 (issue: #100242)
- Allocation
- Application
-
- Calculate CO2 and emmission and costs #101979
- Consider duplicate stacktraces in custom index #102292
- Enable Universal Profiling as Enterprise feature #100333
- Include totals in flamegraph response #101126
- Retrieve stacktrace events from a custom index #102020
- [Profiling] Notify early about task cancellation #102740
- [Profiling] Report in status API if docs exist #102735
- Authentication
- Authorization
- CAT APIs
-
- Expose roles by default in cat allocation API #101753
- CRUD
-
- Cache resolved index for mgets #101311
- Data streams
- Distributed
-
- Add support for configuring proxy scheme in S3 client settings and EC2 discovery plugin #102495 (issue: #101873)
-
Introduce a
StreamOutput
that counts how many bytes are written to the stream #102906 - Push s3 requests count via metrics API #100383
- Record operation purpose for s3 stats collection #100236
- EQL
- ES|QL
-
-
ESQL: Add
profile
option #102713 - ESQL: Alias duplicated aggregations in a stats #100642 (issue: #100544)
- ESQL: Load more than one field at once #102192
- ESQL: Load stored fields sequentially #102727
- ESQL: Load text field from parent keyword field #102490 (issue: #102473)
- ESQL: Make blocks ref counted #100408
- ESQL: Make fieldcaps calls lighter #102510 (issues: #101763, #102393)
-
ESQL: More tracking in
BlockHash
impls #101488 - ESQL: New telemetry commands #102937
- ESQL: Share constant null Blocks #102673
- ESQL: Short circuit loading empty doc values #102434
-
ESQL: Support the
_source
metadata field #102391 - ESQL: Track blocks emitted from lucene #101396
- ESQL: Track memory from values loaded from lucene #101383
- Fast path for reading single doc with ordinals #102902
- Introduce local block factory #102901
- Load different way #101235
- Track ESQL enrich memory #102184
-
Track blocks in
AsyncOperator
#102188 - Track blocks of intermediate state of aggs #102562
- Track blocks when hashing single multi-valued field #102612
- Track pages in ESQL enrich request/response #102190
-
ESQL: Add
- Engine
-
- Add static node settings to set default values for max merged segment sizes #102208
- Geo
- Health
- ILM+SLM
- Indices APIs
-
- Add executed pipelines to bulk api response #100031
- Add support for marking component templates as deprecated #101148 (issue: #100992)
- Allowing non-dynamic index settings to be updated by automatically unassigning shards #101723
- Rename component templates and pipelines according to the new naming conventions #99975
-
Run
TransportGetAliasesAction
on local node #101815
- Infra/CLI
-
-
Set
ActiveProcessorCount
whennode.processors
is set #101846
-
Set
- Infra/Core
- Infra/Logging
-
-
Add status code to
rest.suppressed
log output #100990
-
Add status code to
- Ingest Node
- Machine Learning
-
-
Accept a single or multiple inputs to
_inference
#102075 - Add basic telelemetry for the inference feature #102877
- Add internal inference action for ml models an services #102731
- Add prefix strings option to trained models #102089
- Estimate the memory required to deploy trained models more accurately #98874
- Improve stability of spike and dip detection for the change point aggregation #102637
-
Include ML processor limits in
_ml/info
response #101392 - Read scores from downloaded vocabulary for XLM Roberta tokenizers #101868
-
Support for GET all models and by task type in the
_inference
API #102806
-
Accept a single or multiple inputs to
- Mapping
-
- Improve analyzer reload log message #102273
- Monitoring
- Network
-
- Record more detailed HTTP stats #99852
- Search
-
- Add metrics to the shared blob cache #101577
- Add support for Serbian Language Analyzer #100921
-
Add support for
index_filter
to open pit #102388 (issue: #99740) - Added metric for cache eviction of entries with non zero frequency #100570
- Disable inter-segment concurrency when sorting by field #101535
- Enable query phase parallelism within a single shard #101230 (issue: #80693)
- Node stats as metrics #102248
-
Optimize
_count
type API requests #102888
- Security
- Snapshot/Restore
- Stats
- Store
- Transform
-
- Implement exponential backoff for transform state persistence retrying #102512 (issue: #102528)
- Make tasks that calculate checkpoints time out #101055
-
Pass source query to
_field_caps
(asindex_filter
) when deducing destination index mappings for better performance #102379 -
Pass transform source query as
index_filter
toopen_point_in_time
request #102447 (issue: #101049) - Skip shards that don’t match the source query during checkpointing #102138
- Vector Search
New features
edit- Application
-
- Enable Connectors API as technical preview #102994
- [Behavioral Analytics] Analytics collections use Data Stream Lifecycle (DSL) instead of Index Lifecycle Management (ILM) for data retention management. Behavioral analytics has traditionally used ILM to manage data retention. Starting with 8.12.0, this will change. Analytics collections created prior to 8.12.0 will continue to use their existing ILM policies, but new analytics collections will be managed using DSL. #100033
- Authentication
-
- Patterns support for allowed subjects by the JWT realm #102426
- Cluster Coordination
-
- Add a node feature join barrier. This prevents nodes from joining clusters that do not have all the features already present in the cluster. This ensures that once a features is supported by all the nodes in a cluster, that feature will never then not be supported in the future. This is the corresponding functionality for the version join barrier, but for features #101609
- Data streams
-
- Add ability to create a data stream failure store #99134
- ES|QL
- Infra/Core
-
- Create new cluster state API for querying features present on a cluster #100974
- Ingest Node
-
- Adding a simulate ingest api #101409
- Security
-
- Allow granting API keys with JWT as the access_token #101904
- Vector Search
Regressions
edit- Infra/Core
-
-
Revert non-semantic
NodeInfo
#102636
-
Revert non-semantic
Upgrades
edit- Search
-
- Upgrade to Lucene 9.9.1 #103549