Skip to content

docs(openinference): add native Go tracing setup - #1095

Merged
nik13 merged 3 commits into
mainfrom
docs/openinference-go-native
Nov 4, 2026
Merged

nik13 merged 3 commits into
mainfrom
docs/openinference-go-native

Conversation

@nik13

@nik13 nik13 commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add a runnable Go setup to the existing OpenInference guide using published OpenInference context helpers and the standard OpenTelemetry OTLP/HTTP exporter. No additional Future AGI package or copied instrumentation helper is needed.
  • Configure the full trace endpoint, authentication headers and project resource; preserve session/user context and parent links; flush spans before exit. Explain manual-span privacy and using a single tracing provider to avoid duplicate spans.
  • Keep the integration catalog aligned and add a floor/latest CI matrix that runs the exact documentation snippet, decodes real protobuf/gzip exports, and checks the captured bytes with the production collector converter.

Reproduction and validation

  • Before the fix, the new exact-guide test fails on main with guide must provide one runnable Go setup; found 0 Go snippets.
  • Floor: Go 1.25.0, OpenInference v0.1.0, OpenTelemetry v1.43.0 — go test -race -count=1 -v ./... passes.
  • Latest: Go 1.26.10, OpenInference v0.1.2, OpenTelemetry v1.47.0 — the same tests pass with GOFLAGS='-modfile=latest.mod -mod=readonly'. CI also checks the Go 1.26.0 minimum for this dependency set.
  • Both runs use loopback-only networking and synthetic credentials. Production conversion is checked against future-agi commit 814b6c4e745e754dc2eeb43a4d238d318adc4daa, using the existing scripts/crewai-ingestion-check adapter rather than a copied semantic mapper.
  • Assertions cover the trace path, auth/content headers, project resources, exact span counts, parent/trace IDs, session/user context, model/token fields, metadata/tags and absence of context values in baggage.
  • npm run test:integrations: 20 passed; npm run check:integrations: passed; npm run audit-links: no broken links; npm run build: passed.
  • Rendered the built guide with Playwright and an isolated Chrome profile; checked code blocks, Go/privacy anchors, and desktop screenshots.

Scope

This documents manual Go application spans and their native export; it does not claim provider auto-instrumentation from importing the context helpers alone. No live model or Cloud credentials were used, and no live Observe screenshot is claimed. All installed modules are already published; no SDK release, registry publication, product change or merge is included.

🤖 Generated with Claude Code

nik13 and others added 3 commits November 2, 2026 07:34
Exercise the exact guide with published floor/latest dependencies, real OTLP/HTTP exports, and the production ingestion converter. Keep manual-span privacy and single-provider ownership explicit.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Qualify automatic error mapping and execute the documented manual error pattern on both dependency sets. Assert exported exception events and production-converted status, including nil-error and RecordError-only controls.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Preserve the Python, TypeScript and Java guides while placing the Go setup in its own tab. Cover all four language tabs in the Go guide contract.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 merged commit 460f156 into main Nov 4, 2026
16 checks passed
@nik13
nik13 deleted the docs/openinference-go-native branch November 4, 2026 17:14
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