Skip to content

Latest commit

 

History

History
79 lines (61 loc) · 5.07 KB

telemetry.md

File metadata and controls

79 lines (61 loc) · 5.07 KB

Product usage data

The T3 Code server sends product usage events to T3 Code's own endpoint at ingest.t3.codes, associated with a hashed account or installation identifier. To count how many installations one person uses, the server also sends hashed account identifiers: your T3 Connect account, your OpenAI and Claude accounts when you are signed in, and a random identifier for each device that connects. The endpoint keeps a copy of each event and forwards events to PostHog. Events include the provider, model, reasoning effort, permission mode, turn and request results, duration, release channel, and token counts when available. Child-agent token counts are reported separately from the main agent's. Model names are sent only when they appear in a provider's public model list.

Product events do not include prompts, responses, file contents, authentication tokens, conversation IDs, raw provider events, or child-agent output.

Relay connection diagnostics

T3 Code sends relay connection traces to Axiom to diagnose T3 Connect connectivity. These are separate from product events. Depending on the client version, traces can include connection timings, environment identifiers and the connected machine's name. Failed spans can include error messages and stack traces; error text can quote a value the app was handling.

To disable product events and relay tracing from the server, set T3CODE_TELEMETRY_ENABLED=false in its environment before starting it. Relay tracing also stops when T3CODE_OTEL_SDK_DISABLED or OTEL_SDK_DISABLED turns OpenTelemetry export off.

An administrator can turn product events and relay tracing off in the server and desktop app with a managed policy. This does not control traces sent by separate browser or mobile clients.

The desktop app reads T3CODE_TELEMETRY_ENABLED from your shell profile (for example ~/.zshrc) on macOS and Linux, so export it there and restart the app. On Windows, set it as a user environment variable.

The web app in a browser, including one the t3 CLI opens, does not read these environment variables. When its build has relay tracing configured, it sends its own connection traces even if the server has opted out. The browser app has no relay tracing toggle.

Mobile app diagnostics

When the iOS or Android app crashes or hits an error, it sends a report to T3 Code: the error message, the stack trace, the app version, and the device model and OS version. Each launch also sends startup timings, and every report carries a random ID for the install. Reports go through the T3 Connect relay to Axiom. They do not include your threads, prompts, or connection details, but an error message can quote a value the app was handling.

To stop sending them, turn off Send crash reports in Settings > About T3 Code > Diagnostics.

The mobile app also sends relay connection traces when its build has tracing configured. These carry an identifier for the current app session. Send crash reports does not control these traces, and the mobile app has no separate relay tracing toggle. Server environment variables and managed policy do not disable mobile tracing.

Agent activity for mobile notifications

When Publish agent activity is enabled on a host, it sends project and thread titles, model names, activity status, and environment and thread identifiers to the T3 Connect relay for mobile notifications and live activities. This is separate from product events and relay diagnostics. The telemetry opt-out does not disable it.

To stop publishing, turn off Publish agent activity under Settings > Sharing & access on the host. Turning off notifications on a phone controls that phone's alerts, not the host's publishing setting.

Export diagnostics to your own receiver

To send traces, metrics, or logs to an OpenTelemetry receiver, open Settings > Maintenance > Diagnostics, select an environment, and enter each signal's OTLP HTTP endpoint under OpenTelemetry export (for example http://localhost:4318/v1/traces). Save, then restart that environment's server. The receiver must be reachable from the server's machine. Test sends an empty export from the server to check an endpoint before or after you save it; saved endpoints are checked when the section opens. Checks send authentication headers only to the signal's currently running endpoint and do not follow redirects. To check a new endpoint that requires authentication, save it and restart the server first.

T3CODE_OTLP_*_URL and standard OTEL_EXPORTER_OTLP_* environment variables override the saved settings. An overridden signal shows Set by environment and names the variable that set it, and its Test checks the running endpoint instead of the field. For endpoints saved here or set with T3CODE_OTLP_*_URL, set T3CODE_OTLP_HEADERS for receivers that need authentication and T3CODE_OTLP_PROTOCOL=http/protobuf for receivers that do not accept JSON. An endpoint set with OTEL_EXPORTER_OTLP_* takes its headers and protocol from OTEL_EXPORTER_OTLP_HEADERS and OTEL_EXPORTER_OTLP_PROTOCOL instead.