Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Guided onboarding] Update observability tour #143006

Conversation

alisonelizabeth
Copy link
Contributor

@alisonelizabeth alisonelizabeth commented Oct 10, 2022

This PR updates the Observability product tour implemented in 8.4 to work with the new guided onboarding framework. The tour will now display as part of step 3 of the Kubernetes guide.

Fixes #140656

How to test

  1. Enable guided onboarding via your kibana.dev.yml file: guidedOnboarding.ui: true
  2. Start up Kibana with the example plugins enabled: yarn start --run-examples
  3. Navigate to /app/guidedOnboardingExample
  4. Use the "Set guide state" form to trigger step 3 of the Observability guide. Click save after setting the following values:
    Guide: observability
    Step ID: tour_observability
    
  5. Start the step. Verify the guide navigates the user to the Observability Overview page and the EuiTour displays.
  6. Complete the tour. Verify the step is completed and the guide panel reopens.
  7. All other tour behavior implemented via [Guided onboarding] Observability tour  #133909 should largely remain. Skipping a tour should complete the guide. If you leave the tour mid-tour and come back, the correct step should display. Clicking on the "Data assistant" button should also complete the guide.

Note: There is a bug right now when clicking on other links in the side nav with the tour in progress. This appears to be a regression introduced in the KibanaPageTemplate. I opened #143114 to track.

Demo

observ_tour.mp4

@alisonelizabeth alisonelizabeth added the Team:Journey/Onboarding Platform Journey Onboarding team label Oct 10, 2022
@alisonelizabeth alisonelizabeth added release_note:skip Skip the PR/issue when compiling release notes v8.6.0 labels Oct 11, 2022
@alisonelizabeth alisonelizabeth changed the title [Guided onboarding] [WIP] Update observability tour [Guided onboarding] Update observability tour Oct 12, 2022
await browser.removeLocalStorageItem(observTourStepStorageKey);
});

describe('Tour enabled', () => {
beforeEach(async () => {
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'm not sure if it makes sense to keep these tests around once #138568 is implemented, but thought it would be good to maintain them for now until we have a clearer picture of what our E2E testing looks like.

@alisonelizabeth alisonelizabeth marked this pull request as ready for review October 12, 2022 12:20
@alisonelizabeth alisonelizabeth requested review from a team as code owners October 12, 2022 12:20
@elasticmachine
Copy link
Contributor

Pinging @elastic/platform-onboarding (Team:Journey/Onboarding)

@alisonelizabeth alisonelizabeth added the ui-copy Review of UI copy with docs team is recommended label Oct 12, 2022
@botelastic botelastic bot added Team:APM All issues that need APM UI Team support Team:Uptime - DEPRECATED Synthetics & RUM sub-team of Application Observability labels Oct 12, 2022
@elasticmachine
Copy link
Contributor

Pinging @elastic/apm-ui (Team:APM)

@elasticmachine
Copy link
Contributor

Pinging @elastic/uptime (Team:uptime)

Copy link
Member

@legrego legrego left a comment

Choose a reason for hiding this comment

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

Import formatting changes in x-pack/plugins/security/public/management/roles/edit_role/privileges/kibana/feature_table/feature_table.tsx LGTM

Copy link
Contributor

@yuliacech yuliacech left a comment

Choose a reason for hiding this comment

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

Thanks a lot, @alisonelizabeth!
Tested locally and the tour works as expected, code changes LGTM too 🎉

@alisonelizabeth
Copy link
Contributor Author

@elasticmachine merge upstream

@alisonelizabeth
Copy link
Contributor Author

@elasticmachine merge upstream

@@ -16,7 +16,8 @@
"observability",
"ruleRegistry",
"unifiedSearch",
"lens"
"lens",
"guidedOnboarding"
Copy link
Member

Choose a reason for hiding this comment

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

Could you help me understand why this would have to become a dependency of the infra plugin?

Copy link
Contributor Author

@alisonelizabeth alisonelizabeth Oct 18, 2022

Choose a reason for hiding this comment

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

@weltenwort Happy path, the EuiTour steps render on the Overview page. However, if a user navigates away via the left nav during the tour, the tour steps should still render (e.g., to the “Stream” page). The tour logic lives within the shared Observability page template, and is dependent on the guidedOnboarding plugin.

Copy link
Member

Choose a reason for hiding this comment

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

I see, thanks for the explanation. But wouldn't the existing dependency on the observability plugin (through which the infra plugin renders the observability page template in the first place) already extend to the guidedOnboarding dependency transitively?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@weltenwort I went back and looked through the code, and I was able to inject it as a dependency when createLazyObservabilityPageTemplate is called. This should remove the need to make it a dependency of each plugin. Thanks for calling this out!

Copy link
Member

Choose a reason for hiding this comment

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

That's great, thanks for the thoroughness!

@kellyemurphy
Copy link
Contributor

@alisonelizabeth can we change the text on the final step of the setup guide? It shouldn't be a bullet point if there's only one and I think the text would read better as Get familiar with the rest of Elastic Observability and explore even more integrations.

@alisonelizabeth
Copy link
Contributor Author

alisonelizabeth commented Oct 19, 2022

@alisonelizabeth can we change the text on the final step of the setup guide? It shouldn't be a bullet point if there's only one and I think the text would read better as Get familiar with the rest of Elastic Observability and explore even more integrations.

Thanks @kellyemurphy! I've updated the copy (f8f28b4). The bullet point issue will be addressed via #143606.

@kibana-ci
Copy link
Collaborator

💚 Build Succeeded

Metrics [docs]

Public APIs missing comments

Total count of every public API that lacks a comment. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats comments for more detailed information.

id before after diff
observability 535 536 +1

Async chunks

Total size of all lazy-loaded chunks that will be downloaded as the user navigates the app

id before after diff
observability 521.7KB 522.0KB +345.0B

Page load bundle

Size of the bundles that are downloaded on every page load. Target size is below 100kb

id before after diff
guidedOnboarding 21.6KB 21.6KB +34.0B
observability 67.6KB 67.6KB +59.0B
total +93.0B
Unknown metric groups

API count

id before after diff
observability 539 540 +1

History

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

@alisonelizabeth alisonelizabeth merged commit 048b11d into elastic:main Oct 19, 2022
@kibanamachine kibanamachine added the backport:skip This commit does not require backporting label Oct 19, 2022
@alisonelizabeth alisonelizabeth deleted the guided_onboarding/observability_tour branch October 19, 2022 12:16
kc13greiner pushed a commit to kc13greiner/kibana that referenced this pull request Oct 19, 2022
guskovaue pushed a commit to guskovaue/kibana that referenced this pull request Oct 22, 2022
e40pud pushed a commit to e40pud/kibana that referenced this pull request Oct 24, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport:skip This commit does not require backporting release_note:skip Skip the PR/issue when compiling release notes Team:APM All issues that need APM UI Team support Team:Journey/Onboarding Platform Journey Onboarding team Team:Uptime - DEPRECATED Synthetics & RUM sub-team of Application Observability ui-copy Review of UI copy with docs team is recommended v8.6.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Guided onboarding] [Observability] Update 8.4 product tour
10 participants