Commit Graph

9060 Commits

Author SHA1 Message Date
Ignacio Vera 2c98de99f6
Add documentation for _index property in mvt response (#78019)
Document that we are including a _index property for each hit in _mvt response.
2021-09-21 07:13:09 +02:00
James Rodewig 91fabb3b72 [DOCS] Add anchor to fix broken docs build 2021-09-20 14:01:47 -04:00
James Rodewig 2fc3d40a13
[DOCS] Convert 'Restore a snapshot' to tutorial (#76929)
Updates the 'Restore a snapshot' guide to be more tutorial-focused.
Adds a tutorial for restoring an entire cluster.

Closes #72497.
2021-09-20 13:17:24 -04:00
James Rodewig f3f11ab365
[DOCS] Add breaking change for `moving_avg` (#78018)
Documents the removal of the `moving_avg` aggregation in the 8.0 breaking changes.

Relates to #29594.
2021-09-20 13:16:11 -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
AndyHunt66 a5030ef407
[DOCS] Fix typo for `script.painless.regex.enabled` setting value (#77853)
The value is `limited`, not `limit`.
2021-09-16 13:59:58 -04:00
James Rodewig 5ccb1b4c62
[DOCS] Fix ESS install lead-in (#77887)
Replaces the hard-coded ESS lead-in with the docs attribute.

Previously, this copy omitted Microsoft Azure. This ensures these docs are better maintained.
2021-09-16 12:04:04 -04:00
Jake Landis ea74d34b7e
8.0.0-alpha2 release notes (#77821)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-15 19:40:46 -05:00
James Rodewig 3a23dd919c
[DOCS] Fix deprecation version for cluster recovery breaking change (#77787) 2021-09-15 10:35:26 -04:00
James Rodewig f57695ad15
[DOCS] Add placeholder for 8.0.0-alpha2 release notes (#77782) 2021-09-15 10:13:13 -04:00
Armin Braun 2544d913cf
Implement from_sort_value Parameter in Get Snapshots API (#77618)
Add `from_sort_value` parameter to allow for filtering snapshots by comparing to concrete sort column
values similar to the existing after parameter`.
2021-09-15 13:37:22 +02:00
David Turner f2a5706d22
Add docs on searchable snaps costs (#77607)
* Add docs on searchable snaps costs

Adds a note on why searchable snapshots is cheaper, including warnings
that it might be more expensive too.

* Split into sections

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

* data -> the shard contents

* More wording tweaks

* Apply suggestions from code review

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

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-15 03:27:52 -04:00
James Rodewig 201a328d0c
[DOCS] Remove shrink snippet from 'Size your shards' (#77593)
The current shrink API snippet doesn't show you how to remove replicas or reduce primary shards.

Rather than duplicate those instructions from the shrink API docs, this removes the snippet. A link to the shrink API and shrink ILM action docs is already provided.

It also updates a delete index API snippet to avoid wildcards. Wildcard expansion for the delete index API is disabled by default in 8.0.
2021-09-14 08:59:41 -04: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
István Zoltán Szabó db239e2b50
[DOCS] Adds update datafeeds API changes to the migration guide. (#77689) 2021-09-14 13:55:42 +02:00
James Rodewig 88fcb67839
[DOCS] Update ES intro for stretched clusters (#77651)
PR #77360 clarifies that a cluster's nodes don't need to be in the same data
center. This adds a similar clarification to the ES introduction docs.

Co-authored-by: David Turner <david.turner@elastic.co>
2021-09-13 16:50:08 -04:00
Nik Everett ed522ba26b
Disable bwc tests before backporting #77633 (#77639)
We make wire changes in #77633 so we need to disable the backwards
compatibility tests in master before merging the wire changes. We'll
re-enable them after the backport is merged.
2021-09-13 14:58:27 -04:00
David Turner c1a199ffda
Fix URL repo docs for searchable snapshots (#77624)
Today we document that you can use URL repositories with searchable
snapshots, but in fact it only works for HTTP(S) repositories. This
commit adjusts the docs to clarify.

Relates #69521
2021-09-13 15:53:51 +01:00
Nik Everett c2c0165fd2
Profile the fetch phase (#77064)
This adds profiling to the fetch phase so we can tell when fetching is
slower than we'd like and we can tell which portion of the fetch is
slow. The output includes which stored fields were loaded, how long it
took to load stored fields, which fetch sub-phases were run, and how
long those fetch sub-phases took.

Closes #75892

* Skip bwc

* Don't compare fetch profiles

* Use passed one

* no npe

* Do last rename

* Move method down

* serialization tests

* Fix sneaky serialization

* Test for sneaky bug

* license header

* Document

* Fix test

* newline

* Restore assertion

* unit test merging

* Handle inner hits

* Fixup

* Revert unneeded

* Revert inner hits profiling

* Fix names

* Fixup names

* Move results building

* Drop loaded_nested

* Checkstyle

* Fixup more

* Finish writeable cleanup

Add unit tests for merge

* Remove null checking builder

* Fix wire mistake

How did this pass before?!

* Rename

* Remove funny builder

* Remove name munging
2021-09-13 10:00:36 -04:00
James Rodewig 3f71a979c1
[DOCS] Fix impact sentences for removed system properties (#77601)
Several sentences in the 8.0 breaking changes reference setting
system properties in `elasticsearch.yml`, which is not supported. This corrects
those sentences.

It also fixes a sentence that references the `http.content_type.required`
setting as a system property.
2021-09-13 09:06:59 -04:00
Johan Nilsson Hansen 553e8dcb07
Create a sha-256 hash of the shard request cache key (#74877)
We currently use the plaintext body of a shard request as the key to the 
request cache.  This has the disadvantage that very large requests can
quickly fill up the cache due to the size of their keys.  With this commit, 
we instead use a sha-256 hash of the shard request as the cache key, 
which will use a constant (and much smaller) number of bytes.
2021-09-13 08:55:59 +01:00
James Rodewig cd95a2aefb
[DOCS] Re-add `KEYSTORE_PASSWORD` example to Docker install docs (#77588)
PR #77155 updated the keystore instructions for Docker. However, it removed an
example that included the `KEYSTORE_PASSWORD` env variable.

This replaces a docker compose example with the original example from PR #51123.
2021-09-10 17:12:18 -04:00
Dan Hermann 09004d30dc
[DOCS] ECS support for the grok processor (#77059) 2021-09-10 13:10:28 -05: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
James Rodewig de59fd2b43
[DOCS] Include index in range agg snippets (#77290) (#77568)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>

Co-authored-by: xiaozhiliaoo(小知了) <772654204@qq.com>
2021-09-10 12:36:05 -04:00
Lisa Cawley 1575d34822
[DOCS] Fix formatting (#77567)
This PR fixes a missing backtick.
2021-09-10 09:33:32 -07:00
James Rodewig 434843e66c [DOCS] Fix typo 2021-09-10 10:56:37 -04:00
James Rodewig 63a9a3bddb [DOCS] Remove extraneous key from docker compose example 2021-09-10 10:45:25 -04:00
Stef Nestor 5bc291717b
[DOCS] Fix keystore creation instructions for Docker (#77155)
* [DOC] Update Persist Keystore via Docker

From feedback from ES Devs summarized in [^1], I believe this needs to reflect a directory mount rather than file mount to not error. Also adding in the two common mounting errors, but not sure if this is the right place for them.

[^1] https://discuss.elastic.co/t/persist-elasticsearch-kibana-keystores-with-docker/283099

* feedback

* Reorganize

* reword

* fix formatting

* address review feedback

* remove extra whitespace

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-10 10:42:10 -04:00
Stef Nestor 95a8c80f3d
[DOCS] Add max open shards error to 'Size your shards' (#77287)
* [+DOC] ERROR: maximum shards open

Appending common error into our Shard sizing docs along w/extra resources commonly viewed from [this Elastic Discuss](https://discuss.elastic.co/t/how-to-fix-hitting-maximum-shards-open-error/200502/2). Top 4 viewed error last 30d on Elastic Discuss.

Kindly assist
- fixing resource links
- I'm debating including [the cluster setting you can temporarily override](https://www.elastic.co/guide/en/elasticsearch/reference/7.14/modules-cluster.html#cluster-shard-limit), but have left it off so far. Would love your thoughts!

* reorg + edits

* review feedback

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-10 09:41:30 -04:00
Armin Braun f1a4551e93
Implement Exclude Patterns for Snapshot- and Repository Names in Get Snapshots API (#77308)
It's in the title. Adds support for exclude patterns combined with wildcard requests
similar to what we support for index names.
2021-09-10 15:00:44 +02:00
Yulia Čech 5db3d9fd40
[DOCS] Updated ILM policies table screenshot (#77240) 2021-09-10 10:17:53 +02:00
Ryan Ernst 79d91ed9d3
Fail index creation using custom data path (#76792)
Custom per-index data paths were deprecated in 7.14. This commit blocks
creation of indices in 8.0 from configuring custom data paths.

relates #73168
2021-09-09 20:38:30 -07:00
David Turner 1fb1ad24a2
Add nuance around stretched clusters (#77360)
Today the multi-zone-cluster design docs say to keep all the nodes in a
single datacenter. This doesn't really reflect what we do in practice:
each zone in AWS/GCP/Azure/etc is a separate datacenter with decent
connectivity to the other zones in the same region. This commit adjusts
the docs to allow for this.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-09 20:10:57 +01: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
Benjamin Trent 281ec58b8d
[ML] add new default char filter `first_line_with_letters` for machine learning categorization (#77457)
The char filter replaces the previous default of `first_non_blank_line`.

`first_non_blank_line` worked well to figure out what line had characters at all, but log lines 
like the following were handled poorly:
```
--------------------------------------------------------------------------------

Alias 'foo' already exists and this prevents setting up ILM for logs

--------------------------------------------------------------------------------
```
When combined with the `ml_standard` tokenizer, the first line was used:
```
--------------------------------------------------------------------------------
```
This has no valid tokens for our standard tokenizer. Consequently, no tokens were found by `ml_standard` tokenizer.


The new filter, `first_line_with_letters`, returns the first line with any letter character (e.g. `Character#isLetter` returns true).

Given the previously poorly handled log, when combining with our `ml_standard` tokenizer, we get the following, more appropriate, tokens:

```
"tokens" : ["Alias", "foo", "already", "exists", "and", "this", "prevents", "setting", "up", "ILM", "for", "logs"]
```
2021-09-09 10:09:57 -04:00
Przemyslaw Gomulka 0d3cebe812
Change default deprecation logger level to CRITICAL (#77030)
This commit changes default deprecation logger level to CRITICAL, where default means deprecations emitted by DeprecationLogger#critical method.
It also introduces WARN deprecations which are emitted by DeprecationLogger#warn Those log lines emitted at WARN are meant to indicate that a functionality is deprecated but will not break at next major version.
relates #76754
2021-09-09 12:23:52 +02:00
Lee Hinman 35def9464c
Make the ILM `freeze` action a no-op (#77158)
* Make the ILM `freeze` action a no-op

This changes the ILM `freeze` action to not actually freeze the index, instead performing no
operation.

Relates to #70192

* zoop -> noop in documentation anchor

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-09-08 16:05:46 -04:00
Lisa Cawley b5a32678e7
[DOCS] Fixes admonition formatting (#77393) 2021-09-08 11:20:43 -07:00
James Rodewig e729c3f543
[DOCS] Clarify geoshape orientation docs (#75888)
Adds additional information about how Elasticsearch uses polygon orientation. Elasticsearch only uses a polygon's orientation to determine if it crosses the international dateline. If so, Elasticsearch splits the polygon at the dateline.

Closes #74891
2021-09-08 11:10:03 -04:00
Benjamin Trent a68c6acdb3
[ML] adding new PUT trained model vocabulary endpoint (#77387)
This commit removes the ability to set the vocabulary location in the model config.
This opts instead for sane defaults to be set and used. Wrapping this up in an
API.

The index is now always the internally managed .ml-inference-native index
and the document ID is always <model_id>_vocabulary

This API only works for pytorch/nlp type models.
2021-09-08 10:21:45 -04:00
Przemyslaw Gomulka 9d3b39ccb7
[doc] Remove external herokuapp website link (#77405)
The website is no longer live and is external to elastic domain. It was used as help for testing migration
2021-09-08 14:10:08 +02:00
István Zoltán Szabó 81851684d1
[DOCS] Fixes description of index_total property for GET Transforms stats API docs. (#77354) 2021-09-08 08:53:15 +02:00
David Turner 1045abe71f
Limit count of HTTP channels with tracked stats (#77303)
Today we expire the client stats for HTTP channels 5 minutes after they
close. It's possible to open a very large number of HTTP channels in 5
minutes, possibly inadvertently, and the stats for those channels can be
overwhelming.

This commit introduces a limit on the number of channels tracked by each
node which applies in addition to the age limit, and makes these limits
configurable via static settings. It drops the pruning of old stats when
starting to track a new channel and instead uses a queue to expire the
oldest stats when each channel closes if necessary to respect the count
limit; it only performs age-based expiry when retrieving the stats,
since the count limit now bounds the memory needed. Finally, it
tightents up some missing synchronization and makes sure that we expose
only immutable objects to the stats subsystem.
2021-09-08 07:25:57 +01:00
Benjamin Trent 708491d0d3
[ML] add allocation state reason and support for partial model allocations (#76925)
Previously, if a model failed to be allocated on any node, the deployment failed.

This commit allows for an allocation to be partially_started and indicates its
current state via a new state value in the deployment stats API.

Additionally, when starting a deployment, the user may specify to wait_for
starting, partially_started, started and the API will block (as long as timeout doesn't expire) until that state is reached.
2021-09-07 15:23:13 -04:00
Armin Braun 7508720fe5
Add Filtering by SLM Policy to Get Snapshots API (#77321)
It's in the title, add new `slm_policy_filter` param as a filter to the get snapshots API.
2021-09-07 18:24:09 +02: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 adcc05c798 [DOCS] Add anchor text to field alias redirect 2021-09-07 10:10:52 -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
Benjamin Trent de49ff22a4
[ML] creating new PUT model definition part API (#76987)
This commit simplifies the interactions for uploading chunked model definitions and model vocabulary.
2021-09-07 08:22:52 -04:00