Updating data sources docs # 7680

[AntonEliatra]

Description

Updating data sources documentation

Issues Resolved

Closes #7680

Version

2.11-2.16

Checklist

• By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
  For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[github-actions]

Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Editorial review -> Merged.

Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer.

When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference). The doc reviewer will arrange for an editorial review.

[derek-ho]

This mainly looks good to me, but I am no longer working on the feature. @RyanL1997 may be a better person/we probably want him to look over this once.

[derek-ho]

I don't know if this is accurate anymore, since I think these two pages merged?

[AntonEliatra]

@derek-ho As far as I'm aware the pages are due to be merged in future versions, possibly 2.17, the current state (from 2.11 to current) is still via two separate pages.

[RyanL1997]

we have merged the experience in 2.16. So this is correct.

[hdhalter]

Sorry for the confusion, @AntonEliatra! They DID make changes in 2.16 to the UI. Since the release is today (8/7), you should be able to see the updates tomorrow in the playground for testing purposes. In addition, @RyanL1997 is going to capture a video of the new flow and add it to a doc issue.

We'll have to update the rest of documentation for the new changes post-2.16.

[vagimeli]

@RyanL1997 I don't see the option Management > Data sources in my local environment running 2.16. I only have the option to go through Dashboards Management. Please let me know if Management > Data sources is available in 2.16. Please review lines 39--41 and make any necessary changes for technical accuracy.

[RyanL1997]

we have merged the experience in 2.16. So this is correct.

[RyanL1997]

For this one we may need to change the picture. Since the old datasource in observability has been unregistered

[RyanL1997]

User can use the create button and navi to the card view for selection:

[AntonEliatra]

@RyanL1997 Which version of OS are you using? With 2.15 I'm not able to see the view that you pasted above.

[Naarcha-AWS]

@AntonEliatra: The screenshots are from 2.16. We should be releasing in the next couple of days.

[AntonEliatra]

@Naarcha-AWS Should I change the version in the PR details to 2.15, as this will still be relevant?

[hdhalter]

Sorry for the confusion, @AntonEliatra! They DID make changes in 2.16 to the UI. Since the release is today (8/7), you should be able to see the updates tomorrow in the playground for testing purposes. In addition, @RyanL1997 is going to capture a video of the new flow and add it to a doc issue.

We'll have to update the rest of documentation for the new changes post-2.16.

[RyanL1997]

Hi folks, thanks for the fast follow up and here is the issue I created with some details of flow diffs: #7948, feel free to drop some comments/thoughts if you have some questions. Thanks.

[AntonEliatra]

I'm working on updating the documentation based on the above. I think some effort is needed in explaining the difference between Zero-ETL and Managed Data Streams (MDS) before jumping into "How-to", as this can be a point of confusion for many users

[AntonEliatra]

@RyanL1997 are you able to confirm when does the user need to configure :
plugins.query.datasources.encryption.masterkey

[vagimeli]

I'm working on updating the documentation based on the above. I think some effort is needed in explaining the difference between Zero-ETL and Managed Data Streams (MDS) before jumping into "How-to", as this can be a point of confusion for many users

@AntonEliatra @RyanL1997 Suggested text: When the multiple data sources feature is disabled (data_source.enabled: false), you can only see and work with local, unmanaged data sources on your cluster, and cannot work with or manage multiple data sources.