Skip to content

Conversation

@tlrx
Copy link
Member

@tlrx tlrx commented Oct 9, 2023

Co-authored-by: David Turner david.turner@elastic.co

@tlrx tlrx added >docs General docs changes :Distributed Coordination/Snapshot/Restore Anything directly related to the `_snapshot/*` APIs v8.11.1 v8.10.4 labels Oct 9, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Oct 9, 2023

Documentation preview:

@elasticsearchmachine elasticsearchmachine added Team:Distributed (Obsolete) Meta label for distributed team (obsolete). Replaced by Distributed Indexing/Coordination. v8.12.0 Team:Docs Meta label for docs team labels Oct 9, 2023
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-docs (Team:Docs)

@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-distributed (Team:Distributed)

Copy link
Contributor

@DaveCTurner DaveCTurner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suspect that this will not completely redirect these questions away from the ES team. How about something a little more explicit like this?

Most storage systems can be configured to log the details of their interaction
with {es}. If you are investigating a suspected incompatibility with AWS S3, it
is usually simplest to collect these logs and provide them to the supplier of
your storage system for further analysis. If the incompatibility is not clear
from the logs emitted by the storage system, configure {es} to log every
request it makes to the S3 API by <<configuring-logging-levels,setting the
logging level>> of the `com.amazonaws.request` logger to `DEBUG`:

[source,console]
----
PUT /_cluster/settings
{
  "persistent": {
    "logger.com.amazonaws.request": "DEBUG"
  }
}
----
// TEST[skip:we don't really want to change this logger]

The supplier of your storage system will be able to analyse these logs to determine the problem. See
the https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html[AWS Java SDK]
documentation for further information.

@tlrx
Copy link
Member Author

tlrx commented Oct 9, 2023

This is much better indeed, I stole your suggestion without any change.

@tlrx tlrx requested a review from DaveCTurner October 9, 2023 11:39
Copy link
Contributor

@DaveCTurner DaveCTurner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@tlrx tlrx merged commit 583a787 into elastic:main Oct 12, 2023
@tlrx tlrx deleted the 2023/10/09/mention-awsd-sdk-request-logging branch October 12, 2023 07:48
tlrx added a commit to tlrx/elasticsearch that referenced this pull request Oct 12, 2023
…0491)

Co-authored-by: David Turner david.turner@elastic.co
@elasticsearchmachine
Copy link
Collaborator

💚 Backport successful

Status Branch Result
8.11
8.10

tlrx added a commit to tlrx/elasticsearch that referenced this pull request Oct 12, 2023
…0491)

Co-authored-by: David Turner david.turner@elastic.co
elasticsearchmachine pushed a commit that referenced this pull request Oct 12, 2023
…100748)

Co-authored-by: David Turner david.turner@elastic.co
elasticsearchmachine pushed a commit that referenced this pull request Oct 12, 2023
…100749)

Co-authored-by: David Turner david.turner@elastic.co
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

:Distributed Coordination/Snapshot/Restore Anything directly related to the `_snapshot/*` APIs >docs General docs changes Team:Distributed (Obsolete) Meta label for distributed team (obsolete). Replaced by Distributed Indexing/Coordination. Team:Docs Meta label for docs team v8.10.4 v8.11.1 v8.12.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants