@@ -250,7 +250,7 @@ cat kafka-metrics-sum.csv | docker exec -i clickstack-demo \
250250 clickhouse-client --query "INSERT INTO otel_metrics_sum FORMAT CSVWithNames"
251251` ` `
252252
253- # ### Verify metrics in HyperDX {#verify-metrics}
253+ # ### Verify metrics in HyperDX {#verify-demo- metrics}
254254
255255Once loaded, the quickest way to see your metrics is through the pre-built dashboard.
256256
@@ -298,6 +298,7 @@ For the demo dataset, ensure the time range is set to 2025-11-05 16:00:00 to 202
298298# ### No metrics appearing in HyperDX {#no-metrics}
299299
300300**Verify API key is set and passed to the container:**
301+
301302` ` ` bash
302303# Check environment variable
303304echo $CLICKSTACK_API_KEY
@@ -323,11 +324,13 @@ LIMIT 10
323324` ` `
324325
325326If no results, check the JMX exporter logs :
327+
326328` ` ` bash
327329docker compose logs kafka-jmx-exporter | grep -i "error\| connection" | tail -10
328330` ` `
329331
330332**Generate Kafka activity to populate metrics:**
333+
331334` ` ` bash
332335# Create a test topic
333336docker exec kafka bash -c "unset JMX_PORT && kafka-topics --create --topic test-topic --bootstrap-server kafka:9092 --partitions 3 --replication-factor 1"
@@ -342,6 +345,7 @@ If you see `Authorization failed` or `401 Unauthorized`:
342345
3433461. Verify the API key in HyperDX UI (Settings → API Keys → Ingestion API Key)
3443472. Re-export and restart :
348+
345349` ` ` bash
346350export CLICKSTACK_API_KEY=your-correct-api-key
347351docker compose down
@@ -351,7 +355,8 @@ docker compose up -d
351355# ### Port conflicts with Kafka client commands {#port-conflicts}
352356
353357When running Kafka commands from within the Kafka container, you may see :
354- ` ` `
358+
359+ ` ` ` bash
355360Error: Port already in use: 9999
356361` ` `
357362
0 commit comments