From 9d3164621a8bb0e2bbf8d2309fba1d8678c0abe2 Mon Sep 17 00:00:00 2001 From: smhendrickson Date: Wed, 23 Jul 2025 17:48:24 -0400 Subject: add `--telemetry-outfile` flag (#4689) --- docs/telemetry.md | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'docs') diff --git a/docs/telemetry.md b/docs/telemetry.md index 76958794..2209ee0b 100644 --- a/docs/telemetry.md +++ b/docs/telemetry.md @@ -19,6 +19,7 @@ The following lists the precedence for applying telemetry settings, with items l - `--telemetry-target `: Overrides `telemetry.target`. - `--telemetry-otlp-endpoint `: Overrides `telemetry.otlpEndpoint`. - `--telemetry-log-prompts` / `--no-telemetry-log-prompts`: Overrides `telemetry.logPrompts`. + - `--telemetry-outfile `: Redirects telemetry output to a file. See [Exporting to a file](#exporting-to-a-file). 1. **Environment variables:** - `OTEL_EXPORTER_OTLP_ENDPOINT`: Overrides `telemetry.otlpEndpoint`. @@ -50,6 +51,16 @@ The following code can be added to your workspace (`.gemini/settings.json`) or u } ``` +### Exporting to a file + +You can export all telemetry data to a file for local inspection. + +To enable file export, use the `--telemetry-outfile` flag with a path to your desired output file. This must be run using `--telemetry-target=local`. + +```bash +gemini --telemetry --telemetry-target=local --telemetry-outfile=/path/to/telemetry.log "your prompt" +``` + ## Running an OTEL Collector An OTEL Collector is a service that receives, processes, and exports telemetry data. -- cgit v1.2.3