Merge pull request #340 from shuttle-hq/docs/betterstack-telemetry-clarification

Clarify Betterstack telemetry documentation

Author: shaaza

docs/telemetry/betterstack.mdx

@@ -9,7 +9,6 @@ This guide will walk you through setting up Better Stack as your telemetry provi
 ## Prerequisites
 
 1. A [Better Stack account](https://betterstack.com/) (sign up if you don't have one)
-2. A Shuttle project with the OpenTelemetry exporter enabled (see [Getting Started](./getting-started))
 
 ## Step 1: Create a Telemetry Source in Better Stack
 
@@ -38,12 +37,24 @@ This guide will walk you through setting up Better Stack as your telemetry provi
    - Paste your source token and ingestion host
    - Click "Apply"
 
+## Step 3: Enable OpenTelemetry Exporter (optional)
+
+<Note>
+    This step is only required if you want to emit custom metrics and logs from your application. If you only need the default CPU, network, and memory metrics, you can skip this step.
+</Note>
+
+Follow the [Getting Started guide](./getting-started#step-1-enable-the-opentelemetry-exporter) to enable the OpenTelemetry exporter in your project.
+
+## Step 4: Redeploy Your Project
+
 <Warning>
     **Important**: If your project was already running, you must redeploy it for telemetry to start flowing.
-    To redeploy, select your latest deployment in the Shuttle Console and click "Redeploy".
+    
+    - If you've made code changes (like adding custom metrics), redeploy using the Shuttle CLI: `shuttle deploy`
+    - If you haven't made any code changes, you can redeploy from the Shuttle Console by selecting your latest deployment and clicking "Redeploy"
 </Warning>
 
-## Step 3: Create Dashboards
+## Step 5: Create Dashboards
 
 Once telemetry data starts flowing, you can create custom dashboards in Better Stack:
 
@@ -73,14 +84,14 @@ Better Stack will receive all the standard Shuttle telemetry metrics, including:
 - Memory usage and limits
 - Network I/O statistics
 - Disk I/O statistics
-- Custom metrics from your application
+- Custom metrics from your application (requires OpenTelemetry exporter from Step 3)
 
 For a complete list of available metrics, see our [telemetry overview](./overview#default-platform-metrics).
 
 ## Troubleshooting
 
 If you don't see data in Better Stack:
 1. Verify your source token and ingestion host are correct
-2. Check that your project has the `setup-otel-exporter` feature on `shuttle-runtime` enabled
+2. If you're using custom metrics, check that your project has the `setup-otel-exporter` feature on `shuttle-runtime` enabled
 3. Ensure you've redeployed your project after enabling telemetry
 4. Contact [Better Stack support](https://betterstack.com/contact) or join our [Discord community](https://discord.gg/shuttle) for help

docs/telemetry/getting-started.mdx

@@ -51,7 +51,7 @@ Follow the specific guide for your chosen provider to:
 
 <Warning>
     **Important**: After configuring telemetry, you **_must_** redeploy your project for the changes to take effect.
-    You can do this by selecting your latest deployment in the Shuttle Console and clicking "Redeploy".
+    Since you've made code changes in Step 1 (adding the OpenTelemetry exporter), you need to deploy the changes using the Shuttle CLI.
 </Warning>
 
 ## Next Steps