Commit graph

12 commits

Author SHA1 Message Date
David Turner
20a1503001
Add docs about linearizable registers in repositories (#102050)
We don't mention linearizable registers in the snapshot/restore docs
today, but these things are verified for correctness by the repository
analysis API and some users with incorrect repository implementations
struggle to understand the verification errors. This commit adds some
docs to describe them and their various implementations.
2023-11-14 11:23:55 -05:00
David Turner
8572d6e618
Repo analysis: allow configuration of register ops (#102051)
Adds the `?register_operation_count` parameter that allows to control
the number of register operations separately from the number of regular
blob operations.
2023-11-13 02:20:23 -05:00
David Turner
f1c7436140
Note that repo analysis varies by version (#101762)
Clarifies that repo analysis may get stricter over time.
2023-11-03 11:15:19 +00:00
David Turner
a170d73b06
Suggest a strategy for using repo analysis (#101507)
Adds some docs to suggest running a sequence of increasingly large
analyses, and to set a very generous timeout.
2023-10-30 09:30:33 +00:00
Iraklis Psaroudakis
7bfc672eb4
Tie snapshot speed to node bandwidth settings (#91021)
If the recovery node bandwidth settings exist,
then the default value for max snapshot speed will
be infinite, and the speed will be rate limited
by the recovery rate limit as well.

Fixes #57023
2022-11-15 16:13:09 +02:00
David Turner
58703c3a79
Clarify what to do if repo analysis fails (#88267)
The docs for the repo analysis API don't really say how to react on a
failure. This commit adds a note about this case.
2022-07-05 06:45:23 -04:00
David Turner
1c4791e398
Abort writes in repo analyzer (#72077)
We rely on the repository implementation correctly handling the case where a
write is aborted before it completes. This is not guaranteed for third-party
repositories.

This commit adds a rare action during analysis which aborts the write
just before it completes and verifies that the target blob is not found
by any node.
2021-04-27 14:13:22 +01:00
James Rodewig
693807a6d3
[DOCS] Fix double spaces (#71082) 2021-03-31 09:57:47 -04:00
James Rodewig
d51a04cd8c
[DOCS] Add operator privileges to APIs and settings (#69903) 2021-03-15 09:20:09 -04:00
James Rodewig
9b88ae92e6
[DOCS] Fix typos for duplicate words (#69125) 2021-02-17 10:34:20 -05:00
David Turner
0ca9f6a4f0
Adjust repository analyzer docs (#69107)
Fixes a handful of typos/wording issues, and adds the new human-readable
fields to the response format docs.

Relates #67247
2021-02-17 13:50:42 +00:00
David Turner
92d13a3f7d
Introduce repository test kit/analyser (#67247)
Today we rely on blob stores behaving in a certain way so that they can be used
as a snapshot repository. There are an increasing number of third-party blob
stores that claim to be S3-compatible, but which may not offer a suitably
correct or performant implementation of the S3 API. We rely on somesubtle
semantics with concurrent readers and writers, but some blob stores may not
implement it correctly. Hitting a corner case in the implementation may be rare
in normal use, and may be hard to reproduce or to distinguish from an
Elasticsearch bug.

This commit introduces a new `POST /_snapshot/.../_analyse` API which exercises
the more problematic corners of the repository implementation looking for
correctness bugs and measures the details of the performance of the repository
under concurrent load.
2021-02-16 14:24:40 +00:00