All Apps and Add-ons

auto run splunk tour

renems
Communicator

I made a nice splunk tour. Only thing I'd like to accomplish, is to have it started automatically for all of our splunk users. Somehow I can't get it done. Not much documentation to fall back upon.

How do I have my product tour to auto-start?

I'm aware that you can run it by adding "?tour=" to a dashboard, but that makes it essential to run that dashboard. I'd prefer a solution where it just pops up, kind of like the product tour splunk by default brings to the table.

1 Solution

ebond_splunk
Splunk Employee
Splunk Employee

Hi @renems

To make a tour auto start, all you have to do is name the tour the same id(name) of the dashboard/view with "-tour" appended to it.
For example:
If you have a dashboard named "Foo Dashboard", Splunk will give it the id of "foo_dashboard" and it's accessed by the url "app/search/foo_dashboard"... if you name the tour "foo_dashboard-tour", it will automatically pop up a request to take the tour.

so the tour in etc/system/local/ui-tour.conf would look like this:

[foo_dashboard-tour]
....

NOTE: Once the user takes the tour or skips it from the dialog, an attribute is set on that tour that it has been viewed and the auto popup will no longer happen. To override this and have the tour prompt happen each time, you need to set an attribute of "viewed = 0" to the tour.

Hope this helps! If you need anymore detailed help, drop me an email.

View solution in original post

renems
Communicator

Thank you Eric, this was exactly what I was looking for!

0 Karma

renems
Communicator

I also noticed that the text in the pop-up is customizable by using "intro = some text" in the ui-tour.conf. Thought I'd mention this for others who stumble into this issue.

ebond_splunk
Splunk Employee
Splunk Employee

Yep! good catch.

0 Karma

ebond_splunk
Splunk Employee
Splunk Employee

Hi @renems

To make a tour auto start, all you have to do is name the tour the same id(name) of the dashboard/view with "-tour" appended to it.
For example:
If you have a dashboard named "Foo Dashboard", Splunk will give it the id of "foo_dashboard" and it's accessed by the url "app/search/foo_dashboard"... if you name the tour "foo_dashboard-tour", it will automatically pop up a request to take the tour.

so the tour in etc/system/local/ui-tour.conf would look like this:

[foo_dashboard-tour]
....

NOTE: Once the user takes the tour or skips it from the dialog, an attribute is set on that tour that it has been viewed and the auto popup will no longer happen. To override this and have the tour prompt happen each time, you need to set an attribute of "viewed = 0" to the tour.

Hope this helps! If you need anymore detailed help, drop me an email.

ejahnke
Explorer

Is this still applicable? It doesn't seem to work in my case. I appended the "-tour" suffix to the ID of the dashboard, but it doens't start when I view the dashboard. (Tried it with a test user)

0 Karma
Get Updates on the Splunk Community!

Routing logs with Splunk OTel Collector for Kubernetes

The Splunk Distribution of the OpenTelemetry (OTel) Collector is a product that provides a way to ingest ...

Welcome to the Splunk Community!

(view in My Videos) We're so glad you're here! The Splunk Community is place to connect, learn, give back, and ...

Tech Talk | Elevating Digital Service Excellence: The Synergy of Splunk RUM & APM

Elevating Digital Service Excellence: The Synergy of Real User Monitoring and Application Performance ...