Commit Graph

9516 Commits

Author SHA1 Message Date
Lisa Cawley f871bfc4ae
[DOCS] Clarify transform requirements (#83295) 2022-02-07 16:08:57 -08:00
James Rodewig 3aee6171e7
[DOCS] Link to the 7.17 upgrade assistant docs (#83613) (#83615)
The 8.0 upgrade assistant is only available in 7.17. This updates our docs to link to the 7.17 version of the related Kibana docs page.

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
(cherry picked from commit 3787c13619)

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2022-02-07 18:29:26 -05:00
James Rodewig 294c49c29f
[DOCS] Clean up 8.0 deprecations (#83548)
* Removes a duplicate breaking change/deprecation for `indices.query.bool.max_clause_count`.

* Relocates the `index.merge.policy.max_merge_at_once_explicit` deprecation content to a breaking changes section.

* Adds remediation steps for removing the settings. While they no longer have an effect, specifying these settings will issue a deprecation warning.

Relates to https://github.com/elastic/elasticsearch/pull/83412
2022-02-07 15:00:23 -05:00
James Rodewig 411eefcc46
[DOCS] Remove major release references from migration guide (#83555)
Updates the language in our migration guides to remove references to major releases.
2022-02-07 12:26:24 -05:00
James Rodewig 2f03112b5b
[DOCS] Synced with 8.0 stack upgrade changes (#83489) (#83596)
This moves the bulk of the upgrade information into the consolidated upgrade guide, but leaves the primary upgrade topic in place as a cross reference.

Relates to: https://github.com/elastic/stack-docs/pull/1970

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
(cherry picked from commit f6473d71f9)

Co-authored-by: debadair <debadair@elastic.co>
2022-02-07 11:01:42 -05:00
James Rodewig 02ea65aaff
[DOCS] Switch xrefs to external links (#83590)
We reuse our breaking changes in the [Elastic Installation and Upgrade Guide](https://www.elastic.co/guide/en/elastic-stack/current/index.html). To prevent broken links, we have to use external links rather than xrefs inside breaking changes.

Relates to https://github.com/elastic/elasticsearch/pull/83487.
2022-02-07 09:27:48 -05:00
Dan Hermann 7987507014
[DOCS] 'features' flag added in #83083 (#83452) 2022-02-07 08:26:06 -06:00
Jake Landis 5c73ad1da2
REST API compatiblity documentation (#83487)
Co-authored-by: debadair <debadair@elastic.co>
2022-02-04 16:32:22 -06:00
James Rodewig fe2990829a
Update setting deprecation messages to remove major release references (#83528)
Updates our setting deprecation messages to avoid references to future major releases.
2022-02-04 13:53:20 -05:00
Dan Roscigno 302ce75a88
Add note about base_path and ECE to the snapshot repository docs (#83526)
Elastic Cloud Enterprise (ECE) shares snapshot repositories across multiple deployments. As a result, the `base_path` is generated by ECE, and the `base_path` setting is not allowed.  This PR adds a note to the S3, Azure, and GCS snapshot repository docs.
2022-02-04 11:34:48 -05:00
Bogdan Pintea ca76121ac0
List unsigned_long type as supported SQL type (#83480)
Add unsigned_long as an (experimentally) supported SQL type and its
limitations.
2022-02-04 12:14:56 +01:00
István Zoltán Szabó a1d9d04c0e
[DOCS] Adds disclaimer to cat APIs (#83382)
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
2022-02-04 08:55:19 +01:00
Fabio Busatto 54cfbabe42
[Docs] Delete Elasticsearch Homebrew 8.x docs (#83446)
* Delete Elasticsearch brew install page

* Remove brew references

* Remove brew mentions

* Remove brew references

* Remove brew references

* Remove trailing newline

* Removing trailing newline
2022-02-03 13:05:22 -08:00
Tim Brooks ea96bfe5ac
Add elasticsearch health API (#83119)
Add an API to return information about Elasticsearch health status.

Relates to #83303.
2022-02-03 13:45:22 -07:00
Adam Locke d2e7b4caf5
[DOCS] Add documentation for Painless field API (#83388)
* [DOCS] Add documentation for Painless field API

* Moving content to a new page and incorporating reviewer feedback

* Clarify note

* Incorporating review comments

* Remove Object so as not to confuse it with the object type

* Add section and table for supported mapped field types

* Update table based on review feedback
2022-02-03 15:15:38 -05:00
James Rodewig 88be4ed950
[DOCS] Fix get snapshot status API parameters (#81818)
* Documents `GET _snapshot/_status` and `GET _snapshot/<repository>/_status`.
* Notes the `<repository>` and `<snasphot>` parameters are optional.
* Removes erroneous mention of the `<snapshot>` parameter supporting the `_current` value.

Closes #81600

Relates to #80931
2022-02-03 10:55:23 -05:00
Rory Hunter 34c9e257c0 Add 8.0.0-rc2 release notes (#83412) 2022-02-03 12:04:10 +00:00
Mark Vieira fcf1380492 Fix documentation snippet tests 2022-02-02 13:29:02 -08:00
Mayya Sharipova bf3208b028
Add scripted_metric agg context to unsigned_long (#64422)
Also enhance documentation to provide more examples
how unsigned_long field should be used in scripts

Closes #64347
2022-02-02 15:27:42 -05:00
Adam Locke 823281c231
[DOCS] Fix typo (#83426) 2022-02-02 14:58:57 -05:00
James Rodewig 882bac8948 [DOCS] Fix CCS compatibility typo 2022-02-02 13:09:40 -05:00
Yannick Welsch 7f0595abe6
Implement all queries on doc-values only keyword fields (#83404)
Adds doc-values-only search support for wilcard/regexp/prefix/fuzzy etc. queries on keyword fields.

Relates #81210 and #52728
2022-02-02 14:06:27 +01:00
Yannick Welsch eec26826d6
Allow doc-values only search on geo_point fields (#83395)
Similar to #82409, but for geo_point fields.

Allows searching on geo_point fields when those fields are not indexed (index: false) but just doc values are enabled.

Also adds distance feature query support for date fields (bringing date field to feature parity with runtime fields)

This enables searches on archive data, which has access to doc values but not index structures. When combined with
searchable snapshots, it allows downloading only data for a given (doc value) field to quickly filter down to a select set
of documents.

Relates #81210 and #52728
2022-02-02 11:56:19 +01:00
Tanguy Leroux 7f827bbab8
Document and test operator-only node bandwidth recovery settings (#83372)
This commit updates the Operator-only functionality doc to 
mention the operator only settings introduced in #82819.

It also adds an integration test for those operator only 
settings that would have caught #83359.
2022-02-02 11:50:19 +01:00
Francisco Fernández Castaño 520b8435d0
Add desired nodes API (#82975)
This commit adds the Desired Nodes API, allowing orchestrators
that manage Elasticsearch clusters to let the system know about the
current/planned topology that the cluster will run on.
This allows the system to take better decisions based on the entire
cluster topology, including nodes that will be added/removed in the
near future.
2022-02-01 17:54:57 +01:00
Adam Locke 620fe44c6b
[DOCS] Update dynamic mapping docs to clarify supported match_mapping_type (#83274)
* [DOCS] Update dynamic mapping docs to clarify supported match_mapping_type

* Add ES data type column header

* Remove sentence about always choosing the larger data type

* Clarify that JSON doesn't distinguish types

* Add frame to table
2022-02-01 10:37:27 -05:00
David Turner a062bdf42f
Add docs for node bandwith settings (#83361)
Relates #82819
2022-02-01 12:19:00 +00:00
Eric Beahan 540a40093c
[DOCS] Correct header syntax (#83275)
* correct header syntax

* Update docs/reference/search/search-your-data/retrieve-selected-fields.asciidoc

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-01-28 14:55:54 -05:00
Adam Locke 33b72f34e2
[DOCS] Add note that write indices are not replicated (#82997)
* [DOCS] Add note that write indices are not replicated

* Clarify note about is_write_index

* Clarify leader aliases with is_write_index

Co-authored-by: Henning Andersen <33268011+henningandersen@users.noreply.github.com>

Co-authored-by: Henning Andersen <33268011+henningandersen@users.noreply.github.com>
2022-01-28 13:24:53 -05:00
Julie Tibshirani e7ba03e0a6
Add notes on indexing to kNN search guide (#83188)
This change adds a new 'indexing considerations' section that explains why index
calls can be slow and how force merge can help search latency.
2022-01-28 10:23:35 -08:00
Joe Gallo 0935485684
Fix get-snapshot-api :docs:integTest (#83273) 2022-01-28 12:24:01 -05:00
Christoph Büscher 61e1b080dd
[Docs] Add supported _terms_enum field types (#83244)
The `_terms_enum` API currently supported keyword, constant_keyword and
flattened fields. This should be documented more clearly.
2022-01-28 12:47:12 +01:00
Salvatore Campagna 9de75c2ac5
Add an aggregator for IPv4 and IPv6 subnets (#82410)
Parameters accepted by the aggregator include:

* prefix_length (integer, required): defines the network size of the subnet mask;
* is_ipv6 (boolean, optional, default: false): defines whether the prefix applies to IPv6 (true) or IPv4 (false) IP addresses;
* min_doc_count (integer, optional, default: 1): defines the minimum number of documents for a bucket to be returned in the results;
* append_prefix_length (boolean, optional, default: false): defines if the prefix length is appended to the IP address key when returning results;
* keyed (boolean, optional, default: false): defines whether the result is returned keyed or as an array of buckets;

Each bucket returned by the aggregator represents a different subnet. IPv4 subnets also include a netmask field set to the subnet mask value (i.e. "255.255.0.0" for a /16 subnet).

Related to: #57964 and elastic/kibana#68424
2022-01-28 11:59:07 +01:00
Jack Conradson 43052a1074
Fix joda migration for week based methods in Painless (#83232)
This change updates the docs to correct suggestions for migrating from 
JodaCompatibleZonedDateTime to ZonedDateTime in Painless for week based year and week of 
week based year.
2022-01-27 12:23:49 -08:00
Adam Locke e182067f1f
Clarify commands shown for "permanently" setting max_map_count (#82345) (#83227)
* Clarify commands shown for "permanently" setting max_map_count

The current text shows a grep, which of course does not set the value at all.  I've clarified why it's offered (to CHECK the value).

I've also moved the command for setting the value temporarily to above that discussion, to make it more clear to readers that that's what it does.

* Reorder commands, add headings, and fix typos

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

Co-authored-by: Charlie Arehart <charlie@carehart.org>
2022-01-27 13:45:30 -05:00
David Kyle c1fbf87de8
[ML] Add error counts to trained model stats (#82705)
Adds inference_count, timeout_count, rejected_execution_count
and error_count fields to trained model stats.
2022-01-27 16:18:20 +00:00
Nicole Albee 5b6164f8fd
[Docs] Watcher clarification on CSV formulas warning. (#83088)
* Update docs for Watcher notification settings to include default xpack.notification.reporting.warning.kbn-csv-contains-formulas.text value and link to the Kibana documentation.

* Apply suggestions from code review

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

* Apply suggestions from code review

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

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-01-27 09:23:12 -05:00
James Rodewig 836d9bc786
[DOCS] Add redirect for 'Java client and security' page (#83180)
Adds a redirect for the [Java client and security](https://www.elastic.co/guide/en/elasticsearch/reference/7.17/java-clients.html) page, which has been removed in 8.0+.

We saw this missing page create several broken links in https://github.com/elastic/docs/pull/2312. I've opened separate PRs to update those links. This adds a redirect for anyone who otherwise lands on the page.
2022-01-27 08:27:35 -05:00
István Zoltán Szabó b42ba64019
[DOCS] Fixes geo function field names. (#83198) 2022-01-27 12:03:58 +01:00
Ignacio Vera 0873893bb7
New GeoHexGrid aggregation (#82924)
This commit introduces a new geogrid aggregation called GeoHexGridAggregation that
is based in Uber h3 grid. It only supports geo_point fields.
2022-01-27 07:45:51 +01:00
James Rodewig cb6265f9bd
[DOCS] Move snapshot repo types to separate pages (#82826)
With https://github.com/elastic/elasticsearch/pull/81870, the Azure, GCS, and S3 repository types have separate, dedicated pages in the Elasticsearch guide. For consistency, this PR creates separate pages for the shared file system, read-only URL, and source-only repository types.

Related changes:

- Adds redirects to the plugins docs
- Fixes a few breaking changes that refer to the Azure, GCS, and S3 repositories as plugins.

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-01-26 17:13:39 -05:00
Mitar b65fb17a48 Fixed documentation for built in date formats. (#83036)
We had a lot of `ZZ` on the end of formats. But it's just `Z`.
2022-01-26 14:22:02 -05:00
Ugo Sangiorgi 305ff20b8f
[DOCS] Add missing HTML anchors to CCR and ML (#80287) 2022-01-26 11:00:40 -08:00
James Rodewig 47d45d0a14
[DOCS] Archived settings block config updates (#82069)
**Changes:**

* Notes that archived cluster settings block cluster setting updates. Previously, the docs stated that ES ignored archived cluster settings.
* Notes that archived index settings can block index settings updates. For example, it blocks `index.hidden` but not `number_of_replicas`. Previously, the docs stated that you could safely ignore archived index settings.

Relates #78351

Closes #61175
2022-01-26 12:21:46 -05:00
James Rodewig 63f228e24e
[DOCS] Re-add paragraph noting `doc_count` is approximate (#83154)
This paragraph was accidentally removed as part of #79205. Also fixes a minor heading capitalization error.
2022-01-26 11:07:59 -05:00
David Turner 9633883c64
Add note on truststore for S3-compatible repos (#82669)
Today we note that the `repository-s3` plugin uses the JVM-wide
truststore in the docs for the `protocol` client setting, but it turns
out that this is easy to overlook since most installations will not need
to change the `protocol`. This commit adds the same detail to the
section on S3-compatible repositories where it is more likely to be
found.
2022-01-26 11:16:43 +00:00
Toby Sutor 30b8cdc184
[DOCS] Add note to that log4j customization is outside the support scope (#82668)
* [docs] Add note to Elasticsearch logging that log4j customization is out of support scope

* Update language for default logging recommendation

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

Co-authored-by: Quin Hoxie <qhoxie@gmail.com>
Co-authored-by: Adam Locke <adam.locke@elastic.co>
2022-01-25 17:03:16 -05:00
James Rodewig eda391a7ed
[DOCS] Delete pipeline containing stored script (#83102)
Adds a hidden snippet to delete the pipeline containing a stored script for cleanup.

Relates to https://github.com/elastic/elasticsearch/issues/83097.
2022-01-25 16:32:56 -05:00
James Rodewig d3fb014914
[DOCS] Reuse multi-level `join` warning (#82976)
Updates and reuses a warning against creating multi-level `join` fields to make it more prominent.

The current warning is low on the page, where some users may not seeing until they've already begun mapping fields.

Closes https://github.com/elastic/elasticsearch/issues/82818.
2022-01-25 13:51:42 -05:00
James Rodewig 84429e6ff2
[DOCS] Fix typo in `action.destructive_requires_name` breaking change (#83085)
In 8.0+, the `action.destructive_requires_name` setting defaults to `true`, not `false`.
2022-01-25 11:03:28 -05:00