Commit Graph

9573 Commits

Author SHA1 Message Date
Mary Gouseti ed0bb2a8af
Push back excessive requests for stats (#83832)
Resolves #51992
2022-02-28 08:46:18 +01:00
Ioannis Kakavas 8cebba5708
Instructions to retrieve keystore pwd (#84340)
In 8.0.0. we introduce TLS autoconfiguration. We store the key and
certificate materials in password protected PKCS#12 keystores and
we store these passwords in the elasticsearch keystore.
This commit adds instructions on how to get hold of the passwords
for users to inspect or alter the PKCS#12 keystores.
2022-02-25 15:27:06 +02:00
Julie Tibshirani 95be11f6fb
Clarify docs on field type families (#84368)
There has been some confusion over the definition of a field type family. This
PR clarifies the definition in the docs: the two types should have the exact
same search behavior (including supporting the same queries/ aggs, and producing
the same response). It's not sufficient for them to just support the samme
search operations.

This change also fixes an inaccurate statement that there is only one field type
family so far.
2022-02-24 13:27:36 -08:00
Julie Tibshirani d9ef39f7c2
Remove 'under development' note in suggester docs (#84366)
In the intro, we mention that parts of the feature are still under development.
This is not very helpful information for users, and could give the wrong
impression about its maturity.
2022-02-24 13:27:03 -08:00
István Zoltán Szabó 614f089e82
[DOCS] Expands description of the reset transform API (#84270) 2022-02-24 10:01:28 +01:00
James Rodewig 5bcbccfac8
[DOCS] Add 8.0.1 release notes (#84213) (#84292)
Update docs for v8.0.1-BC2 release

(cherry picked from commit 7809c8e515)

# Conflicts:
#	docs/reference/release-notes.asciidoc

Co-authored-by: Salvatore Campagna <93581129+salvatore-campagna@users.noreply.github.com>
2022-02-23 12:08:29 -05:00
James Rodewig 2437e7d36f
[DOCS] Fix upgrade docs for 8.x (#84076)
The current upgrade docs contain some language that's only applicable to 8.0. This updates the docs so they're usable in other 8.x branches.
2022-02-23 10:53:18 -05:00
James Rodewig d3d468e5f1
[DOCS] Update screenshots for ingest pipeline docs (#83845)
https://github.com/elastic/kibana/pull/101216 adds a new ECS mapper feature to the Ingest Pipelines UI. This updates the ES docs to cover the new feature.
2022-02-23 10:50:02 -05:00
James Rodewig 80be0c6abf
[DOCS] Update 8.1.0 release notes (#84185) (#84302)
(cherry picked from commit 297b69ed6c)

# Conflicts:
#	docs/reference/release-notes/8.1.asciidoc

Co-authored-by: Ievgen Degtiarenko <ievgen.degtiarenko@elastic.co>
2022-02-23 10:22:26 -05:00
Nhat Nguyen 86964c9752
Document partial search results with skip_unavailable (#84057)
This commit adds an explanation for the relation between `allow_partial_search_results` and `skip_unavailable` in CCS requests.

Relates to #33915

Closes #82407

Co-authored-by: James Rodewig <james.rodewig@elastic.co>
2022-02-23 10:04:52 -05:00
István Zoltán Szabó 030d87074b
[DOCS] Adds reference of transform reset option to the tutorial (#84194) 2022-02-23 10:00:44 +01:00
Nhat Nguyen 31d703f24c
Introduce lookup runtime fields (#82385)
This PR introduces the lookup runtime fields which are used to retrieve 
data from the related indices. The below search request enriches its
search hits with the location of each IP address from the `ip_location`
index.

```
POST logs/_search
{
  "runtime_mappings": {
    "location": {
      "type": "lookup",
      "lookup_index": "ip_location",
      "query_type": "term",
      "query_input_field": "ip",
      "query_target_field": "_id",
      "fetch_fields": [
        "country",
        "city"
      ]
    }
  },
  "fields": [
    "timestamp",
    "message",
    "location"
  ]
}
```

Response:

```
{
  "hits": {
    "hits": [
      {
        "_index": "logs",
        "_id": "1",
        "fields": {
          "location": [
            {
              "city": [ "Montreal" ],
              "country": [ "Canada" ]
            }
          ],
          "message": [ "the first message" ]
        }
      }
    ]
  }
}
```
2022-02-22 21:36:19 -05:00
DeDe Morton 08c0fcd91e
Clarify docs about CA fingerprints and Fleet (#84056)
Co-authored-by: James Rodewig <james.rodewig@elastic.co>
Co-authored-by: Ioannis Kakavas <ikakavas@protonmail.com>
2022-02-22 15:02:46 -08:00
Ioannis Kakavas c923bd235b
Package installation docs minor change (#84177)
Make it clearer that security configuration happens on installation
and not on first start of Elasticsearch.
2022-02-22 18:54:26 +02:00
Lisa Cawley 5ae96e5f23
[DOCS] Add read_pipeline privilege to transform setup (#84151) 2022-02-22 07:47:44 -08:00
Yannick Welsch 083bb8a3fd
Add extra section on doc-value-only fields to documentation (#84209)
Adds a dedicated section for doc-value-only fields to the docs that can be linked to.
2022-02-22 11:46:10 +01:00
David Turner 02f38e3da9
Make allocation explanations more actionable (#83983)
The cluster allocation explain API includes a top-level status
indicating to the user whether the shard can be assigned/rebalanced/etc
or not. Today this status is fairly terse and experience shows that
users sometimes struggle to understand how to interpret it and to decide
on follow-up actions.

This commit makes the top-level explanation more detailed and
actionable. For instance, in the cases like `THROTTLED` where the status
is transient we instruct the user to wait; if a shard is lost we say to
restore it from a snapshot; if a shard cannot be assigned we say to
choose a specific node where its assignment is expected and to address
the obstacles.

Co-authored-by: James Rodewig <james.rodewig@elastic.co>
2022-02-22 09:23:01 +00:00
Joe Gallo 119fbcf64e
[DOCS] Fix shrink index API prereqs (#84197) 2022-02-21 16:17:49 -05:00
Justin Cranford d103af2d06
Add JWT realm support for JWT validation (#83155) 2022-02-21 01:54:39 -05:00
Ioannis Kakavas 6e530c0383
Adjust auto-configuration related docs (#84080)
* Add a note that the http_ca.crt certificate that is generated and
stored in config/certs can be used to configure any client to trust
the certificate that elasticsearch uses for TLS on the HTTP layer
* Add a note that the elasticsearch-create-enrollment-token CLI
tool can only be used with auto-configured TLS settings.
2022-02-20 10:58:46 +02:00
James Rodewig 6ad3f8bfdd
[DOCS] Clarify `orientation` usage for WKT and GeoJSON polygons (#84025)
Clarifies that the `orientation` mapping parameter only applies to WKT polygons. GeoJSON polygons use a default orientation of `RIGHT`, regardless of the mapping parameter.

Also notes that the document-level `orientation` parameter overrides the default orientation for both WKT and GeoJSON polygons.

Closes https://github.com/elastic/elasticsearch/issues/84009.
2022-02-17 10:33:06 -05:00
James Rodewig 8ff1336127
[DOCS] Remove note about partial response from Bulk API docs (#84053)
The bulk API response with a `200 OK` HTTP status always returns an entry for each action in the request. Partial responses aren't applicable.
2022-02-17 09:20:17 -05:00
James Rodewig f9a64b2e86
[DOCS] Fix `ignore_unavailable` parameter definition (#84071)
The current `ignore_unavailable` definition is a bit misleading. The parameter primarily determines if a request that targets a missing or closed index returns an error.
2022-02-17 08:24:06 -05:00
Elasticsearch addict 4e55efc09d
Update Lucene analysis base url (#84094)
Moving to Lucene 9 slightly changed the base url for the analysis components
which this PR fixes.
2022-02-17 12:44:12 +01:00
David Roberts bf00ab381e
[ML] Add ML memory stats API (#83802)
Adds an API that can be used to find out how much memory ML
is permitted to use and is currently using on each node, both
within the JVM heap, and natively, outside of the JVM.
2022-02-17 09:19:14 +00:00
Gordon Brown 7d094c3e5a
Correct documentation regarding how to restore no `feature_states` (#83814)
This commit corrects the snapshot creation and restoration docs to
describe the usage of `"none"` to restore no feature states. Previously,
they incorrectly stated that using an empty array would accomplish this,
but specifying an empty array results in the default behavior (rather
than preventing feature state snapshot/restoration).
2022-02-16 20:04:00 -05:00
Lisa Cawley 458ef91066
[DOCS] Move ML info and upgrade APIs (#84005) 2022-02-16 11:23:00 -08:00
Yannick Welsch 74b5bfdb73
Feature usage actions for archive (#83931)
Relates #81210
2022-02-16 08:31:41 +01:00
James Rodewig e8b34c720d
[DOCS] Re-add HTTP proxy setings from #82737 (#84001)
Re-adds HTTP proxy settings for the GCS repository type. These settings
were added with https://github.com/elastic/elasticsearch/pull/82737.

The docs were accidentally removed as part of
https://github.com/elastic/elasticsearch/pull/82996.
2022-02-15 18:20:22 -05:00
James Rodewig 1fe2b0d866
[DOCS] Fix percolate query headings (#83988)
Fixes the heading levels for the percolate query doc so the on-page TOC displays correctly.
2022-02-15 15:56:04 -05:00
James Rodewig c1aba1e109
[DOCS] Move tip for percolate query example (#83972)
Moves a tip for the percolate query to the beginning of the example.
2022-02-15 15:24:33 -05:00
Tobias Stadler e3deacf547
[DOCS] Fix typos (#83895) 2022-02-15 12:42:17 -05:00
James Rodewig e117812ef8
[DOCS] Update migration APIs docs (#83901)
* Adds a shared note that the migration APIs are mainly intended for internal use by Kibana's Upgrade Assistant.
* Updates the feature migration API docs to use updated "migration" terminology.
* Removes some references to major versions from the deprecation API docs.
2022-02-15 12:19:04 -05:00
Quentin Pradet f033f5879e
Fix path to cacert in check-running.asciidoc (#83888)
Co-authored-by: Arbkz <arbkz@users.noreply.github.com>
2022-02-14 16:15:31 +04:00
Adam Locke 6f8db84885
[DOCS] Moving Docker YAML and .env to a separate directory (#83864) 2022-02-11 16:23:17 -05:00
Adam Locke 950c231e04
[DOCS] Clarify when changes are replicated in CCR (#83863)
Removes a table, which some users found confusing (refer to https://github.com/elastic/sdh-elasticsearch/issues/4009). Clarifies language around when changes are replicated from the leader index to the follower index.
2022-02-11 16:07:38 -05:00
Adam Locke b2e196fe91
[DOCS] Replace mentions of tls_auto_config directory (#83856)
Updates directory mentions of `config/tls_auto_config_<timestamp>` to `config/certs`.
2022-02-11 15:16:58 -05:00
Fabio Busatto ba95c87b50
Fix version variable in docker-compose.yml (#83823) 2022-02-11 21:02:45 +01:00
edh-oss 5ef77ef370
Add/update source block delimeters (#83624)
Asciidoc source blocks are to be delimited with four dashes. This adds missing delimiters, and updates some that contained only three dashes. It matters for parsing purposes.
2022-02-11 14:19:30 -05:00
Lisa Cawley 4fbbcda494
[DOCS] Fix nesting in bucket correlation aggregation (#83816) 2022-02-11 11:14:11 -08:00
Ioannis Kakavas b3c942020a
Add docs for elasticsearch-reconfigure-node (#83605)
Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-02-10 22:35:29 +02:00
James Rodewig d31bdd6bf4
[DOCS] Remove unneeded callouts from snippets (#83798)
These callouts aren't referenced anywhere. Leaving them in can be confusing.
2022-02-10 15:04:46 -05:00
Alan Woodward 8bc46ad959
Add filtering to fieldcaps endpoint (#83636)
Many consumers of the field caps API need to do some post-processing of the
results before they can use them; for instance, Kibana would like to exclude
multifields from certain field selections, or would like to display only geo_point
fields in Maps. ML and QL consumers exclude nested fields in certain
circumstances. This post-processing is possible at the moment, but can be
hacky; and in all cases it involves sending the whole (possibly very large) field
caps response over the wire and then whittling it down in the client. It is also not
guaranteed to be accurate - runtime fields may be incorrectly classified as multifields,
for example.

This commit pushes filtering into elasticsearch itself, reducing the amount of data
that needs to be transported and ensuring better accuracy. The field caps API gets
two new parameters:

* filters - a comma-delimited list that may contain any combination of: `+metadata`,
  `-metadata`, `-nested`, `-parent`, `-multifield`
* types - a comma-delimited list of field types; only fields that have a type in this set
  will be returned

The API will make best-effort attempts to apply the filters post-hoc to responses from
older nodes, so this should still work in a mixed-cluster or cross-cluster situation.

Fixes #82966, #72174
2022-02-10 14:06:26 +00:00
James Rodewig b3ee1e6464
[DOCS] Remove 8.0.0 coming tag (#83757) (#83781) 2022-02-10 07:48:45 -05:00
Ioannis Kakavas 9d867cd5ca
Adds known issue for aarch64 pwd generation (#83654)
We figured out that on Linux and macOS aarch64, we can't
determine whether a terminal is attached to elasticsearch and as
such we don't print the elastic password and enrollment token on
node first startup. This is resolved in #83566 by updating the
underlying library we use to detect the terminal.

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-02-10 10:47:40 +02:00
Lisa Cawley 104efd4343
[DOCS] Minor edits to trained model APIs (#81549) 2022-02-09 13:44:13 -08:00
James Rodewig 6522e6eea2
[DOCS] Update multi-target syntax refs (#83703) 2022-02-09 13:00:07 -05:00
James Rodewig c7c847cdb3
[DOCS] Add 8.1.0 release notes (#83736)
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2022-02-09 12:20:52 -05:00
James Rodewig ccf8bd92e7
[DOCS] Update index management screenshot for elastic/kibana#125037 (#83702)
Updates an index management page screenshot for https://github.com/elastic/kibana/pull/125037
2022-02-09 11:16:54 -05:00
James Rodewig 0949051601
[DOCS] Add 8.0.0 GA release notes (#83689) (#83731)
Adds the 8.0.0 GA release notes. I created these by combining the 8.0.0-alpha1, -alpha2, -beta1, -rc1 and -rc2 releases notes.

Co-authored-by: Lisa Cawley <lcawley@elastic.co>
(cherry picked from commit f9569e23dd)
2022-02-09 11:07:47 -05:00