Commit graph

657 commits

Author SHA1 Message Date
David Kilfoyle
2a44a8982f
[DOCS] Remove feature flag from TSDS docs (#89673)
* Docs: Remove feature flag and add preview label to TSDS docs

* Fix technical preview tag
2022-08-29 10:33:55 -04:00
Joe Gallo
3bde177fea
Rollover min_* conditions docs and highlight (#89434) 2022-08-17 15:24:18 -04:00
Julie Tibshirani
abd561a277
Support kNN vectors in disk usage action (#88785)
This change adds support for kNN vector fields to the `_disk_usage` API. The
strategy:
* Iterate the vector values (using the same strategy as for doc values) to
estimate the vector data size
* Run some random vector searches to estimate the vector index size 

Co-authored-by: Yannick Welsch <yannick@welsch.lu>

Closes #84801
2022-07-26 07:57:47 -07:00
David Kilfoyle
40e9f3097c
[DOCS] Add TSDS docs, take two (#87703)
* Revert "Revert "[DOCS] Add TSDS docs (#86905)" (#87702)"

This reverts commit 0c86d7b9b2.

* First fix to tests

* Add data_stream object to index template

* small rewording

* Add enable data stream object in gradle example setup

* Add bullet about data stream must be enabled in template
2022-06-16 12:44:10 -04:00
David Kilfoyle
0c86d7b9b2
Revert "[DOCS] Add TSDS docs (#86905)" (#87702)
Reverts elastic/elasticsearch#86905
2022-06-15 13:32:12 -04:00
David Kilfoyle
d57f4ac2c6
[DOCS] Add TSDS docs (#86905)
* [DOCS] Add TSDB docs

* Update docs/build.gradle

Co-authored-by: Adam Locke <adam.locke@elastic.co>

* Address Nik's comments, part 1

* Address Nik's comments, part deux

* Reword write index

* Add feature flags

* Wrap one more section in feature flag

* Small fixes

* set index.routing_path to optional

* Update storage reduction value

* Update create index template code example

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-06-15 12:22:07 -04:00
Ryan Ernst
dd686ebe6d
Fix expand_wildcards default in docs (#87086)
The get settings api has accepts the expand_wildcards option. The docs
state the default value is `all`, but it is actually now `open` (which
does not include hidden or closed indices by default). This commit
changes the docs to match the existing behavior.
2022-05-24 13:11:35 -07:00
Adam Locke
53b55a711b
Rectified the "Add lifecycle policy" hyperlink. (#86717) (#86735)
"Add" was out of the hyperlink context which I have fixed it.

Earlier line 71 was like : * *Add*  <<set-up-lifecycle-policy,*lifecycle policy*>>

After rectifying line 71 is like : * <<set-up-lifecycle-policy,*Add lifecycle policy*>>

(cherry picked from commit 3b8d51c696)

Co-authored-by: Tapomoy Bhowmik <99604828+TapomoyBhowmik@users.noreply.github.com>
2022-05-12 10:22:40 -04:00
Francisco Fernández Castaño
ce9819fa6c
Keep track of desired nodes cluster membership (#84165)
This commit adds tracking for desired nodes cluster membership.

When desired nodes are updated they are matched against the current
cluster members. Additionally when a node joins the cluster the
desired nodes cluster membership is updated.
2022-05-03 14:06:48 +02:00
William Brafford
03985f1953
Provide 'system' attribute when resolving system indices (#85042)
* Resolve indices api: add 'system' attribute
* Update docs/changelog/85042.yaml
* Remove magic strings for attribute values
* Update API docs to provide possible resolved index attributes
2022-03-22 11:40:42 -04:00
Dan Roscigno
37beabcb2e
reorder and merge data management and ILM doc pages (#84679)
* reorder and merge data management and ILM doc pages

* update abbreviated titles
2022-03-07 18:33:28 -05:00
Abele Mălan
9ecb96fcf3
Fix some typos in plugins & reference docs (#84667)
This pull request removes a few instances of duplicate words or
punctuation and erroneous spelling from the docs.
2022-03-07 12:29:58 -05:00
Joe Gallo
119fbcf64e
[DOCS] Fix shrink index API prereqs (#84197) 2022-02-21 16:17:49 -05:00
weizijun
79132ed57b
Add rollover add max_primary_shard_docs condition (#80981)
Add a new rollover condition with the name `max_primary_shard_docs`.
Triggers rollover when the largest primary shard in the index reaches a certain number of documents.
2022-02-08 14:04:04 +01:00
Dan Hermann
7987507014
[DOCS] 'features' flag added in #83083 (#83452) 2022-02-07 08:26:06 -06:00
Martijn van Groningen
e6326078a0
Simulate template api to include settings from IndexSettingProvider (#82609)
The simulate template api should include the settings that registered IndexSettingProvider generate.
Currently, these settings are not included in the simulate template api response,
but are only used to create a dummy IndexService instance to validate aliases.
2022-01-17 10:22:22 +01:00
James Rodewig
5354e50316
[DOCS] Fix anchor for 'Shrink an index' section (#81665)
Reverts an anchor change from #46711.

Previous versions of the docs use the `_shrinking_an_index` anchor for this
section. Preserving that anchor will prevent doc build breaks in future releases.
2021-12-13 12:24:31 -05:00
mushaoqiong
d467aae67e
Force merge rest api support wait_for_completion (#80463)
Force merge action is a very costly action. It may take several hours to run for big indices. But current force merge rest api do not support wait_for_completion parameter.
This adds support for the wait_for_completion parameter.
2021-12-13 10:32:03 +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
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
Yannick Welsch
064936e790
Add field usage support for vectors (#80608)
Add field usage tracking support for the new vectors functionality.
2021-11-15 08:44:02 +01:00
Dan Hermann
0d21b032b6
[DOCS] Custom routing for data streams 2021-11-10 07:11:50 -06:00
James Rodewig
f56a0f4b66
[DOCS] Remove testenv annotations from doc snippet tests (#80023)
Removes `testenv` annotations and related code. These annotations originally let you skip x-pack snippet tests in the docs. However, that's no longer possible.

Relates to #79309, #31619
2021-11-05 18:38:50 -04:00
Dan Hermann
4a36d5cd79
Remove endpoint for freezing indices (#78918) 2021-10-26 06:37:56 -05:00
Stef Nestor
338205eff6
Update question: index recovery (#78881)
* Update question: index recovery

Hello, team! I'm trying to understand possible recovery stages for myself per [this doc > `STAGE`](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-recovery.html#index-recovery-api-response-body) as compared to [this code](https://github.com/elastic/elasticsearch/blob/main/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryState.java#L41-L91) ([part2](https://github.com/elastic/elasticsearch/blob/main/server/src/main/java/org/elasticsearch/indices/recovery/RecoveryState.java#L187-L223)). However, I'm not finding the expected reference to `STAGE:start` & instead am finding reference to `STAGE:verify_index`. I may be missing a code-to-human translation somewhere. Will you double check for me? 🙏🏼

* Update verify_index description and change ordering

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2021-10-14 11:03:53 -04:00
David Turner
d2bb6ebb69
Get-templates APIs don't support lists (#78989)
We document that `GET /_index_template/...` accepts a comma-separated
list of template names but in fact today this API accepts only a single
name or pattern. Likewise `GET /_cat/templates/...` (at least it didn't
until #78829 but that's not released yet). This commit fixes the docs to
indicate these APIs accept only a single template name and also adds
some extra validation to reject requests containing a `,` since such a
request cannot match any actual templates.

It also adjusts `GET /_cat/templates` to use the filtering built into
`TransportGetComposableIndexTemplateAction` rather than retrieving all
templates and then filtering them on the coordinating node.
2021-10-13 12:13:06 +01:00
xiaoping
7e08c6b98a
Data stream support read and write with custom routing and partition size (#74394) 2021-10-11 07:14:15 -05:00
Bo Andersen
609a7321b2
[DOCS] Added missing backtick for code snippet (#78241) 2021-10-05 14:10:08 -04:00
James Rodewig
a56065dc9f [DOCS] Fix rollover API response body heading 2021-10-05 09:16:32 -04:00
Alan Woodward
2de2bef4de
Remove indices_segments 'verbose' parameter (#78451)
The 'verbose' option to /_segments returns memory information
for each segment. However, lucene 9 has stopped tracking this memory
information as it is largely held off-heap and so is no longer significant.

This commit deprecates the 'verbose' parameter and makes it a no-op.

Fixes #75955
2021-10-05 09:17:16 +01:00
Yannick Welsch
3dac76c190
Disk usage API does not support timeout parameters (#78503)
Fixes the documentation that the disk usage API is not supporting timeout parameters.

Closes #78356
2021-09-30 16:08:00 +02:00
Adam Locke
6940673e8a
[DOCS] Update remote cluster docs (#77043)
* [DOCS] Update remote cluster docs

* Add files, rename files, write new stuff

* Plethora of changes

* Add test and update snippets

* Redirects, moved files, and test updates

* Moved file to x-pack for tests

* Remove older CCS page and add redirects

* Cleanup, link updates, and some rewrites

* Update image

* Incorporating user feedback and rewriting much of the remote clusters page

* More changes from review feedback

* Numerous updates, including request examples for CCS and Kibana

* More changes from review feedback

* Minor clarifications on security for remote clusters

* Incorporate review feedback

Co-authored-by: Yang Wang <ywangd@gmail.com>

* Some review feedback and some editorial changes

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: Yang Wang <ywangd@gmail.com>
2021-09-22 16:02:33 -04:00
James Rodewig
a321313778
[DOCS] Note exclusive force merge API options (#78006)
You can't specify `max_num_segments` and `max_num_segments` in the same request.

Relates to PR #44761.
2021-09-21 09:20:50 -04:00
edh-oss
62a471aefe
Update JSON parser and snippets (#77983)
Related to issue  #77823

This does the following:

- Updates several asciidoc files that contained code snippets with
  invalid JSON, most involving unnecessary trailing commas.

- Makes the switch from the Groovy JSON parser to the Jackson parser,
  pursuant to the general goal of eliminating Groovy dependence.

- Makes testing of JSON validity at build time more strict.

Note that this update still allows backslash escaping for any
character. Currently that matters because of the file
"docs/reference/ml/anomaly-detection/apis/get-datafeed-stats.asciidoc",
specifically this part:

    "attributes" : {
      "ml.machine_memory" :
        "$body.datafeeds.0.node.attributes.ml\.machine_memory",
      "ml.max_open_jobs" : "512"
    }

It's not clear to me what change, if any, is appropriate there. So,
I've left in the escaped period and configured the parser to ignore
it for the time being.
2021-09-20 11:08:26 +01:00
Jim Ferenczi
aacd761838
Honour max segment size when setting only_expunge_deletes on force merge (#77478)
This commit changes the es merge policy to apply the maximum segment size
on force merges that only expunge deletes (forceMergeDeletes).
This option is useful for read-write use cases that wants to reclaim deleted docs
more aggressively than the `index.merge.policy.deletes_pct_allowed`.

Closes #61764
Relates #77270
2021-09-14 14:31:13 +02:00
Philipp Krenn
1c13c662d5
[DOCS] Don't explain "refresh" with "it refreshes" in the docs (#77530)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-10 13:38:01 -04:00
Stef Nestor
3480a097a9
[DOCS] Deleting an index doesn't delete Kibana components (#77286)
Changes:
* Notes the delete index API can delete multiple indices at once.
* Notes deleting an index deletes its docs, shards, and metadata but does not delete any related Kibana components.
* Relocates a note about deleting a data stream's write index to the description.
* Corrects the default `expand_wildcards` value.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-09 14:27:41 -04:00
James Rodewig
f170f6c000
[DOCS] Fix default for is_write_index (#77006) (#77362)
This updates the default for the `is_write_index` parameter of the aliases API and create alias API.
The default behavior for `is_write_index` can vary based on:

1. Whether the alias is used for indices or data streams.
2. If an index alias, whether the alias points to multiple indices.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>

Co-authored-by: 诗心客 <ishixinke@qq.com>
2021-09-07 11:34:53 -04:00
James Rodewig
cfae69717a
[DOCS] Update anchor and add redirect for aliases (#77349)
PRs #73062 and #73043 repurposed the `alias` anchor for a new guide for index
and data stream aliases. Previously, this anchor was used for our field alias
documentation.

Repurposing the anchor has caused continuity errors for users selecting
different versions of the ES docs. It could also cause confusion for users with
a `/current/` link to the `alias` page.

This updates the anchor for the alias guide and adds a redirect page to
disambiguate the `alias` anchor.

It also fixes a bread crumb issue for redirects following the 'Modifying your
Data' redirect page.

Closes #77034.
2021-09-07 09:42:42 -04:00
Francisco Fernández Castaño
2c132fe5f7
Keep track of data recovered from snapshots in RecoveryState (#76499)
Adds new field to recovery API to keep track of amount of data
recovered from snapshots.

The normal recovered_bytes field remains and is also increased for
recovery from snapshot but can go backwards in the unlikely case
that recovery from snapshot fails to download a file.

Relates #73496
2021-08-16 18:18:37 +02:00
James Rodewig
fc0ac1923d
[DOCS] Correct spelling for geo terms (#76028)
Changes:
* Use "geopoint" when not referring to the literal field type
* Use "geoshape" when not referring to the literal field type or query type
* Use "GeoJSON" consistently
2021-08-03 09:55:48 -04:00
Adrien Grand
d15445e0f3
Remove usage of RAM accounting of segments (#75674)
This is a pre-requisite for the upgrade to Lucene 9, which removes the ability to estimate RAM usage of segments.
2021-07-29 08:36:09 +02:00
James Rodewig
6078349106
[DOCS] Update index template API docs for data stream aliases (#75688)
With #73867, you can use component and index templates to add data stream
aliases.
2021-07-26 14:42:54 -04:00
Martijn van Groningen
3dde09a7b4
Add filter support to data stream aliases (#74784)
This allows specifying a query as filter on data stream alias,
which will then always be applied when searching via this alias.

Relates #66163
2021-07-20 11:21:27 +02:00
Yannick Welsch
db814f403b
Track Lucene field usage (#74227)
Adds a field usage API that reports shard-level statistics about which Lucene fields have been accessed, and which
parts of the Lucene data structures have been accessed.

Field usage statistics are automatically captured when queries are runnning on a cluster. A shard-level search request
that accesses a given field, even if multiple times during that request, is counted as a single use.
2021-07-14 13:21:11 +02:00
Liam MacPherson
ba227f99f0
[DOCS] Fix <index> param def for delete index API (#74674)
Clarifies that you cannot specify an alias in the delete index API. You _can_ delete indices with an alias.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-07-01 10:07:14 -04:00
Nhat Nguyen
c23cb99b71
Add index disk usage API (#74051)
This change adds a new API that supports analyzing the disk usage of 
each field of an index.
2021-06-30 11:50:01 -04:00
James Rodewig
ed1999e935
[DOCS] Update wildcard support for removing aliases (#74561)
You can now use a wildcard pattern to remove data stream and index
aliases in the same action/request.

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-06-28 08:53:45 -04:00
James Rodewig
2fe07014d9
[DOCS] Move ES glossary to Stack docs (#74579)
The ES glossary is now incorporated into the [Elastic glossary](https://www.elastic.co/guide/en/elastic-stack-glossary/current/terms.html).

Depends on https://github.com/elastic/stack-docs/pull/1722 and https://github.com/elastic/docs/pull/2141
2021-06-24 19:04:31 -04:00
Robin Clarke
7aaf209e47
[DOCS] Fix capitalization (#74470) 2021-06-23 12:02:57 -04:00