Commit graph

117 commits

Author SHA1 Message Date
James Rodewig
9e0299f551
[DOCS] Troubleshoot the flood-stage watermark error (#78519)
Adds troubleshooting steps for the flood-stage watermark error.

Closes #77906.
2021-10-01 08:32:53 -04:00
Stef Nestor
e1062803bb
[DOCS] Use dedicated hosts for ES (#77582)
In production, we recommend you run {es} on a dedicated host or as a primary service.
This adds that best practice to our setup documentation.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-09-21 17:50:21 -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
James Rodewig
434843e66c [DOCS] Fix typo 2021-09-10 10:56:37 -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
James Rodewig
e246e1ce53
[DOCS] Remove 'step' from headings (#76753) 2021-08-20 08:52:04 -04:00
Julie Tibshirani
2ddbd62291
Mention match_only_text in disk usage docs (#76416)
* Mention match_only_text in disk usage docs

Previously we explained how to manually disable norms, freqs, and positions. We
now have a ready-made solution in the new `match_only_text` field type.

* Fixing typo and minor grammar changes

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2021-08-13 09:31:09 -04:00
James Rodewig
27d28e1976
[DOCS] Note assumptions for shard size and count recommendations (#76353)
On the "Size your shards" page, the shard size recommendation assumes a time
series use case. Similarly, users shouldn't count nearly empty and rarely used
Enterprise Search system indices against the recommended shard count limit.

Closes #76328.
2021-08-13 08:44:19 -04:00
James Rodewig
55c4138b10
[DOCS] Add docs for rejected requests and high CPU usage (#72640)
Adds docs for rejected requests and high CPU usage.

Closes #72468.

Closes #69868.
2021-08-02 09:11:23 -04:00
James Rodewig
318927341e [DOCS] Remove unneeded screenshot from 'Size your shards' docs 2021-07-27 15:47:10 -04:00
James Rodewig
76938006ab
[DOCS] Note required node roles and data tiers (#74566)
Closes #74528 and #74565
2021-07-07 09:57:32 -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
James Rodewig
e111c39da0 [DOCS] Remove unneeded on-page TOC 2021-06-17 08:40:56 -04:00
James Rodewig
712dbdc037 Remove unneeded word 2021-06-02 15:12:34 -04:00
James Rodewig
7f93d07ee3
[DOCS] Revise shard size guidelines to 50GB (#73686)
Changes:
* Revises the size your shards guide to use a 50GB shard guideline. This better aligns with our default in the ILM policy UI.
* Updates the language to indicate that the 50GB shard guideline is not a hard limit. Larger shards may work depending on the network and use case.

Reverts some changes added in #71367.
2021-06-02 13:41:40 -04:00
Luca Belluccini
3e41d753e3
[DOCS] Note circuit breakers reject requests with 429 HTTP status code (#69864)
We mention Elasticsearch returns 429 if the circuit breaker trips in https://www.elastic.co/blog/improving-node-resiliency-with-the-real-memory-circuit-breaker, but there is no mention in the docs.

This adds an xref to circuit breaker errors section.

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-06-02 10:31:24 -04:00
James Rodewig
c9a09e33e5
[DOCS] Remove _all examples from 'Fix common cluster issues' (#73217)
We plan to deprecate the `_all` wildcard pattern. This removes several
`_all` examples from the 'Fix common cluster issues' guide.
2021-05-19 08:37:16 -04:00
James Rodewig
f8666b930f
[DOCS] Add 'Fix common cluster issues' docs (#72097) 2021-04-28 08:28:51 -04:00
James Rodewig
d94af832c5 [DOCS] Remove uneeded 'How to' from title 2021-04-23 10:07:13 -04:00
James Rodewig
048ad99116 [DOCS] Consistent leading slash in snippets 2021-04-19 16:29:08 -04:00
James Rodewig
b127447548 [DOCS] Fix cat API name 2021-04-06 17:17:05 -04:00
James Rodewig
1f361ad2d1
[DOCS] Update size your shards for max_primary_shard_size (#71367) 2021-04-06 17:08:24 -04:00
James Rodewig
07e9c6aca4 [DOCS] Swap event.original for message 2021-04-06 06:51:58 -04:00
James Rodewig
94d88082ec [DOCS] Swap message for event.original 2021-04-05 13:57:59 -04:00
James Rodewig
c23f001151
[DOCS] Add how-to guide for time series data (#71195) 2021-04-05 13:00:06 -04:00
James Rodewig
e4962994ff
[DOCS] Remove performance warning for script fields (#69309) 2021-02-22 10:05:49 -05:00
James Rodewig
9e7a27e085
[DOCS] Fix heading in disk usage tuning guide (#68519) 2021-02-04 08:52:12 -05:00
Pius
399e11b7e7
[DOCS] Add force merge disclaimer to tuning guide (#68491)
Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-02-03 16:42:01 -05:00
David Turner
2adeb4a666
Expand and consolidate networking docs (#68051)
Today's network config docs are split into "Network", "HTTP" and
"Transport" pages, with unclear relationships between them. We often
encounter users with weird configs that indicate they don't really
understand how these settings all relate. In fact these pages are all
very interrelated, and the HTTP and Transport pages are almost all only
for advanced users. This commit brings these docs into a single page and
rewords some things to try and guide users away from the advanced
settings unless their configuration needs all the extra complexity.

It also adds a section entitled "Binding and publishing" which clarifies
the meanings of the `bind_host` and `publish_host` parameters. This is
also a common source of confusion amongst users.

It also clarifies that many of these settings accept a list of
addresses, and warns that this may not be what you want. Closes #67956.

Co-authored-by: Adam Locke <adam.locke@elastic.co>
2021-02-01 13:06:20 +00:00
James Rodewig
cb3e0051e0
[DOCS] Make cat API verbose query param explicit (#67300) 2021-01-11 17:19:23 -05:00
James Rodewig
e9c1cded98
[DOCS] Fix outdated heap references (#66646) 2020-12-21 14:01:12 -05:00
James Rodewig
0805ff17a5
[DOCS] Fix redirects and anchors (#65472) (#65474) 2020-11-24 19:59:52 -05:00
Wylie Conlon
10ee0f2878
Clarify field data cache behavior in docs (#64375)
* Clarify that field data cache includes global ordinals
* Describe that the cache should be cleared once the limit is reached
* Clarify that the `_id` field does not supported aggregations anymore
* Fold the `fielddata` mapping parameter page into the `text field docs
* Improve cross-linking
2020-11-20 13:53:23 -08:00
James Rodewig
2ae0d2cb6e
[DOCS] Add xref to data tiers content (#63426) 2020-10-07 13:10:42 -04:00
Rafi Estrada
907d0eb696
[Docs] Correct typo (#63102) 2020-10-02 10:16:26 +02:00
James Rodewig
8bdf36d18b
[DOCS] Document shard sizing guide (#61942)
Revises the current 'How to avoid oversharding' docs to incorporate
information from our [shard sizing blog post][0].

Changes:

* Streamlines introduction
* Adds "Things to remember" section to describe how shards work
* Adds "Guidelines" section based on blog tips
* Creates a "Fix an oversharded cluster" section

[0]: https://www.elastic.co/blog/how-many-shards-should-i-have-in-my-elasticsearch-cluster
2020-09-28 09:24:40 -04:00
James Rodewig
95ff607857 remove xref from heading 2020-09-03 17:48:16 -04:00
James Rodewig
f881a695e1
[DOCS] Add redirects for wildcard and constant keyword (#61815) 2020-09-01 15:32:35 -04:00
James Rodewig
a94e5cb7c4
[DOCS] Replace Wikipedia links with attribute (#61171) 2020-08-17 09:44:24 -04:00
James Rodewig
9b9e0b7b16
[DOCS] Remove search request body page (#60972) 2020-08-11 12:05:54 -04:00
James Rodewig
bb5a4b3f82
[DOCS] Cross-link copy_to and search speed docs (#60926) 2020-08-10 14:34:59 -04:00
James Rodewig
6b9b8c5e31
[DOCS] Move script and stored fields content to search fields page (#60826)
Changes:

* Moves `Retrieve selected fields` to its own page and adds a title abbreviation.
* Adds existing script and stored fields content to `Retrieve selected fields`
* Adds a xref for `Retrieve selected fields` to `Search your data`
* Adds related redirects and updates existing xrefs
2020-08-06 12:45:03 -04:00
Leaf-Lin
947186719e
[DOCS] Add rollups to Tune for disk usage (#60436) 2020-07-31 15:53:44 -04:00
James Rodewig
aec26b1a23
[DOCS] Move search pagination content to one page (#60515) 2020-07-31 11:43:06 -04:00
James Rodewig
2774cd6938
[DOCS] Swap [float] for [discrete] (#60124)
Changes instances of `[float]` in our docs for `[discrete]`.

Asciidoctor prefers the `[discrete]` tag for floating headings:
https://asciidoctor.org/docs/asciidoc-asciidoctor-diffs/#blocks
2020-07-23 11:48:22 -04:00
James Rodewig
80b674fb25
[DOCS] Reformat snippets to use two-space indents (#59973) 2020-07-21 12:24:26 -04:00
James Rodewig
8a57800f1b
[DOCS] Add performance warning for scripts (#59890) 2020-07-20 14:04:35 -04:00
James Rodewig
aa3ddfeefb
[DOCS] Move highlighting docs to separate page (#59768)
Moves the highlighting docs from the deprecated 'Request Body Search'
chapter to the new subpage of the 'Run a search chapter' section.

No substantive changes were made to the content.
2020-07-17 10:15:20 -04:00
Kartika Prasad
5273681433
Update indexing-speed.asciidoc (#59347)
typo fix
2020-07-13 12:19:00 +01:00
Lisa Cawley
8b9293b3bf
[DOCS] Replace docdir attribute with es-repo-dir (#57489) 2020-06-01 15:55:05 -07:00