From 9bf2cba203b29b4f9b3aa32887a0822ff50153a6 Mon Sep 17 00:00:00 2001
From: Stefan <stefan@starflinger.eu>
Date: Sat, 6 Jun 2026 13:12:16 +0200
Subject: [PATCH] docs(cli): mark loki as deprecated in favor of ClickHouse
 logs

Loki is being retired for container logs. Add a deprecation note to the loki
command's short/long help pointing users at the ClickHouse OTel log tables
(external.otel_logs hosted, otel.otel_logs local) queried via
'panda clickhouse query'.
---
 pkg/cli/loki_cmd.go | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/pkg/cli/loki_cmd.go b/pkg/cli/loki_cmd.go
index d5d0ea51..9f2fbd1c 100644
--- a/pkg/cli/loki_cmd.go
+++ b/pkg/cli/loki_cmd.go
@@ -20,9 +20,14 @@ var (
 var lokiCmd = &cobra.Command{
 	GroupID: groupDirect,
 	Use:     "loki",
-	Short:   "Query Loki logs",
+	Short:   "Query Loki logs (deprecated: use ClickHouse logs)",
 	Long: `Query Loki for log data.
 
+DEPRECATED: Loki is being retired for container logs. Query the ClickHouse OTel
+log tables instead via 'panda clickhouse query':
+  • Hosted (multi-VM) devnets/testnets → external.otel_logs  (filter ResourceAttributes['network'])
+  • Local Kurtosis devnets            → otel.otel_logs       (filter EnclaveName)
+
 Examples:
   panda loki list-datasources
   panda loki query ethpandaops '{app="beacon-node"}'