[8.14](backport #38534) [DOCS] Add the read_pipeline cluster privilege to winlogbeat documentation

[mergify]

Add the "read_pipeline" privilege to the Grant privileges and roles needed for publishing documentation as reported in the Grant access using API keys.

Proposed commit message

[Winlogbeat][Doc] Add read_pipeline cluster privilege to winlogbeat

Checklist

• My code follows the style guidelines of this project
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• I have made corresponding change to the default configuration files
• I have added tests that prove my fix is effective or that my feature works
• I have added an entry in CHANGELOG.next.asciidoc or CHANGELOG-developer.next.asciidoc.

Author's Checklist

• [ ]

How to test this PR locally

Related issues

• [Docs] Corrections needed for winlogbeat role privileges #39067

Use cases

Adhere to the least privilege principles

Screenshots

Logs

---

This is an automatic backport of pull request #38534 done by [Mergify](https://mergify.com).

[botelastic]

This pull request doesn't have a Team:<team> label.

[mergify]

This pull request has not been merged yet. Could you please review and merge it @herrBez? 🙏

[herrBez]

Hi there,

As I reported https://github.com/elastic/beats/pull/38534/files I noticed a rendering error
in the version https://www.elastic.co/guide/en/beats/filebeat/master/privileges-to-publish-events.html.

I am not entirely sure on how to fix that. I think:
-{beat_default_index_prefix}-*
Should actually become:
+-{beat_default_index_prefix}-*+

[mergify]

This pull request is now in conflicts. Could you fix it? 🙏
To fixup this pull request, you can check out it locally. See documentation: https://help.github.com/articles/checking-out-pull-requests-locally/

git fetch upstream
git checkout -b mergify/bp/8.14/pr-38534 upstream/mergify/bp/8.14/pr-38534
git merge upstream/8.14
git push upstream mergify/bp/8.14/pr-38534

[mergify]

This pull request has not been merged yet. Could you please review and merge it @herrBez? 🙏

[mergify]

This pull request has not been merged yet. Could you please review and merge it @herrBez? 🙏

[mergify]

This pull request has not been merged yet. Could you please review and merge it @herrBez? 🙏

[mergify]

This pull request has not been merged yet. Could you please review and merge it @herrBez? 🙏

[pierrehilbert]

@kilfoyle could you please have a look here?

[kilfoyle]

Suggested change

	rule `-{beat_default_index_prefix}-*` to the cluster settings
	rule `+-{beat_default_index_prefix}-*+` to the cluster settings

This would render like the following:

[kilfoyle]

I am not entirely sure on how to fix that. I think:
-{beat_default_index_prefix}-*
Should actually become:
+-{beat_default_index_prefix}-*+

@herrBez The suggestion above will add those + signs, if I understand correctly that that's what should be changed.

[herrBez]

Sorry, I want it to render to (e.g., filebeat-*). How can I achieve that :)? ASCIIDoc and variables are not my forte.

[kilfoyle]

Ah, I'm sorry! I misunderstood. I don't work with Beats much so I missed that {beat_default_index_prefix} is a variable. Variables won't be interpolated when they're inside backticks. So, I think the best we can do here is to take them out, like this:

rule {beat_default_index_prefix}-* to the cluster settings

[herrBez]

Thank you, I guess I got it (it should be the same as on the one on the right). How are you doing the rendering ? (To avoid this problem in the future :) )

[kilfoyle]

My pleasure Mirko! It looks good now.

To do the local rendering, you can:

• clone the elastic/docs repo
• have this doc_build_aliases file in the root of your local github directory

Then, use any of the aliases in that file with --open. For example:

• docbldfb --open - generates the Filebeat docs
• docbldim --open - generates the Fleet & Agent Guide

Most docs builds take just a minute or two. The largest, for Elasticsearch docs (dodbldes --open) takes about five minutes.