Commit Graph

11262 Commits

Author SHA1 Message Date
florent-leborgne 4ee086e406
[DOCS] [Remote clusters] Reference specific instructions for cloud trust 2024-02-15 09:39:02 +01:00
István Zoltán Szabó 6827f002bb
[DOCS] Adds docs to built-in and Eland model support in Inference API (#105500)
Co-authored-by: Max Hniebergall <137079448+maxhniebergall@users.noreply.github.com>
2024-02-15 09:29:41 +01:00
elasticsearchmachine 559edc79bf Bump to version 8.14.0 2024-02-14 18:05:43 +00:00
Jedr Blaszyk 91e6fbc6d5
[Connector API] Add 8.13 docs (#105456) 2024-02-14 12:10:59 +01:00
Slobodan Adamović 1f0ea3e015
[Doc] Mark `secure_bind_password` settings as reloadable (#105448)
This is a followup to #104320, which updates the docs for `secure_bind_password` 
settings and marks them as reloadable.
2024-02-13 14:04:32 +01:00
Lee Hinman d95d6adae5
Clarify update operations may be performed on a data stream's backing indices (#105408)
These statements come off a little too strongly towards "don't use data streams if you *ever* have updates", but they do support updates when necessary, as long as the backing indices are used.
2024-02-12 10:58:13 -07:00
István Zoltán Szabó 6e8e7ba875
[DOCS] Adds cohere service to inference API docs (#105394) 2024-02-12 16:35:57 +01:00
Keith Massey d268173350
Fixing a minor typo in bulk api docs (#105404) 2024-02-12 09:24:42 -06:00
Albert Zaharovits 9ee76c6b26
Aggs support for Query API Key Information API (#104895)
Adds support for the aggs request body parameter to the Query API Key Information API.
This parameter works identically to the well known eponymous parameter of the _search endpoint,
but the set of allowed aggregation types as well as the field names allowed is restricted.
2024-02-12 14:22:34 +02:00
David Turner cc2e56da38
Security auto-config overrides default `http.host` (#105377)
If you start up a freshly-unpacked Elasticsearch tarball, security
auto-configuration will set `http.host: 0.0.0.0` in `elasticsearch.yml`,
overriding the documented default behaviour which is to fall back to
`network.host` which itself defaults to `localhost`. This commit adds a
note to the docs about this.
2024-02-12 09:54:38 +00:00
Andrew Wilkins 5f90978296
Add `unmatch_mapping_type`, and support array of types (#103171)
Add an `unmatch_mapping_type` condition to dynamic templates (supporting
one or more types), and add support for specifying a list of types to
`match_mapping_type`.

Closes https://github.com/elastic/elasticsearch/issues/102795 Closes
https://github.com/elastic/elasticsearch/issues/102807
2024-02-09 10:42:26 -05:00
Bogdan Pintea f2550a8055
ESQL: Document `_source` requirements (#105321)
This documents the requirements for _source availability: - not
supported with disabled _source; - experimental support for synthetic.
2024-02-09 10:35:30 -05:00
Michael Peterson 33e22c4467
Docs improvements for the new resolve/cluster API (#105297) 2024-02-08 13:36:07 -05:00
Matteo Piergiovanni 54cfce4379
Flag in _field_caps to return only fields with values in index (#103651)
We are adding a query parameter to the field_caps api in order to filter out 
fields with no values. The parameter is called `include_empty_fields`  and 
defaults to true, and if set to false it will filter out from the field_caps 
response all the fields that has no value in the index.
We keep track of FieldInfos during refresh in order to know which field has 
value in an index. We added also a system property 
`es.field_caps_empty_fields_filter` in order to disable this feature if needed.

---------

Co-authored-by: Matthias Wilhelm <ankertal@gmail.com>
2024-02-08 17:52:21 +01:00
Michael Peterson ac36aa7795
Resolve Cluster API (#102726)
To improve cross-cluster search user experience, Kibana needs an endpoint that is accessible
by arbitrary Kibana dashboard search users and provides:

1. a listing of clusters in scope for a CCS query (based on the index expression and whether 
there are any indices on each cluster that the Kibana user has access to query).
2. whether that cluster is currently connected to the querying cluster (will it come back as 
skipped or failed in a CCS search)
3. showing the skip_unavailable setting for those clusters (so you can know whether it will
return skipped or failed in a CCS search)
4. the ES version of the cluster

Since no single Elasticsearch endpoint provides all of these features, this PR creates a new endpoint `_resolve/cluster` that works along side the existing `_resolve/index` endpoint 
(and leverages some of its features).

Example usage against a cluster with 2 remote clusters configured:

GET /_resolve/cluster/*,remote*:bl*

Response:

{
  "(local)": {
    "connected": true,
    "skip_unavailable": false,
    "matching_indices": true,
    "version": {
      "number": "8.12.0-SNAPSHOT",
      "build_flavor": "default",
      "minimum_wire_compatibility_version": "7.17.0",
      "minimum_index_compatibility_version": "7.0.0"
    }
  },
  "remote2": {
    "connected": true,
    "skip_unavailable": true,
    "matching_indices": true,
    "version": {
      "number": "8.12.0-SNAPSHOT",
      "build_flavor": "default",
      "minimum_wire_compatibility_version": "7.17.0",
      "minimum_index_compatibility_version": "7.0.0"
    }
  },
  "remote1": {
    "connected": true,
    "skip_unavailable": false,
    "matching_indices": false,
    "version": {
      "number": "8.12.0-SNAPSHOT",
      "build_flavor": "default",
      "minimum_wire_compatibility_version": "7.17.0",
      "minimum_index_compatibility_version": "7.0.0"
    }
  }
}

Almost all errors show up as "error" entries in the response.
Only the local SecurityException returns a 403 since that happens before the ResolveCluster
Transport code kicks in.
2024-02-08 10:50:05 -05:00
Costin Leau fca3fc82be
ESQL: Grammar - FROM METADATA no longer require [] (#105221)
Remove usage of [ ] through-out the grammar, in this case inside
 FROM METADATA.
2024-02-08 07:03:19 -08:00
Bogdan Pintea f26691f987
ESQL: Mark a few features as experimental (#105263)
Mark the following features as experimental in the docs:
* `AUTO_BUCKET()`
* `SHOW FUNCTIONS`
* unsigned_long type
2024-02-07 17:28:13 -08:00
Fabio Busatto b1adb78f6c
[DOCS] Update remote cluster setup instructions (#105256) 2024-02-07 21:11:57 +01:00
Liam Thompson fb743da0d7
[DOCS][ESQL] Document _source metadata field (#105237)
* [DOCS][ESQL] Document _source metadata field

* 🚗 Minor copyedit to entire page
2024-02-07 15:57:51 +01:00
Niels Bauman 64891011d3
Extend `repository_integrity` health indicator for unknown and invalid repos (#104614)
This PR extends the repository integrity health indicator to cover also unknown and invalid repositories. Because these errors are local to a node, we extend the `LocalHealthMonitor` to monitor the repositories and report the changes in their health regarding the unknown or invalid status.
To simplify this extension in the future, we introduce the `HealthTracker` abstract class that can be used to create new local health checks.
Furthermore, we change the severity of the health status when the repository integrity indicator reports unhealthy from `RED` to `YELLOW` because even though this is a serious issue, there is no user impact yet.
2024-02-07 15:18:55 +01:00
elasticsearchmachine aaadc30111
Forward port release notes for v8.12.1 (#105218) 2024-02-07 09:16:38 +01:00
Johannes Fredén 334aa1bc8d
Add support for fetching user profileId in Query Users (#104923)
Add support for fetching user profileId in Query Users
2024-02-07 08:49:39 +01:00
Fang Xing 0fb5dee75b
[ES|QL] Add function log(base, value) (#104913)
Add a new scalar function log
2024-02-06 13:03:53 -05:00
Nik Everett a7ca62de8e
Document ESQL docs examples (#105197)
This adds some docs to the top of `docs.csv-spec` and
`docs-IT_tests_only.csv-spec` telling folks not to add more stuff there
and instead put new examples into whatever files they line up with. It
also shifts some things out of the file to "prime the pump" on cleaning
it up.
2024-02-06 12:34:02 -05:00
David Roberts e8288fbaa8
[ML] Improve docs around ML nodes and xpack.ml.enabled (#105199)
Since these docs were originally written there have been a couple
of changes:

1. We now support aarch64 as well as x86_64, so the SSE4.2 guidance
   needed clarification.
2. ML is more deeply embedded into Elasticsearch functionality
   across nodes that are not ML nodes. For example, ingest pipelines
   now routinely use ML, and, in the near future, index mappings
   will too in the form of semantic text. Although we cannot mandate
   that xpack.ml.enabled is set uniformly across the cluster, as
   that would be a breaking change, we should say ever more strongly
   that ML must be enabled on all nodes if all ML functionality is to
   work correctly. The primary reason for wanting to disable ML is
   hardware incompatibility, and if ML is disabled for that reason
   then it should not be used at all.
2024-02-06 16:20:46 +00:00
David Kyle 5f325187cb
[ML] Make task_type optional (#104483)
Makes the task_type element of the _inference API optional so that 
it is possible to GET, DELETE or POST to an inference entity without
providing the task type
2024-02-06 16:15:24 +00:00
Liam Thompson 8a3920ab85
[DOCS] Update `KEEP` command with duplicate precedence rules (#105146) 2024-02-06 15:55:41 +01:00
Yang Wang 6cf92584ba
[Docs] Minor tweak for balance settings docs (#105170)
Relates: #105119
2024-02-06 22:31:35 +11:00
Liam Thompson 2c83881a0b
[DOCS][ESQL] Document locale rest parameter (#104985) 2024-02-06 10:36:51 +01:00
Benjamin Trent 43362d5de5
Add new int8_flat and flat vector index types (#104872)
This adds two new vector index types:  - flat   - int8_flat

Both store the vectors in a flat space and search is brute-force over
the vectors in the index.   For the regular `flat` index, this can be
considered syntactic sugar that allows `knn` queries without having to
put indices within HNSW. 

For `int8_flat`, this allows float vectors to be stored in a flat
manner, but also automatically quantized.
2024-02-05 12:56:13 -05:00
David Kilfoyle 6ae521bf12
[DOCS] Small fixes for the 'Installing Elasticsearch' page (#105034)
* [DOCS] Add link to on-prem install tutorial

* Move link to bottom of packages section

* Rearrange things according to suggestions

* Add another link on the 'Install Elasticsearch with RPM' page
2024-02-05 10:06:41 -05:00
Yang Wang 931f2c48c9
[Docs] Fix a doc bug for Flush API's force parameter (#105112)
The force parameter defaults to false instead of true.
2024-02-05 21:06:09 +11:00
David Turner 6a40c04cc1
More guidance in balance settings docs (#105119)
Today the docs on balancing settings describe what the settings all do
but offer little guidance about how to configure them. This commit adds
some extra detail to avoid some common misunderstandings and reorders
the docs a little so that more commonly-adjusted settings are mentioned
earlier.
2024-02-05 05:04:24 -05:00
Felix Barnsteiner f642b8a3aa
Add setting to ignore dynamic fields when field limit is reached (#96235)
Adds a new `index.mapping.total_fields.ignore_dynamic_beyond_limit`
index setting.

When set to `true`, new fields are added to the mapping as long as the
field limit (`index.mapping.total_fields.limit`) is not exceeded. Fields
that would exceed the limit are not added to the mapping, similar to
`dynamic: false`.  Ignored fields are added to the `_ignored` metadata
field.

Relates to https://github.com/elastic/elasticsearch/issues/89911

To make this easier to review, this is split into the following PRs: -
[x] https://github.com/elastic/elasticsearch/pull/102915 - [x]
https://github.com/elastic/elasticsearch/pull/102936 - [x]
https://github.com/elastic/elasticsearch/pull/104769

Related but not a prerequisite: - [ ]
https://github.com/elastic/elasticsearch/pull/102885
2024-02-02 05:53:52 -05:00
Panagiotis Bailis 7ce8d76559
Making k and num_candidates optional for knn search (#101209) 2024-02-01 15:43:09 +02:00
Martijn van Groningen 81a49f1567
Restrict usage of certain aggregations when in sort order execution is required (#104665)
A number of aggregations that rely on deferred collection don't work
with time series index searcher and will produce incorrect result. These
aggregation usages should fail. The documentation has been updated to
describe these limitations.

In case of multi terms aggregation, the depth first collection is
forcefully used when time series aggregation is used. This behaviour is
inline with the terms aggregation.
2024-02-01 07:09:17 -05:00
Michael Peterson 06a25b60c9
Add keep_alive param to the async-search status endpoint (#104629) 2024-01-31 17:25:37 -05:00
Chenhui Wang fa97f08df1
[Connector API] Add job type filtering support for List connector sync jobs API (#104855) 2024-01-31 23:19:45 +08:00
David Kyle 2cbe23a189
[DOCS] Dense vector element type should be float for OpenAI (#104966) 2024-01-31 11:13:03 +00:00
Abdon Pijpelink 980bc500b0
[DOCS] Support for nested functions in ES|QL STATS...BY (#104788)
* Document nested expressions for stats

* More docs

* Apply suggestions from review

- count-distinct.asciidoc
  - Content restructured, moving the section about approximate counts to end of doc.

- count.asciidoc
  - Clarified that omitting the `expression` parameter in `COUNT` is equivalent to `COUNT(*)`, which counts the number of rows.

- percentile.asciidoc
  - Moved the note about `PERCENTILE` being approximate and non-deterministic to end of doc.

- stats.asciidoc
  - Clarified the `STATS` command
  -  Added a note indicating that individual `null` values are skipped during aggregation

* Comment out mentioning a buggy behavior

* Update sum with inline function example, update test file

* Fix typo

* Delete line

* Simplify wording

* Fix conflict fix typo

---------

Co-authored-by: Liam Thompson <leemthompo@gmail.com>
Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
2024-01-30 19:29:12 +01:00
Albert Zaharovits 111a69d15f
Support `match` for the Query API Key API (#104594)
This adds support for the `match` query type to the Query API key Information API.
Note that since string values associated to API Keys are mapped as `keywords`,
a `match` query with no analyzer parameter is effectively equivalent to a `term` query
for such fields (e.g. `name`, `username`, `realm_name`).

Relates: #101691
2024-01-30 19:09:08 +02:00
István Zoltán Szabó 79d6c3e70d
[DOCS] Adds get setting and update settings asciidoc files to security API index (#104916)
* [DOCS] Adds get setting and update settings asciidoc files to security API index.

* [DOCS] Fixes references in docs.
2024-01-30 15:39:34 +01:00
Benjamin Trent 332dd8c751
indicating fix for 8.12.1 for int8_hnsw (#104912) 2024-01-30 09:06:22 -05:00
Johannes Fredén 666774a865
Add documentation for Query User API (#104255)
* Add documentation for Query User API

Co-authored-by: Nikolaj Volgushev <n1v0lg@users.noreply.github.com>
2024-01-30 11:27:24 +01:00
Craig Taverner b0f978f41e
Support points as input types to the TO_GEOSHAPE and TO_CARTESIANSHAPE functions (#104799)
* Support points as input types to TO_GEOSHAPE and TO_CARTESIAN_SHAPE

* Update docs for TO_GEOSHAPE and TO_GEOPOINT
2024-01-29 15:26:40 +01:00
Lorenzo Dematté 0e328dbfc8
DesiredNode: deprecate `node_version` field and make it optional (unused) in current parser (#104209)
Deprecated node_version field, made it optional(unused) in new parser
Added deprecation warning handler for mixed cluster
Split tests for old vs. current format
2024-01-29 14:09:45 +01:00
Abdon Pijpelink ef8c1e3ef0
[DOCS] Add DATE_DIFF function (#104794) 2024-01-29 09:51:46 +01:00
David Turner 88e497069a
Allocation awareness allocates some replicas (#104800)
The docs for forced awareness indicate that no replicas will be assigned
until all zones are available, which is definitely undesirable and also
not the actual behaviour. This commit fixes the wording to match what
really happens.

Closes #104777
2024-01-29 08:13:06 +00:00
Niels Bauman 0381954738
Add default rollover conditions to ILM explain API response (#104721)
The ILM `_explain` API displays the user-configured rollover action with the user-defined rollover conditions. However, the implicit conditions were not visible anywhere (except in the documentation and some debug-level logging).
2024-01-26 17:03:08 +01:00
Niels Bauman 8e28ca7e61
[DOCS] Add `?human` query param in ILM explain API docs (#104791)
The ILM `_explain` API example responses included human-readable (time) fields, but the example URL didn't actually return those human-readable fields (only the raw fields).
2024-01-26 14:42:22 +01:00