New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[DOCS] Add API example + diagrams to shard allocation awareness docs #108390
Conversation
Documentation preview: |
Pinging @elastic/es-docs (Team:Docs) |
Pinging @elastic/es-distributed (Team:Distributed) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good, thanks @shainaraskas. I left a few tiny nits.
if you want Elasticsearch to distribute shards across different racks, you might | ||
set an awareness attribute called `rack_id` in each node's `elasticsearch.yml` | ||
config file. | ||
. In each node's `elasticsearch.yml` config file, specify the location of each node |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You can specify the location of each node with a custom node attribute by setting a value in elasticsearch.yml
or using the -E
command line argument. I agree that it'd be good to mention that the setting goes in elasticsearch.yml
, but the first sentence in this paragraph should really apply to both methods.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thanks @DaveCTurner! I've restructured this step to take your feedback into consideration:
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM and diagrams are clear 💯
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM thanks @shainaraskas
Based on customer feedback, adds an example cluster update settings API call inline for the shard allocation awareness docs. To address concerns about how to use zones in clusters overall, I added a note to the Resilience in larger clusters guidance. could consider adding diagrams to that resilience doc down the line as a part of the suggested architectures work.
Also adds diagrams so the relationship between shards and nodes given a specific node attribute is clearer.
platform docs reviewers: I kinda made these diagrams up. what do you think?
Changed pages