Commit graph

60 commits

Author SHA1 Message Date
Liam Thompson
d44e05d2c2
[DOCS] Add ES quickstart (#102226)
* [DOCS] TEST restore quickstart

* Use up to date Docker instructions, minor user-friendly modifications

* Use books dataset, update verbiage, add examples

* Update verbiage

* Updated Elasticsearch 'Getting Started' docs: added SSL, Docker setup, Python resources, and expanded next steps

* minor formatting

* Collapse responses, TODO comment tests

* Add request tests

* Edit superfluities

* Apply suggestions

Co-authored-by: István Zoltán Szabó <istvan.szabo@elastic.co>

* Update docs/reference/tab-widgets/quick-start-install.asciidoc

Co-authored-by: István Zoltán Szabó <istvan.szabo@elastic.co>

---------

Co-authored-by: István Zoltán Szabó <istvan.szabo@elastic.co>
2023-11-24 15:27:41 +01:00
Abdon Pijpelink
b03939ec9d
[DOCS] Update ES|QL getting started for demo environment (#102134) 2023-11-14 13:17:48 +01:00
István Zoltán Szabó
c303ab885a
[DOCS] Simplifies dense vector mapping in semantic search example (#102080) 2023-11-14 10:52:56 +01:00
Abdon Pijpelink
c6a1f831e0
[DOCS] Getting started with ES|QL queries guide (#101634)
* Page structure

* More getting started content

* Fix build errors

* Small improvements

* Typo

* Add link to public demo environment

* Review feedback

* Update docs/reference/esql/esql-get-started.asciidoc

Co-authored-by: Andrei Stefan <astefan@users.noreply.github.com>

* Review feedback

---------

Co-authored-by: Andrei Stefan <astefan@users.noreply.github.com>
2023-11-03 13:47:09 +01:00
István Zoltán Szabó
9b404099b4
[DOCS] Adds links to token section in ESLER conceptual. (#101033) 2023-10-18 11:30:38 +02:00
István Zoltán Szabó
446ac9f378
[DOCS] Updates ELSER tutorial with inference processor changes (#100420)
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@elastic.co>
2023-10-11 17:33:20 +02:00
Carlos Delgado
f2dfbfe8c4
[DOCS] Add sparse-vector field type to docs, changed references (#100348) 2023-10-06 14:25:27 +02:00
István Zoltán Szabó
9d01def3dc
[DOCS] Changes semantic search tutorials to use ELSER v2 and sparse_vector field type (#100021)
* [DOCS] Changes semantic search tutorials to use ELSER v2 and sparse_vector field type.

* [DOCS] More edits.
2023-09-29 09:24:36 +02:00
James Rodewig
73293dca86
[DOCS] Remove unused widgets (#98953)
No-op change to remove a few unused Asciidoc widgets. These aren't referenced or published anywhere in the docs.
2023-08-29 07:53:26 -04:00
James Rodewig
31408bddc1
[DOCS] Add $ELASTIC_PASSWORD env var to install docs (#98898)
- Removes duplicated security autoconfiguration output from the docs. This is difficult to keep updated and makes the docs longer.
- Encourages the user to store the `elastic` password as an environment variable. Users don't need to rely on curl's password prompts.
- Removes unused `api-call-widget` files. These aren't published anywhere in the docs currently.
2023-08-28 08:25:13 -04:00
Dianna Hohensee
a25e176692
Add node "roles" to allocation explain response (#98550)
Report node "roles" in the /_cluster/allocation/explain response.
Nodes with limited sets of roles may affect shard distribution in ways
users did not originally consider, so it is helpful to surface this
information along with node allocation decision explanations.
2023-08-23 08:30:35 -04:00
David Kilfoyle
4d3069a986
Fix broken links to Cloud snapshot restore info (#98213) 2023-08-04 16:38:27 -04:00
Jeffrey Chu
7797e27689
Update cpu-usage.asciidoc (#97883)
In 8.8.2, Column `name` contains the node name, instead of column `node`
2023-07-24 13:47:06 +02:00
Abdon Pijpelink
40409bf8ca
[DOCS] Semantic search page (#97715)
Co-authored-by: István Zoltán Szabó <istvan.szabo@elastic.co>
Co-authored-by: David Roberts <dave.roberts@elastic.co>
2023-07-20 10:45:13 +02:00
Pablo Alcantar Morales
253fe6325d
Add shards capacity troubleshooting guide (#95208) 2023-04-19 09:24:07 +02:00
Andrei Dan
9170113036
[HealthAPI] Add support for the FEATURE_STATE affected resource (#92296)
The `shards_availability` indicator diagnoses the condition where
indices need to be restored from snapshot.
Starting with 8.0 using feature_states when restoring from snapshot is
mandatory.

This adds support for the `FEATURE_STATE` affected resource to aid with
building up the snapshot restore API call (which will need to include
all the indices and feature states reported by the restore-from-snapshot
diagnosis).

Note that the health API will not report any indices that are part of a
feature state.
2022-12-20 13:39:41 +00:00
Mary Gouseti
cfd23d512f
Disk indicator troubleshooting guides (#90504) 2022-10-14 15:24:21 +02:00
James Baiera
db73aa0498
Add repeated snapshot failure troubleshooting guide (#89762)
This troubleshooting guide is what will be returned from the SLM health indicator 
when a SLM policy has suffered from too many repeat failures without a successful 
execution.
2022-09-15 17:01:32 -04:00
Iraklis Psaroudakis
d83ed3315a
Re-registering corrupt repository unblocks it (#89719)
Fixes #89130
2022-09-12 20:21:35 +03:00
Mary Gouseti
89903bbe23
Troubleshooting docs for ACTION_RESTORE_FROM_SNAPSHOT (#87692)
Troubleshooting guide to restore indices and data streams that have
missing data from a snapshot.

This will be associated with the user action
`ACTION_RESTORE_FROM_SNAPSHOT`.

Preview link:
https://elasticsearch_87692.docs-preview.app.elstc.co/guide/en/elasticsearch/reference/master/restore-from-snapshot.html
2022-07-27 23:37:08 +09:30
Mary Gouseti
0f670404f6
Fix Note in troubleshooting docs (#88846) 2022-07-27 14:31:06 +02:00
Andrei Dan
f3431e1bff
Add troubleshooting guide for corrupt repository (#88391)
Co-authored-by: Lee Hinman <dakrone@users.noreply.github.com>
2022-07-14 13:37:02 +01:00
Andrei Dan
3e1242b63e
Replace ilm/slm with their full names (#88060) 2022-06-30 09:44:46 +01:00
Andrei Dan
4e869860d6
Fix StableMasterHealthIndicatorServiceTests and start-slm doc test (#87962) 2022-06-23 12:48:25 +01:00
Andrei Dan
6e98072db5
Add start slm user action (#87854)
This creates a user action for the slm health indicator that will help
the user to start SLM.
2022-06-23 11:04:45 +01:00
Andrei Dan
a4e7064b0e
Create ILM not running user action (#87852)
This creates a user action for the ilm health indicator that will help
the user to start ILM.
2022-06-23 09:54:31 +01:00
Andrei Dan
2ec4a9e006
Add troubleshooting doc for missing tier (#87526)
Co-authored-by: Lee Hinman <dakrone@users.noreply.github.com>
2022-06-17 12:24:33 +01:00
Keith Massey
6caf39c109
How to increase node capacity docs (#87188)
This adds troubleshooting documentation for the case when the ShardsAvailabilityHealthIndicatorService
reports that there are not enough nodes in the data tier (user action "increase_node_capacity_for_allocations" or
"increase_tier_capacity_for_allocations_". This covers both the cloud and self-managed environments. For
cloud we first recommend increasing the number of availability zones (because you cannot directly add nodes), and
decreasing index.number_of_replicas if that is not possible. For self-managed, we first recommend adding nodes,
and decreasing index.number_of_replicas if that is not possible.
2022-06-08 14:06:47 -05:00
Andrei Dan
15b8fc3151
Fix troubleshooting doc tab to point to self-managed (#87465)
This fixes the Self Managed tab to load the
self-managed instructions.
2022-06-07 16:29:54 +01:00
Andrei Dan
3fb60a1551
Update get kibana guide in troubleshooting docs (#87075) 2022-05-25 16:11:18 +01:00
Andrei Dan
08b323131f
Troubleshooting guides for disabled allocations (#86789)
This adds the troubleshooing guides when index and cluster allocations are
disabled.

Co-authored-by: Lee Hinman <dakrone@users.noreply.github.com>
2022-05-24 10:27:15 +01:00
Andrei Dan
20802a9f66
Add migrate to tiers troubleshooting doc (#86738)
This adds a troubleshooting doc for indices that mix index filtering allocation
with data tiers routing.

Co-authored-by: Lee Hinman <dakrone@users.noreply.github.com>
2022-05-24 10:12:28 +01:00
Andrei Dan
490f417efd
Troubleshooting guide for diagnosing unassigned shards (#86996)
Co-authored-by: Leaf-Lin <39002973+Leaf-Lin@users.noreply.github.com>
Co-authored-by: Lee Hinman <dakrone@users.noreply.github.com>
2022-05-24 09:56:23 +01:00
Andrei Dan
21785c9a77
How-to docs for increasing the total number of shards per node (#86214)
Co-authored-by: Lee Hinman <dakrone@users.noreply.github.com>
Co-authored-by: Leaf-Lin <39002973+Leaf-Lin@users.noreply.github.com>
2022-05-10 09:13:27 +01:00
Adam Locke
336965201b
[DOCS] Update quickstart curl commands (#86145)
* [DOCS] Update quickstart curl commands

* Change Kibana container name
2022-04-27 08:43:00 -04: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
James Rodewig
8ac973f0df
[DOCS] Remove compress param from example snippets (#82994)
Per [this comment](https://github.com/elastic/elasticsearch/pull/56827#discussion_r425928626) in #56827, we don't need to highlight the `compress` parameter. The parameter defaults to `true` anyway.
2022-01-24 17:11:18 -05:00
James Rodewig
9003d10dcf
[DOCS] Update ES quick start for Cloud UI (#82499)
Changes:

* Updates the Cloud setup instructions to note that you open Kibana by default.
* Reorders the API call section to highlight Kibana.
* Fixes the Docker `ifeval` to hide some text on unreleased branches.
2022-01-13 07:46:04 -05:00
James Rodewig
ff89ee0beb
[DOCS] Remove Windows MSI installer package (#81952) (#81957)
After 7.16.2, we'll no longer produce Windows MSI installer packages for Elasticsearch. These packages were previously released in beta and didn't receive widespread adoption.

### Changes:

* Adds a related 7.17 breaking change.
* Adds a related 7.16 deprecation.
* Removes the MSI installation instructions.
* Removes references to the MSI installer.

I plan to port the applicable changes to 8.1 (main), 8.0, 7.17, and 7.16. In the 7.16 ports, I'll leave in the MSI install docs and add related deprecation notes to them instead.
2021-12-20 13:49:32 -05:00
Adam Locke
247d124666
[DOCS] Update ES quick start for security ON by default (#80735)
* [DOCS] Update ES quick start for security ON by default

* Remove code.asciidoc, which is part of the overall doc build now

* Update node names for cleanup

* Add note with links to tools

* Add --net elastic network

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2021-11-17 17:48:07 -05:00
James Rodewig
659e0d3fd3
[DOCS] Overhaul snapshot and restore docs (#79081)
Makes several changes to consolidate snapshot and backup-related docs.

Highlights:

* Adds info about supported ESS snapshot repository types
* Adds docs for Kibana's Snapshot and Restore feature
* Combines tutorial pages related to taking and managing snapshots
* Consolidates explanations of the snapshot process
* Incorporates SLM into the snapshot tutorial
* Removes duplicate "back up a cluster" pages
2021-11-15 12:45:07 -05:00
Joe Gallo
4a14f2f6f9
Validate that snapshot repository exists for ILM policies at creation/update time (#78468) 2021-10-04 15:19:10 -04:00
James Rodewig
485e7deaa0
[DOCS] Re-add docs for multiple data paths (MDP) (#78342)
We deprecated support for multiple data paths (MDP) in 7.13. However,
we won't remove support until after 8.0.

Changes:

* Reverts PR #72267, which removed MDP docs
* Removes a related item from the 8.0 breaking changes.
2021-09-28 09:20:45 -04:00
James Rodewig
bb9587351e
[DOCS] Fix typos (#76875) 2021-08-24 08:47:12 -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
76938006ab
[DOCS] Note required node roles and data tiers (#74566)
Closes #74528 and #74565
2021-07-07 09:57:32 -04:00
James Rodewig
ba66669eb3
[DOCS] Rename mount types for searchable snapshots (#72699)
Changes:

* Renames 'full copy searchable snapshot' to 'fully mounted index.'
* Renames 'shared cache searchable snapshot' to 'partially mounted index.'
* Removes some unneeded cache setup instructions for the frozen tier. We added a default cache size with #71844.
2021-05-05 16:35:33 -04:00
David Kilfoyle
c1c5e67f37
[DOCS] Remove frozen tier restriction for ESS (#72624)
* Remove frozen tier restriction for ESS

* Remove section from 'Use ES for time series data'

Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com>
2021-05-03 15:39:14 -07:00
James Rodewig
0f02783139 [DOCS] Remove unneeded words 2021-04-28 08:51:56 -04:00
James Rodewig
f8666b930f
[DOCS] Add 'Fix common cluster issues' docs (#72097) 2021-04-28 08:28:51 -04:00