docs: Getting started sandbox

docs/sources/tempo/getting-started/docker-example.md

@@ -3,8 +3,19 @@ title: Quick start for Tempo
 menuTitle: Quick start for Tempo
 description: Use Docker to quickly view traces using K-6 and Tempo
 weight: 600
+killercoda:
+  title: Quick start for Tempo
+  description: Use Docker to quickly view traces using K-6 and Tempo
+  details:
+      intro:
+         foreground: docker-compose-update.sh
+  backend:
+    backend:
+    imageid: ubuntu
 ---
 
+<!-- INTERACTIVE page intro.md START -->
+
 # Quick start for Tempo
 
 The Tempo repository provides [multiple examples](https://github.com/grafana/tempo/tree/main/example/docker-compose) to help you quickly get started using Tempo and distributed tracing data.
@@ -13,26 +24,42 @@ Every example has a `docker-compose.yaml` manifest that includes all of the opti
 
 The Tempo examples running with Docker using docker-compose include a version of Tempo and a storage configuration suitable for testing or development.
 
-This quick start guide uses the `local` example running Tempo as a single binary (monolithic). Any data is stored locally in the `tempo-data` folder.
-To learn more, read the [local storage example README](https://github.com/grafana/tempo/blob/main/example/docker-compose/local).
 
-## Alternative: Complete MLTP example
-
-If you would like to use a demo with Tempo, Mimir, Loki, and Grafana, then try the [Introduction to Metrics, Logs, Traces, and Profiling in Grafana](https://github.com/grafana/intro-to-mlt).
-`Intro-to-mltp` provides a self-contained environment for learning about Mimir, Loki, Tempo, and Grafana.
-The project includes detailed explanations of each component and annotated configurations for a single-instance deployment.
-Data from `intro-to-mltp` can also be pushed to Grafana Cloud.
+<!-- INTERACTIVE ignore START -->
 
 ## Before you begin
 
 To follow this guide, you need:
 
 - Git
-- Docker
-- The docker-compose plugin
+- [Docker](https://docs.docker.com/compose/install/)
+- The Docker Compose plugin (included with Docker Desktop)
+
+{{< admonition type="tip" >}}
+Alternatively, you can try out this example in our interactive learning environment: [Quick start for Tempo](https://killercoda.com/grafana-labs/course/tempo/quick-start).
+
+It's a fully configured environment with all the dependencies installed.
+
+Provide feedback, report bugs, and raise issues in the [Grafana Killercoda repository](https://github.com/grafana/killercoda).
+{{< /admonition >}}
+
+<!-- INTERACTIVE ignore END -->
+
+{{<docs/ignore>}}
+{{< admonition type="tip" >}}
+A setup script is running in the background to install the necessary dependencies. This should take no longer than 30 seconds. Your instance will be ready to use once you `Setup complete. You may now begin the tutorial`.
+{{< /admonition >}}
+{{</docs/ignore>}}
+
+<!-- INTERACTIVE page intro.md END -->
+
+<!-- INTERACTIVE page step1.md START -->
 
 ## Clone the Tempo repository and start Docker
 
+This quick start guide uses the `local` example running Tempo as a single binary (monolithic). Any data is stored locally in the `tempo-data` folder.
+To learn more, read the [local storage example README](https://github.com/grafana/tempo/blob/main/example/docker-compose/local).
+
 1. Clone the Tempo repository:
    ```bash
    git clone https://github.com/grafana/tempo.git
@@ -48,7 +75,12 @@ To follow this guide, you need:
    docker compose up -d
    ```
 
-1. Verify that the services are running using `docker compose ps`. You should see something like:
+1. Verify that the services are running:
+   ```bash
+   docker compose ps
+   ``` 
+
+   You should see something like:
    ```console
    docker compose ps
    NAME                 COMMAND                  SERVICE             STATUS              PORTS
@@ -58,16 +90,52 @@ To follow this guide, you need:
    local-tempo-1        "/tempo -config.file…"   tempo               running             0.0.0.0:3200->3200/tcp, 0.0.0.0:4317-4318->4317-4318/tcp, 0.0.0.0:9411->9411/tcp, 0.0.0.0:14268->14268/tcp
    ```
 
-1. As part of the docker compose manifest, Grafana is now accessible on port 3000. Open a browser to localhost:3000 and sign in to Grafana.
+<!-- INTERACTIVE page step1.md END -->
+
+<!-- INTERACTIVE page step2.md START -->
+
+## Explore the traces in Grafana
+
+As part of the Docker Compose manifest, Grafana is now accessible on port 3000. 
+You can use Grafana to explore the traces generated by the k6-tracing service.
+
+1. Open a browser and navigate to [http://localhost:3000](http://localhost:3000).
 
 1. Once logged in, navigate to the **Explore** page, select the **Tempo** data source and select the **Search** tab. Select **Run query** to list the recent traces stored in Tempo. Select one to view the trace diagram:
-    <p align="center"><img src="../../setup/assets/setup-linux-run-query.png" alt="Query example"></p>
+
+   {{< figure align="center" src="/media/docs/grafana/data-sources/tempo/query-editor/tempo-ds-builder-span-details-v11.png" alt="Use the query builder to explore tracing data in Grafana" >}}
+
 
-1. A couple of minutes after Tempo has started up successfully, select the **Service graph** tab for the Tempo data source in the **Explore** page. Select **Run query** to view a service graph, generated by Tempo’s metrics-generator.
-    <p align="center"><img src="../../setup/assets/setup-linux-node-graph.png" alt="Service graph sample"></p>
+1. A couple of minutes after Tempo starts, select the **Service graph** tab for the Tempo data source in the **Explore** page. Select **Run query** to view a service graph, generated by Tempo’s metrics-generator.
+
+   {{< figure align="center" src="/media/docs/grafana/data-sources/tempo/query-editor/tempo-ds-query-service-graph.png" alt="Service graph sample" >}}
 
 1. To stop the services:
-    ```
+    ```bash
     docker compose down -v
     ```
 
+<!-- INTERACTIVE page step2.md END -->
+
+<!-- INTERACTIVE page finish.md START -->
+
+## Next steps
+
+You have successfully set up Tempo and Grafana to explore traces generated by the k6-tracing service.
+
+### Alternative: Complete MLTP example
+
+If you would like to use a demo with multiple telemetry signals, then try the [Introduction to Metrics, Logs, Traces, and Profiling in Grafana](https://github.com/grafana/intro-to-mlt).
+`Intro-to-mltp` provides a self-contained environment for learning about Mimir, Loki, Tempo, Pyroscope, and Grafana.
+The project includes detailed explanations of each component and annotated configurations for a single-instance deployment.
+Data from `intro-to-mltp` can also be pushed to Grafana Cloud.
+
+### Further reading
+Here are some resources to help you learn more about Tempo:
+* [Instrumenting your application](https://grafana.com/docs/tempo/<TEMPO_VERSION>/getting-started/instrumentation/)
+* [Setup guides for Tempo](https://grafana.com/docs/tempo/<TEMPO_VERSION>/setup/)
+
+
+<!-- INTERACTIVE page finish.md END -->
+
+<!-- INTERACTIVE page START -->