From d6d686859f852bc415f0803d1cd62249b2a95394 Mon Sep 17 00:00:00 2001 From: George Ng Date: Tue, 1 Sep 2026 00:40:35 -0700 Subject: [PATCH 1/3] Update documentation for local telemetry debugging --- .../telemetry/local-telemetry-debugging.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/ts/docs/architecture/telemetry/local-telemetry-debugging.md b/ts/docs/architecture/telemetry/local-telemetry-debugging.md index b0e17b3855..9b5657a86a 100644 --- a/ts/docs/architecture/telemetry/local-telemetry-debugging.md +++ b/ts/docs/architecture/telemetry/local-telemetry-debugging.md @@ -25,6 +25,17 @@ stack, and enables local telemetry in `config.local.yaml`. If the command changes `telemetry.local`, restart TypeAgent once so it picks up the configuration. Send a request, then open [Grafana](http://127.0.0.1:24319) to inspect traces and logs. +Traces are available in the response metadata of every request (printed by default in the CLI and on-hover for other experiences). + +In TypeAgent, run: + +``` +@trace typeagent* +@log profile diagnostic +``` + +The @trace typeagent\* command enables all debug logs in the typeagent namespace. +The @log profile diagnostic command enables all structured + debug logs to be captured locally. For setup details, queries, cleanup, and troubleshooting, continue below. From 17441128dc65005e089bcace0927a243896b018c Mon Sep 17 00:00:00 2001 From: George Ng Date: Tue, 1 Sep 2026 00:41:36 -0700 Subject: [PATCH 2/3] Fix typo From ae32b39bd0d56befb00251f4be9dd333a4374855 Mon Sep 17 00:00:00 2001 From: George Ng Date: Tue, 1 Sep 2026 00:43:41 -0700 Subject: [PATCH 3/3] Add additional details --- ts/docs/architecture/telemetry/local-telemetry-debugging.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ts/docs/architecture/telemetry/local-telemetry-debugging.md b/ts/docs/architecture/telemetry/local-telemetry-debugging.md index 9b5657a86a..e322f5f369 100644 --- a/ts/docs/architecture/telemetry/local-telemetry-debugging.md +++ b/ts/docs/architecture/telemetry/local-telemetry-debugging.md @@ -24,7 +24,7 @@ stack, and enables local telemetry in `config.local.yaml`. If the command changes `telemetry.local`, restart TypeAgent once so it picks up the configuration. Send a request, then open -[Grafana](http://127.0.0.1:24319) to inspect traces and logs. +[Grafana](http://127.0.0.1:24319) to inspect traces and logs via Explore > Tempo. Traces are available in the response metadata of every request (printed by default in the CLI and on-hover for other experiences). In TypeAgent, run: