Commit graph

9899 commits

Author SHA1 Message Date
Julie Tibshirani
19eed47159
Improve kNN error message when index is disabled (#81561)
In order to perform a kNN search on a `dense_vector` field, it must have
`index: true` in its mapping. This commit clarifies the error message. Before
the message was confusing, because the user likely didn't touch the `index`
parameter and might not even be aware of it.

It adds a note to the docs clarifying that when coming from 7.x, you must
explicitly update `index: true` and reindex the vectors.

Relates to #78473.
2021-12-08 16:20:35 -08:00
Joe Gallo
27186ceda7
_tier_preference docs tweaks (#81453) 2021-12-08 10:34:30 -05:00
James Rodewig
1519bb6ecb
[DOCS] Update snapshot defaults for system indices (#81226)
Updates the snapshot and restore docs for https://github.com/elastic/elasticsearch/pull/79670.

Closes https://github.com/elastic/elasticsearch/issues/81183
2021-12-08 10:15:14 -05:00
Nhat Nguyen
d0d91c690e
Handle partial search result with point in time (#81349)
Today, a search request with PIT would fail immediately if any 
associated indices or nodes are gone, which is inconsistent when
allow_partial_search_results is true.

Relates #81256
2021-12-08 10:04:38 -05:00
Leaf-Lin
9edfed81cb
[DOCS] Clarifying tiers order in rolling_upgrade (#79617)
* Update rolling_upgrade.asciidoc

adding node attributes comment in the upgrade order

* Update docs/reference/upgrade/rolling_upgrade.asciidoc

Co-authored-by: David Turner <david.turner@elastic.co>

* Update docs/reference/upgrade/rolling_upgrade.asciidoc

Co-authored-by: David Turner <david.turner@elastic.co>

* Apply suggestions from code review

adding retrieval of the tier list

* Update docs/reference/upgrade/rolling_upgrade.asciidoc

* format to 80 width wide

* Remove paragraph break

* Update rolling_upgrade.asciidoc

* Update rolling_upgrade.asciidoc

* Update docs/reference/upgrade/rolling_upgrade.asciidoc

Co-authored-by: David Turner <david.turner@elastic.co>

* Update docs/reference/upgrade/rolling_upgrade.asciidoc

Co-authored-by: David Turner <david.turner@elastic.co>

Co-authored-by: David Turner <david.turner@elastic.co>
2021-12-08 21:24:26 +11:00
Gordon Brown
50794a1b51
Mention dot-prefixed patterns in hidden index docs (#81464)
The hidden index docs did not mention that dot-prefixed patterns default
to matching hidden indices. This PR adds a note explaining the behavior
and why it's like that.
2021-12-07 19:02:01 -05:00
James Rodewig
dd1ed30731
[DOCS] Fix combined_fields query ref in multi_match query docs (#81456)
The current `multi_match` docs contain an erroneous reference to the `combined_fields` query. This updates the reference to reference the correct query.

Relates to https://github.com/elastic/elasticsearch/pull/76893
2021-12-07 16:47:44 -05:00
Tanguy Leroux
061d38ca5a
Mention prefixes of mounted index in ILM Searchable Snapshot action (#81421)
The searchable snapshot action mounts snapshots as indices 
with a different prefix depending of the phase. This commit
tries to mention them in the docs.
2021-12-07 15:35:53 +01:00
Joe Gallo
0db66b87aa
_tier_preference docs changes for 8.0 (#81389) 2021-12-06 19:40:47 -05:00
David Turner
9955b49fab
Add explicit warning not to touch repository contents (#81295)
Manipulating the contents of a snapshot repository is a very bad idea,
but it turns out we don't call this out in the docs anywhere. This
commit adds a warning about this.
2021-12-06 13:22:01 +00:00
Lisa Cawley
b18f5fd2c6
[DOCS] Fixes link to language identification example (#81347) 2021-12-03 17:21:04 -08:00
Salvatore Campagna
2b5ebba94a
[DOCS] Fix the weighed average documentation (#81307)
The documentations states that if the `weight` field is missing, and no
explicit missing configuration is provided, a default value of 1 is used.
This is incorrect and does not match the implementation of the weighted
average aggregator. In this specific case the document is skipped, instead.
2021-12-03 23:28:41 +01:00
Keith Massey
68a9eaa4dc
Adding discovery.zen.bwc_ping_timeout to the list of removed zen settings (#81310)
This commit adds the discovery.zen.bwc_ping_timeout setting our documentation about the
settings that have been removed in 8.0.
2021-12-03 16:16:48 -06:00
Lisa Cawley
429bdd9afc
[DOCS] Move trained model APIs out of dataframe analytics (#81315) 2021-12-03 09:21:09 -08:00
Lisa Cawley
4ed6e8ad3c
[DOCS] Adds missing timeout parameter to transform APIs (#81129) 2021-12-02 13:28:28 -08:00
James Rodewig
cf818edcde
[DOCS] Fix syntax error in bulk dynamic_templates docs (#81264) 2021-12-02 14:05:21 -05:00
James Rodewig
e999ad0061
[DOCS] Relocate 8.0 repositories.fs.compress breaking change (#81216)
The change removes a node-level setting. It was accidentally placed with REST API changes as part of https://github.com/elastic/elasticsearch/issues/79162. This moves the breaking change to the cluster and node setting changes section.
2021-12-01 09:53:10 -05:00
James Rodewig
ca8c9be016
[DOCS] Remove source query params from update/delete by query APIs (#81131)
Removes source-related query parameters from the update by query
and delete by query API documentation. These parameters don't return
source fields as part of the response.
2021-12-01 09:06:12 -05:00
David Kyle
aba14aacfa
[ML][DOCS] Add zero shot example and setting truncation at inference (#81003)
More examples for the _infer endpoint
2021-12-01 11:44:04 +00:00
Ignacio Vera
00aa197399
Fields API should return normalize geometries (#80649)
Fields API deliver now the normalize geometries instead of the plain geometries from source

Co-authored-by: James Rodewig <james.rodewig@elastic.co
2021-12-01 08:10:54 +01:00
James Rodewig
229d2d7a77
[DOCS] Add high-level guide for kNN search (#80857)
Adds a high-level guide for running an approximate or exact kNN search in Elasticsearch.

Relates to https://github.com/elastic/elasticsearch/issues/78473.
2021-11-30 14:17:39 -05:00
David Turner
7dd32fb027
Reduce verbosity-increase timeout to 3m (#81118)
Today we increase the verbosity of discovery failures after 5 minutes
without a master. Unfortunately 5 minutes is a common orchestration
timeout, so if discovery is broken then we see nodes being shut down
just before they start to emit useful logs. This commit reduces the
default timeout to 3 minutes to address that.
2021-11-30 09:52:39 +00:00
Martijn van Groningen
e20fe6d639
Add replicated field to get data stream api response. (#80988)
Internally we already kept track of whether a data stream is replicated by CCR.
It is part of the `DataStream` class. This just adds it to the xcontent serialization
of the get data stream api response class.

Relates to elastic/kibana#118899
2021-11-30 09:30:05 +01:00
Ioannis Kakavas
537f371f34
URL option for BaseRunAsSuperuserCommand (#81025)
Add a --url option for elasticsearch-reset-password and
elasticsearch-create-enrollment-token CLI Tools ( and any tools
that would extend BaseRunAsSuperuserCommand ).
The tools use CommandLineHttpClient internally, which tries its
best to deduce the URL of the local node based on the configuration
but there are certain cases where it either fails or returns an
unwanted result. Concretely:

- CommandLineHttpClient#getDefaultURL will always return a URL with
the port set to 9200, unless otherwise explicitly set in the
configuration. When running multiple nodes on the same host,
subsequent nodes get sequential port numbers after 9200 by default
and this means that the CLI tool will always connect the first of
n nodes in a given host. Since these tools depend on a file realm
local user, requests to other nodes would fail
- When an ES node binds and listens to many addresses, there can
be the case that not all of the IP addresses are added as SANs in
the certificate that is used for TLS on the HTTP layer.
CommandLineHttpClient#getDefaultURL will pick an address based on
a preference order but that address might not be in the SANs and
thus all requests to the node would fail due to failed hostname
verification.

Manually setting `--url` to an appropriate value allows users to
overcome these edge cases.
2021-11-29 23:49:27 +02:00
David Turner
ca65718923
Clarify unassigned.reason docs (#81017)
Today we indicate that the `unassigned.reason` field in various APIs
indicates the reason why a shard is unassigned. This isn't really true,
it tells you some information about the event that caused the shard to
_become_ unassigned (or which most recently changed its routing table
entry while remaining unassigned) but tells you almost nothing about why
the shard _is now_ unassigned and how to fix it. That's what the
allocation explain API is for. This commit clarifies this point in the
docs.

Closes #80892

Co-authored-by: James Rodewig <james.rodewig@elastic.co>
2021-11-29 18:47:01 +00:00
James Rodewig
4d19702221
[DOCS] Update xrefs for snapshot restore docs (#81023)
Changes:

* Removes a leading slash from the restore snapshot API's prerequisites.
* Updates several xrefs that point to redirected pages.
2021-11-29 11:52:02 -05:00
David Turner
54e0370b3e
Track histogram of transport handling times (#80581)
Adds to the transport node stats a record of the distribution of the
times for which a transport thread was handling a message, represented
as a histogram.

Closes #80428
2021-11-29 15:41:33 +00:00
Lisa Cawley
e5de9d8ad7
[DOCS] Add actual and typical values in ML alerting docs (#80571) 2021-11-25 10:06:52 -08:00
Lisa Cawley
8da1236bca
[DOCS] Clarify impact of force stop trained model deployment (#81026) 2021-11-25 09:08:46 -08:00
Lisa Cawley
8ab03d021c
[DOCS] Edits reset transforms API (#81027) 2021-11-25 08:40:50 -08:00
James Rodewig
2a30dfe4d2
[DOCS] Fix type response values for index recovery API (#81000)
We updated the `type` response values in https://github.com/elastic/elasticsearch/pull/19516. This updates the docs with the correct values.

Closes https://github.com/elastic/elasticsearch/issues/80264

Co-authored-by: David Turner <david.turner@elastic.co>
2021-11-24 14:34:25 -05:00
Lisa Cawley
d1af86cfdd
[DOCS] Fixes start and stop trained model deployment APIs (#80978) 2021-11-24 10:09:45 -08:00
Colin Ng
dd2424b79c
Fix typo (#80925) 2021-11-23 16:28:53 -05:00
James Rodewig
cbcd901096
[DOCS] Relocate index.mapping.dimension_fields.limit setting docs (#80964)
Moves `index.mapping.dimension_fields.limit` so that its co-located with
other mapping limit settings.
2021-11-23 14:51:28 -05:00
Adam Locke
b9ae8fdb13
[DOCS] Fix elasticsearch-reset-password typo (#80919) 2021-11-23 07:42:56 -05:00
Lisa Cawley
38cbd116c9
[DOCS] Fixes query parameters for get buckets API (#80643) 2021-11-22 11:34:43 -08:00
James Rodewig
cf30b54a58
[DOCS] Fix typo in gap_policy's default value for serial differencing aggregation (#80893) (#80912)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>

Co-authored-by: Simon Stücher <stchr@users.noreply.github.com>
2021-11-22 13:43:16 -05:00
Lisa Cawley
f3a69ae4b1
[DOCS] Adds missing query parameters to ML APIs (#80863) 2021-11-22 09:25:01 -08:00
Adam Locke
2d83013fe8
[DOCS] Update Docker commands with variables (#80885)
* [DOCS' Update Docker commands with variables

* Modify "VERSION" to lowercase

Co-authored-by: James Rodewig <james.rodewig@elastic.co>

* Remove errant + icons

Co-authored-by: James Rodewig <james.rodewig@elastic.co>
2021-11-19 16:16:09 -05:00
James Rodewig
58f32b361f
[DOCS] Update 8.0 breaking change for searchable snapshot shared cache (#80793)
You can no longer configure `xpack.searchable.snapshot.shared_cache.size` as a user setting in ESS on 7.13+ deployments. This PR removes the ESS icon from the related 8.0 breaking change for the setting.

It also clarifies the breaking change text to indicate that configuring the setting on non-frozen nodes will result in an error on startup.

Relates to https://github.com/elastic/elasticsearch/pull/80795
2021-11-19 11:25:55 -05:00
Artem Prigoda
f6caaee7b1
[DOCS] Remove deprecation of 408 status code on _cluster/health from 8.0.0 release notes (#80852)
It was reverted in #80821
2021-11-19 11:02:11 +01:00
Artem Prigoda
89bbac9216
Revert "Return 200 OK response code for a cluster health timeout (#78968)" (#80821)
* Revert "Return 200 OK response code for a cluster health timeout (#78968)"

This reverts commit a2c3daea

* Revert "Allow deprecation warning for the return_200_for_cluster_health_timeout parameter (#80178)"

This reverts commit 1c711e35fc.

* Revert "Drop pre-7.2.0 wire format in ClusterHealthRequest (#79551)"

This reverts commit b9fbe66ab0.

* Revert "Adjust the BWC version for the return200ForClusterHealthTimeout field (#79436)"

This reverts commit f60bda5685.

* Revert "Use query param instead of a system property for opting in for new cluster health response code (#79351)"

This reverts commit 8901a999

* Revert "Deprecate returning 408 for a server timeout on `_cluster/health` (#78180)"

This reverts commit f266eb32

* Drop pre-7.2.0 wire format in ClusterHealthRequest (#79551)

This reverts commit fa4d562c

* Revert "Disable BWC for #80821 (#80839)"

This reverts commit cb0e73e2fc.

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-11-18 19:55:16 +01:00
William Brafford
47c2cfa6ee
Add known issues for remaining system indices work (#80373)
* Add known issues for remaining system indices work

Co-authored-by: Adam Locke <adam.locke@elastic.co>
Co-authored-by: Fabio Busatto <52658645+bytebilly@users.noreply.github.com>
2021-11-18 12:59:09 -05:00
Lisa Cawley
fffac5bd08
[DOCS] Adds missing query parameters in get influencer and get snapshot APIs (#80801) 2021-11-18 08:24:24 -08:00
Adam Locke
247d124666
[DOCS] Update ES quick start for security ON by default (#80735)
* [DOCS] Update ES quick start for security ON by default

* Remove code.asciidoc, which is part of the overall doc build now

* Update node names for cleanup

* Add note with links to tools

* Add --net elastic network

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-11-17 17:48:07 -05:00
Adam Locke
a72a26696c
[DOCS] Update Windows .zip install instructions for security ON by default (#80552)
* [DOCS] Update Windows .zip install instructions for security ON by default

* Rework instructions for running as a service on Windows

* Update wording and add variable for back/forward slashes

* Relocating enroll nodes steps and introducing variables

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-11-17 17:35:09 -05:00
Lisa Cawley
d6f48dc5bd
[DOCS] Add query parameters to update datafeed API (#80777) 2021-11-17 07:40:31 -08:00
James Rodewig
2c8840ee95
[DOCS] Fix subject-verb agreement typo (#80774) (#80783)
Co-authored-by: Chris Keele <christopher.l.keele@gmail.com>
2021-11-16 18:35:35 -05:00
James Rodewig
2f4143267e
[DOCS] Un-deprecate transient cluster settings (#80766) (#80780)
#80556 reverted the deprecation of transient cluster settings. This replaces deprecation language in the docs with a warning/recommendation to avoid transient settings.

Closes #80557
# Conflicts:
#	docs/reference/migration/migrate_7_16.asciidoc
2021-11-16 16:00:13 -05:00
James Rodewig
a48060313a
[DOCS] Remove soft limit for snapshot repositories (#80745)
As part of #74350, snapshot repositories no longer have a 200 snapshot soft limit. This removes docs related to the limit.
2021-11-16 12:24:18 -05:00