Make layout more consistent

clayton-cornell · clayton-cornell · commit 701bb38f9e19 · 2025-03-14T16:08:21.000-07:00
diff --git a/docs/sources/tutorials/scenarios/monitor-docker-containers.md b/docs/sources/tutorials/scenarios/monitor-docker-containers.md
@@ -40,19 +40,19 @@ cd alloy-scenarios/docker-monitoring
 docker compose up -d
 ```
 
-You can check the status of the containers by running the following command:
+You can check the status of the Docker containers by running the following command.
 
 ```shell
 docker ps
 ```
 
-## View the {{% param "PRODUCT_NAME" %}} UI
+## Monitor the health of your {{% param "PRODUCT_NAME" %}} deployment
 
 To monitor the health of your {{< param "PRODUCT_NAME" >}} deployment, open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
 
 Refer to [Debug Grafana Alloy](https://grafana.com/docs/alloy/latest/troubleshoot/debug/) for more information about the {{< param "PRODUCT_NAME" >}} UI.
 
-## Use the Grafana UI
+## Visualise your data
 
 To create a [dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) to visualise your metrics and logs, open your browser and navigate to [`http://localhost:3000/dashboards`](http://localhost:3000/dashboards).
 
diff --git a/docs/sources/tutorials/scenarios/monitor-kubernetes-logs.md b/docs/sources/tutorials/scenarios/monitor-kubernetes-logs.md
@@ -22,22 +22,27 @@ Loki is used to store the logs, Grafana is used to visualize the logs, and {{< p
 
 ## Before you begin
 
-* Git - You will need Git to clone the repository.
-* Docker - In this tutorial you use Docker containers to host the Grafana stack.
+This example requires:
+
+* Docker
+* Git
 
 ## Clone the repository
 
 ```shell
 git clone https://github.com/grafana/alloy-scenarios.git
 ```
 
+## Deploy
+
 Change to the directory:
 
 ```bash
 cd alloy-scenarios/k8s-logs
 ```
 
-Next you will need a Kubernetes cluster.
+## Create a local Kubernetes cluster
+
 In this example, we will configure a local Kubernetes cluster using [Kind](https://kind.sigs.k8s.io/docs/user/quick-start/).
 
 An example kind cluster configuration is provided in the `kind.yml` file.
@@ -47,7 +52,8 @@ To create a kind cluster using this configuration, run the following command:
 kind create cluster --config kind.yml
 ```
 
-You will need to make sure you install Helm on your local machine.
+## Install Helm
+
 You can install Helm by following the instructions [here](https://helm.sh/docs/intro/install/).
 You will also need to install the Grafana Helm repository:
 
@@ -155,3 +161,7 @@ helm install tempo grafana/tempo-distributed -n prod
 ```
 
 This will install the Tempo distributed tracing system in the `prod` namespace.
+
+## Understand the {{% param "PRODUCT_NAME" %}} configuration
+
+
diff --git a/docs/sources/tutorials/scenarios/monitor-logs-over-tcp.md b/docs/sources/tutorials/scenarios/monitor-logs-over-tcp.md
@@ -36,19 +36,25 @@ cd alloy-scenarios/logs-tcp
 docker compose up -d
 ```
 
-## View the {{% param "PRODUCT_NAME" %}} UI
+You can check the status of the Docker containers by running the following command.
 
-Open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
+```shell
+docker ps
+```
+
+## Monitor the health of your {{% param "PRODUCT_NAME" %}} deployment
+
+To monitor the health of your {{< param "PRODUCT_NAME" >}} deployment, open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
 
-With the Alloy UI, you can monitor the health of your Alloy deployment.
 Refer to [Debug Grafana Alloy](https://grafana.com/docs/alloy/latest/troubleshoot/debug/) for more information about the {{< param "PRODUCT_NAME" >}} UI.
 
-## Use the Grafana UI
+## Visualise your data
+
+To create a [dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) to visualise your metrics and logs, open your browser and navigate to [`http://localhost:3000/dashboards`](http://localhost:3000/dashboards).
 
-Open your browser and navigate to [`http://localhost:3000`](http://localhost:3000).
+To explore metrics, open your browser and navigate to [http://localhost:3000/explore/metrics](http://localhost:3000/explore/metrics).
 
-With the Grafana UI, you can create your own dashboards to create queries and visualize any aspect of your Docker container metrics and logs.
-Refer to [Build your first dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) for detailed information about dashboards in Grafana.
+To use the Grafana Logs Drilldown, open your browser and navigate to [http://localhost:3000/a/grafana-lokiexplore-app](http://localhost:3000/a/grafana-lokiexplore-app).
 
 ## Shut down the Grafana stack
 
diff --git a/docs/sources/tutorials/scenarios/monitor-syslog-messages.md b/docs/sources/tutorials/scenarios/monitor-syslog-messages.md
@@ -36,19 +36,25 @@ cd alloy-scenarios/syslog
 docker compose up -d
 ```
 
-## View the {{% param "PRODUCT_NAME" %}} UI
+You can check the status of the Docker containers by running the following command.
 
-Open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
+```shell
+docker ps
+```
+
+## Monitor the health of your {{% param "PRODUCT_NAME" %}} deployment
+
+To monitor the health of your {{< param "PRODUCT_NAME" >}} deployment, open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
 
-With the Alloy UI, you can monitor the health of your Alloy deployment.
 Refer to [Debug Grafana Alloy](https://grafana.com/docs/alloy/latest/troubleshoot/debug/) for more information about the {{< param "PRODUCT_NAME" >}} UI.
 
-## Use the Grafana UI
+## Visualise your data
+
+To create a [dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) to visualise your metrics and logs, open your browser and navigate to [`http://localhost:3000/dashboards`](http://localhost:3000/dashboards).
 
-Open your browser and navigate to [`http://localhost:3000`](http://localhost:3000).
+To explore metrics, open your browser and navigate to [http://localhost:3000/explore/metrics](http://localhost:3000/explore/metrics).
 
-With the Grafana UI, you can create your own dashboards to create queries and visualize any aspect of your Docker container metrics and logs.
-Refer to [Build your first dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) for detailed information about dashboards in Grafana.
+To use the Grafana Logs Drilldown, open your browser and navigate to [http://localhost:3000/a/grafana-lokiexplore-app](http://localhost:3000/a/grafana-lokiexplore-app).
 
 ## Shut down the Grafana stack
 
diff --git a/docs/sources/tutorials/scenarios/monitor-windows.md b/docs/sources/tutorials/scenarios/monitor-windows.md
@@ -9,7 +9,7 @@ weight: 400
 # Monitor Microsoft Windows servers and desktops with {{% param "FULL_PRODUCT_NAME" %}}
 
 You can use {{< param "FULL_PRODUCT_NAME" >}} to monitor Microsoft Windows servers and desktops.
-This scenario shows you how to install {{< param "PRODUCT_NAME" >}} in Windows and how to configure {{< param "PRODUCT_NAME" >}} to monitor the following system attributes:
+This example shows you how to install {{< param "PRODUCT_NAME" >}} in Windows and configure {{< param "PRODUCT_NAME" >}} to monitor the following system attributes:
 
 * Windows performance metrics
 * Windows event logs
@@ -50,23 +50,27 @@ You can check the status of the containers by running the following command:
 docker ps
 ```
 
-## Install {{% param "PRODUCT_NAME" %}}
+## Install {{% param "PRODUCT_NAME" %}} in Windows
 
-Follow the instructions in the [Grafana Alloy documentation](https://grafana.com/docs/alloy/latest/set-up/install/windows/) to install Grafana Alloy on your Windows machine.
+Follow the instructions in the [Grafana Alloy documentation](https://grafana.com/docs/alloy/latest/set-up/install/windows/) to install {{< param "PRODUCT_NAME" >}} on your Windows machine.
 
 Recommended steps:
 
-* Install Grafana Alloy as a Windows service.
-* Use Windows Installer to install Grafana Alloy.
+* Install {{< param "PRODUCT_NAME" >}} as a Windows service.
+* Use Windows Installer to install {{< param "PRODUCT_NAME" >}}.
 
 Make sure to also checkout the [Grafana Alloy configuration](https://grafana.com/docs/alloy/latest/set-up/configuration/) documentation.
 
-Personal recommendation: If you would like to see the Alloy UI from a remote machine you need to change the run arguments of the Grafana Alloy service. To do this:
+### Configure remote access to the {{% param "PRODUCT_NAME" %}} UI
+
+If you would like access the {{< param "PRODUCT_NAME" >}} UI from a remote machine you must change the runtime arguments of the {{< param "PRODUCT_NAME" >}} service.
+
+To configure the runtime arguments:
 
 1. Open Registry Editor.
-2. Navigate to `HKEY_LOCAL_MACHINE\SOFTWARE\GrafanaLabs\Alloy`.
-3. Double click on `Arguments`
-4. Change the contents to the following:
+1. Navigate to `HKEY_LOCAL_MACHINE\SOFTWARE\GrafanaLabs\Alloy`.
+1. Double click on `Arguments`
+1. Change the contents to the following:
 
    ```shell
    run
@@ -75,33 +79,37 @@ Personal recommendation: If you would like to see the Alloy UI from a remote mac
    --server.http.listen-addr=0.0.0.0:12345
    ```
 
-5. Restart the Grafana Alloy service.
+1. Restart the {{< param "PRODUCT_NAME" >}} service.
    Search for `Services` in the start menu, find `Grafana Alloy`, right click and restart.
 
-You should be able to access the Alloy UI from a remote machine by going to `http://<windows-machine-ip>:12345`.
+You should be able to access the {{< param "PRODUCT_NAME" >}} UI from a remote machine by going to `http://<windows-machine-ip>:12345`.
 
-## Configure {{% param "PRODUCT_NAME" %}} to Monitor Windows
+## Configure {{% param "PRODUCT_NAME" %}} to monitor Windows
 
 Now that you have Grafana Alloy installed, you need to configure it to monitor your Windows machine.
 Grafana Alloy will currently be running a default configuration file.
 This needs to be replaced with the `config.alloy` file that is included in the `alloy-scenarios/windows` directory.
 To do this:
 
-1. Stop the Grafana Alloy service.
+1. Stop the {{< param "PRODUCT_NAME" >}} service.
 1. Replace the `config.alloy` file in `C:\Program Files\GrafanaLabs\Alloy` with the `config.alloy` file from the `alloy-scenarios/windows` directory.
-1. Start the Grafana Alloy service.
-1. Open your browser and go to `http://localhost:12345` to access the Alloy UI.
+1. Start the {{< param "PRODUCT_NAME" >}} service.
+
+## Monitor the health of your {{% param "PRODUCT_NAME" %}} deployment
 
-## View the Windows Performance Metrics and Event Logs
+To monitor the health of your {{< param "PRODUCT_NAME" >}} deployment, open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
 
-You will now be able to view the Windows Performance Metrics and Event Logs in Grafana:
+Refer to [Debug Grafana Alloy](https://grafana.com/docs/alloy/latest/troubleshoot/debug/) for more information about the {{< param "PRODUCT_NAME" >}} UI.
 
-* Open your browser and go to [http://localhost:3000/explore/metrics](http://localhost:3000/explore/metrics).
-  This will take you to the metrics explorer in Grafana.
+## Visualise your data
 
-* Open your browser and go to [http://localhost:3000/a/grafana-lokiexplore-app](http://localhost:3000/a/grafana-lokiexplore-app).
-  This will take you to the Loki explorer in Grafana.
+To create a [dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) to visualise your metrics and logs, open your browser and navigate to [`http://localhost:3000/dashboards`](http://localhost:3000/dashboards).
 
+To explore metrics, open your browser and navigate to [http://localhost:3000/explore/metrics](http://localhost:3000/explore/metrics).
+
+To use the Grafana Logs Drilldown, open your browser and navigate to [http://localhost:3000/a/grafana-lokiexplore-app](http://localhost:3000/a/grafana-lokiexplore-app).
+
+## Understand the {{% param "PRODUCT_NAME" %}} configuration
 
 ```alloy
 // ####################################
@@ -191,4 +199,4 @@ loki.write "endpoint" {
 }
 
 livedebugging{}
-```
+```
diff --git a/docs/sources/tutorials/scenarios/parse-structured-logs.md b/docs/sources/tutorials/scenarios/parse-structured-logs.md
@@ -42,19 +42,19 @@ You can check the status of the containers by running the following command:
 docker ps
 ```
 
-## View the {{% param "PRODUCT_NAME" %}} UI
+## Monitor the health of your {{% param "PRODUCT_NAME" %}} deployment
 
-Open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
+To monitor the health of your {{< param "PRODUCT_NAME" >}} deployment, open your browser and navigate to [`http://localhost:12345`](http://localhost:12345).
 
-With the Alloy UI, you can monitor the health of your Alloy deployment.
 Refer to [Debug Grafana Alloy](https://grafana.com/docs/alloy/latest/troubleshoot/debug/) for more information about the {{< param "PRODUCT_NAME" >}} UI.
 
-## Use the Grafana UI
+## Visualise your data
 
-Open your browser and navigate to [`http://localhost:3000`](http://localhost:3000).
+To create a [dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) to visualise your metrics and logs, open your browser and navigate to [`http://localhost:3000/dashboards`](http://localhost:3000/dashboards).
 
-With the Grafana UI, you can create your own dashboards to create queries and visualize any aspect of your Docker container metrics and logs.
-Refer to [Build your first dashboard](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/#create-a-dashboard) for detailed information about dashboards in Grafana.
+To explore metrics, open your browser and navigate to [http://localhost:3000/explore/metrics](http://localhost:3000/explore/metrics).
+
+To use the Grafana Logs Drilldown, open your browser and navigate to [http://localhost:3000/a/grafana-lokiexplore-app](http://localhost:3000/a/grafana-lokiexplore-app).
 
 ## Shut down the Grafana stack
 
