Skip to content

Conversation

stefnestor
Copy link
Contributor

👋 howdy, team!

Our Slow Log docs are brief on their purpose during troubleshooting. This PR

  • shifts-up content related to both searching+indexing slow logs into a header global area, e.g. where/how edit+access, view current overrides, include triggering user info
  • adds on an indexing example event
  • adds in a how-to use in troubleshooting section, e.g. default starting commands & if circuit breaking need audit logging per this

TIA! 🙏

@stefnestor stefnestor added >enhancement >docs General docs changes Team:Docs Meta label for docs team Supportability Improve our (devs, SREs, support eng, users) ability to troubleshoot/self-service product better. labels Dec 11, 2024
@stefnestor stefnestor requested a review from a team December 11, 2024 23:55
Copy link
Contributor

Documentation preview:

@elasticsearchmachine
Copy link
Collaborator

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

@elasticsearchmachine elasticsearchmachine added the external-contributor Pull request authored by a developer outside the Elasticsearch team label Dec 11, 2024
@stefnestor stefnestor added auto-backport Automatically create backport pull requests when merged v8.17.0 labels Dec 12, 2024
Copy link
Contributor

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

👋 🎄 thanks for this! the overview is super helpful as is the general reshape of the doc. I broke it up a little further and did a language pass. if you're happy with the changes you can go ahead and ship :)

@stefnestor
Copy link
Contributor Author

⏳ tests are erring for "best practices" console blobs, had been because of missing commas in the JSON but now because

[[_all]] org.elasticsearch.index.IndexNotFoundException: no such index [[_all]]

which 🤷‍♀️ on how to fix since _all should wildcard to all indices in the ES cluster. So seeing what // NOTCONSOLE does since that's in other places to ignore tests. But TBF I expect I'll need help getting these consoles to pass, sorry, @shainaraskas 🙏

Copy link
Contributor

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

testing fixing tests

@shainaraskas
Copy link
Contributor

@stefnestor I got the tests passing 🎉 ready to go

@stefnestor stefnestor merged commit c8f2703 into elastic:main Dec 27, 2024
5 checks passed
@stefnestor
Copy link
Contributor Author

Thank you 🙇‍♀️, @shainaraskas !

@elasticsearchmachine
Copy link
Collaborator

💚 Backport successful

Status Branch Result
8.17
8.x

stefnestor added a commit to stefnestor/elasticsearch that referenced this pull request Dec 27, 2024
* (Doc+) Slow Logs

---------

Co-authored-by: shainaraskas <[email protected]>
stefnestor added a commit to stefnestor/elasticsearch that referenced this pull request Dec 27, 2024
* (Doc+) Slow Logs

---------

Co-authored-by: shainaraskas <[email protected]>
elasticsearchmachine pushed a commit that referenced this pull request Dec 27, 2024
* (Doc+) Slow Logs

---------

Co-authored-by: shainaraskas <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-backport Automatically create backport pull requests when merged >docs General docs changes >enhancement external-contributor Pull request authored by a developer outside the Elasticsearch team Supportability Improve our (devs, SREs, support eng, users) ability to troubleshoot/self-service product better. Team:Docs Meta label for docs team v8.17.0 v8.18.0 v9.0.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants