Commit Graph

10903 Commits

Author SHA1 Message Date
Adam Locke bf60ce68c6
[DOCS] Update Docker Compose installation with simplified configuration (#81835)
* [DOCS] Update Docker Compose installation with simplified configuration

* Change heading to fix link issue
2021-12-16 19:42:41 -05:00
James Baiera 159b1ce20b
Adding default templates for Metricbeat ECS data (#81744)
This PR adds four new templates that are automatically installed from the Monitoring plugin.

In 8.x, Metricbeat will be writing its data in ECS compliant format, even when used with xpack 
mode enabled (stack monitoring). In order to continue to support the legacy data format, new 
mappings have been created with the new ECS fields for indexing data, and alias fields for the 
legacy format which point to the corresponding ECS fields.

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: Mat Schaffer <mat@schaffer.me>
2021-12-16 16:14:18 -05:00
Adam Locke dd47e68ce1
[DOCS] Enroll additional nodes on Docker (#81787)
* [DOCS] Enroll additional nodes on Docker

* Remove -p option for second node

Co-authored-by: Fabio Busatto <52658645+bytebilly@users.noreply.github.com>

* Rename nodes to align with other Docker docs

* Add elastic network to first node docker run command

* Remove hyphen from node names

Co-authored-by: Fabio Busatto <52658645+bytebilly@users.noreply.github.com>
2021-12-16 12:42:16 -05:00
Leaf-Lin 82592c4268
[DOCS] Update remote cluster version compatibility table for 8.x (#81239)
Updates the remote clusters version compatibility table to include 7.17 and 8.x versions.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-12-16 11:16:24 -05:00
James Rodewig dc009b746f
[DOCS] Update scripted upsert example (#81481)
Updates the scripted upsert example to use a script `source` rather than
a stored script `id`. This makes the example more copy/paste-able.
2021-12-16 11:13:43 -05:00
David Turner b1db7b67c6
Permit metadata updates on flood-stage-blocked indices (#81781)
If a node reaches the flood stage watermark then we automatically apply
the `read_only_allow_delete` block to all its indices to prevent any
further growth in data. Users are expected to fix the disk space issue
by adding more space or deleting indices. However some users may prefer
to fix the disk space issues by modifying some of the index settings,
perhaps removing replicas or adjusting an allocation filter to move
shards onto nodes with more space. Today this isn't possible since the
`read_only_allow_delete` block also applies to metadata writes. Blocking
metadata writes isn't necessary to protect against further increases in
disk usage, and makes it harder for users to resolve the disk space
issue, so this commit removes the `METADATA_WRITE` level from the block
definition.
2021-12-16 12:19:41 +00:00
William Chaparro c8e8104f66
[DOCS] Remove experimental language from HDR Histo percentiles/ranks (#81773)
per issue 60780, decision from team to remove experimental language from HDR Histogram percentiles and ranks. Feature has been in production for quite some time.
closes #60780
2021-12-15 14:35:08 -05:00
James Rodewig 04318961b9
[DOCS] Clarify supported parameters for `terms` value source (#81775)
The composite aggregation's `terms` value source doesn't support the same set of
parameters as the `terms` aggregation.

Closes #81431.
2021-12-15 14:32:16 -05:00
Adam Locke 1bd0561a91
[DOCS] Add docs for verifying CA fingerprint (#81279)
* [DOCS] Add docs for verifying CA fingerprint

* Update openssl command and explanatory text

* Explain copying CA cert if fingerprint validation isn't possible

* Incorporate new section into the main security config page

* Clarify how cert is used

Co-authored-by: Ioannis Kakavas <ikakavas@protonmail.com>

* Split into two, separate sections

* Rename file and update text based on feedback

* Update ref to use new filename

* Remove extra word

Co-authored-by: Ioannis Kakavas <ikakavas@protonmail.com>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-12-15 14:08:20 -05:00
Artem Prigoda 763d6d510f
Use Java 15 text blocks for JSON and multiline strings (#80751)
The ES code base is quite JSON heavy. It uses a lot of multi-line JSON requests in tests which need to be escaped and concatenated which in turn makes them hard to read. Let's try to leverage Java 15 text blocks for representing them.
2021-12-15 18:01:28 +01:00
Jack Conradson 8913b7141c
Fix superclass functional interface resolution in Painless (#81698)
A recent change [1] to how we load our allow list changed the resolution for how Painless looks up 
methods of super classes. However, functional interface loading was not changed which caused a 
bug where a functional interface would not look at its super interfaces for the functional interface 
method [2].

This fixes the issue by going through each super interface until the functional interface method is 
found when the target interface doesn't have the functional interface method.

[1] #76955
[2] #81696

Also a big thanks to @megglos and @TheFireCookie for their help with this issue.
2021-12-14 11:37:27 -08:00
Adam Locke 7b47214e5e
[DOCS] Rework manual security docs for 8.0+ (#80285)
* [DOCS] Remove sentence about security being disabled by default

* Updating introduction

* Remove minimal security page

* Clarify configuring security before starting ES

* Clarifications

* Remove old file

* Add set passwords page

* Update change passwords page, clarify TLS adjustments, and other edits

* Update test

* Minor clarification to intro text

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-12-14 10:58:53 -05:00
Ignacio Vera 8c6ed1efc0
Remove experimental flag from geo field format mvt (#81721)
Small left over from 7.16 where mvt feature become GA
2021-12-14 15:21:05 +01:00
David Kyle d1ee756da8
[ML][DOCS] Add note about max values of thread settings (#81367) 2021-12-14 13:07:34 +00:00
David Roberts 0559dd087b
[ML] Model snapshot upgrade needs a stats endpoint (#81641)
Previously the ML model snapshot upgrade endpoint did not
provide a way to reliably monitor progress. This could lead
to the upgrade assistant UI thinking that a model snapshot
upgrade had finished when it actually hadn't.

This change adds a new "stats" API that allows external
interested parties to find out the status of each model
snapshot upgrade and which node (if any) each is running on.

Fixes #81519
2021-12-14 08:31:49 +00:00
Lisa Cawley 1751ced80a
[DOCS] Fix formatting in get anomaly job API (#81682) 2021-12-13 12:56:27 -08:00
eltomello 38a74a4545
[DOCS] Fix field name to match description (#81621) 2021-12-13 15:51:42 -05:00
Rory Hunter 91b4f6ebdc
Improve Docker image's cacert scripting (#81659)
Apply suggestions from Docker Inc about how to update the `cacerts` in
our Ubuntu-based Docker image. Instead of copying around files and
symlinking, instead install `ca-certificates` and `p11-kit`, and use the
latter to regenerate Java's `cacerts`, as well as ensuring it is
regenerated if the system ca certs are updated.
2021-12-13 15:42:59 -05:00
David Turner 30bda56f9a
Readonly repos don't cache (#81674)
We say to mark repos as readonly to prevent corruption, but there's
other ways to prevent corruption that people sometimes use instead (e.g.
denying writes at the filesystem/bucket level). It's reasonable to think
that the readonly flag is redundant in that situation but it's not: they
should still mark the repo as readonly tho to bypass the cache and
re-read its contents on each access. This commit adds docs to that
effect.

Co-authored-by: James Rodewig <james.rodewig@elastic.co>
2021-12-13 18:36:26 +00:00
James Rodewig 6c8f0b170b
[DOCS] Fix ordered list formatting in data stream docs (#81667) 2021-12-13 12:53:48 -05: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
Mary Gouseti 175c4793f9
Expose the index age in ILM explain output. (#81273)
* Expose the index age in ILM explain output.

 ILM already exposes the `age` that ILM will use to transition to the next phase, based on that phase's `min_age`. The `index_age` is based only on the index creation date and it's used to trigger a rollover.

 Resolves #64429
2021-12-13 15:38:25 +01: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
James Rodewig cec4a79a8e [DOCS] Fix formatting typo 2021-12-09 15:46:44 -05:00
Przemyslaw Gomulka 09dc47f352
[DOCS] Add description of X-Opaque-ID and trace.id (#81433)
Documenting headers x-opaque-id and traceparent (emitted as trace.id)
and their usage in logs
2021-12-09 15:54:05 +01:00
James Rodewig 03afcf1a88
[DOCS] Clarify rolling upgrade support for minor versions (#81444)
We only support rolling upgrades between minor versions of the same
major.

It also adds some tags to reuse duplicated content.
2021-12-09 09:04:10 -05:00
Olivier Cavadenti 90e4e8ce63
Add index pressure stats in cluster stats (#80303)
`GET _nodes/stats` returns statistics about indexing pressure for each node.
With this commit `GET _cluster/stats` now returns stats about indexing pressure
computed by aggregating the indexing pressure stats of each node in the
cluster.

Closes #79788
2021-12-09 12:41:08 +00:00
David Turner 7d69f1a974
Oversharding is also indices and fields (#81511)
Today the _Size your shards_ docs focus on shard size and count, but in
fact index count and field count are also important. This commit expands
these docs a bit to cover this observation too.
2021-12-09 08:51:36 +00:00
David Turner 5b9ce9e820
Remove dead code from same-shard decider (#81520)
Today the same-shard allocation decider falls back to checking the
hostname if the node has no host address. In practice nodes will always
have an address so the fallback is dead code. This commit removes that
dead code.

Relates #80702 which will add the ability to distinguish nodes by
hostname regardless of whether they have an address or not, and #80767
which optimizes this area of code - this refactoring should make the
optimization simpler.
2021-12-09 08:42:25 +00:00
David Kyle 3c974a1e5d
[ML][DOCS] Remove orphaned GET deployment stats doc (#81505) 2021-12-09 08:32:33 +00:00
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
Stuart Tettemer ba6c17d30f
Script: Implicit context cache (#81552)
The script context cache is deprecated.

In 7.16 the default value of `script.max_compilation_rate` was switched from `"use-context"`,
to `"150/5m"`.

That means uses would have to explicitly set `"use-context"` to use any of the context cache families of settings:
`script.context.*.max_compilations_rate`
`script.context.*.cache_max_size`
`script.context.*.cache_expire`

On upgrades to 7.16, if the customer was using the default and had set any of those settings without setting
`script.max_compilation_rate: "use-context"`, the upgrade would be fail.

To avoid an unintentional breaking change, the script service will now **implicitly** use the script context cache if 
`script.max_compilation_rate` is **unset** and any of the context cache family of settings is set.

The context cache will also be used if `script.max_compilation_rate: "use-context"`, as before.

Fixes: #81486
2021-12-08 15:12:44 -06: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
Jack Conradson d59038ba74
Add a geo point field for the scripting fields api (#81395)
This adds a geo point(s) field for the scripting fields api. This field only supports get(default), 
get(index, default), and iterator right now. This also adds the ability to create new a GeoPoint through 
the allow list, so users can specify a default that makes sense. It does not include reset as this field 
currently does not wrap the data to be read-only.
2021-12-07 11:33:51 -08:00
Ioannis Kakavas 54eb955a65
Docker fix additional nodes (#81082)
Allow users to pass an ENROLLMENT_TOKEN environment variable that
would be passed as the `--enrollment-token` parameter to the
elasticsearch executable running in the container. This allows an
elasticsearch node running in docker to enroll itself to an
existing secured cluster.

Resolves: #81068
2021-12-07 18:10:05 +02:00
Stuart Tettemer bf4861c2dc
Script: fields API for IP mapped type (#81396)
* Script: fields API for IP mapped type

Adds support in the scripting fields API for the `ip` mapped type,
including the runtime script type.

Adds a new value object, `IPAddress`, to avoid exposing Java's
`InetAddress`. `InetAddress` may cause name resolution if whitelisted
improperly.

`field('ip')`, implemented by `IpDocValuesField` exposes:
  `IPAddress get(IPAddress)`
  `IPAddress get(int, IPAddress)`
  `Iterator<IPAddress> iterator()`
  `List asStrings()`
  `String asString(String)`
  `String asString(int, String)`

`IPAddress` exposes:
  `boolean isV4()`
  `boolean isV6()`
  `String toString()`

Refs: #79105
2021-12-07 09:50:59 -06: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
Brandon Morelli 0ac57d3c13
[DOCS] Remove outdated APM ifeval (#81402)
Removes the old `ifeval` for links to 7.x APM documentation. 7.x no longer exists, so this code isn't needed.

Originally added in https://github.com/elastic/elasticsearch/pull/56538.
2021-12-07 09:20:58 -05:00
Joe Gallo 0db66b87aa
_tier_preference docs changes for 8.0 (#81389) 2021-12-06 19:40:47 -05:00
William Brafford a0fda84da5
All system indices are hidden indices (#79512)
System indices should be hidden from users. Since they are already restricted
indices, a users that can't view restricted indices already can't see or access
them, but they should also be hidden for superusers or users that are otherwise
granted advanced privileges.

To the greatest degree possible, we apply hidden settings in the transport
layer, so that the system can create an index or alias that is set to visible,
for example, when operating in a mixed cluster mode. However, in the case of
aliases created by templates, we hide the alias in the service layer.

This change has broken a number of tests that were relaying unnecessarily on
wildcard searches. In general, the fix for these issues was to apply
expand_wildcards=open,hidden to the request.

* Force system indices to be hidden in IndexMetadata
* Hide system data streams
* Update feature migration tests
* ML datafeed config defaults to searching hidden indices
* Prevent unmanaged system indices from becoming visible
* Change validation in TransportUpdateSettingsAction
* Validate index creation settings in transport action
* Make sure system data stream backing indices are hidden
* Make sure transport request adds hidden index setting if missing
* Validate and set default for autocreated system indices
* Add some code to hide system aliases
* Hide system aliases in create index service
* Hide system aliases when adding them via alias endpoints
* Check system indices when simulating and validating templates
* Add known issue for reenabling tests

* Update docs/changelog/79512.yaml
2021-12-06 14:52:33 -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