Skip to content

docs(traceai): Gemini Go tracing (TH-8273) - #970

Merged
nik13 merged 6 commits into
mainfrom
feat/th-8273-gemini-go
Nov 6, 2026
Merged

nik13 merged 6 commits into
mainfrom
feat/th-8273-gemini-go

Conversation

@nik13

@nik13 nik13 commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds the Gemini Go guide for the released github.com/future-agi/traceAI/go/genai v0.1.1 module. Covers the standard OTLP/HTTP exporter, sessions, streaming, tool calls and embeddings. Linear: TH-8273 (parent TH-8103).

  • Documents released token counts, embedding spans, declaration filtering and FI_HIDE_ERROR_DETAILS behavior.
  • Keeps custom agent/tool spans metadata-only. Explains that text-only switches do not redact arbitrary aggregate attributes passed to v0.1.1 SetAttributes, and that console output is separate from telemetry.
  • Registers gemini-go in the shared integration catalog under Model providers with the Google logo.
  • Includes the complete runnable example and page-contract checks.

Validation

GitHub CI exercises the example and released transport with synthetic Gemini responses on Google Gen AI SDK v1.71.0 and v1.75.0. Coverage includes streamed/non-streamed calls, individual and combined text switches, full input/output hiding, metadata and parent-child preservation, error privacy, and the documented SetAttributes boundary. Standard catalog, link, build and browser checks remain enabled.

Requires Go 1.26 or later; the integration uses OpenTelemetry Go v1.47.0.

🤖 Generated with Claude Code

nik13 and others added 2 commits October 16, 2026 05:40
New page src/pages/docs/integrations/traceai/go/gemini.mdx for the
traceAI Go module github.com/future-agi/traceAI/go/genai (traceAI
PR #262): google.golang.org/genai traced through ClientConfig.HTTPClient,
Gemini Developer API backend, tested on genai v1.75.0 and v1.71.0.
States what is and isn't captured, the traceAI FI_HIDE_* privacy
switches, errors/retries/continuation, Vertex and the retired
generative-ai-go module as not supported, and troubleshooting.

Runnable assets in examples/traceai/gemini-go/ (main.go, run_e2e.sh,
README, tests that keep the page snippets in step with main.go).
navigation.ts is not touched (nav PR adds the page).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ple (TH-8273)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
nik13 and others added 3 commits October 21, 2026 15:06
…e (TH-8273)

The page goes live only after traceAI#262 is merged and go/genai is tagged, so the
"until the PR is merged, fetch the PR commit" note would be stale on the live page.
Same for the example README. Install stays go get .../go/genai@latest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Code <noreply@anthropic.com>
The guide described pre-release behavior: embeddings passing through
untraced, input tokens from promptTokenCount only, zero counts never
written, and privacy switches without FI_HIDE_ERROR_DETAILS or the
name-only declaration filtering. go/genai v0.1.1 traces EmbedContent,
adds toolUsePromptTokenCount, keeps reported zeros and ships both
privacy changes, so the page now documents that release and pins it.

It also removes internal test narration (tested-surface table row,
dated version check, privacy-test sentence) and the QA runner and its
marker instructions from the example folder, registers the page in the
integration catalog so it is discoverable, and replaces the Python
page test that CI never ran with a node contract test in
test:integrations.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 marked this pull request as ready for review November 6, 2026 05:40
The released v0.1.1 SetAttributes helper does not redact arbitrary aggregate values under text-only hiding. Remove prompt, answer and tool payload attributes from custom spans, document that boundary, and exercise the actual example and released transport in GitHub CI across both supported SDK versions.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 merged commit ebace5f into main Nov 6, 2026
10 checks passed
@nik13
nik13 deleted the feat/th-8273-gemini-go branch November 6, 2026 07:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant