Add an agent OpenTelemetry tracing example

[PratikDhanave (PratikDhanave)]

Go has otelprovider (an OpenTelemetry tracing middleware) but examples/ has no sample, unlike the .NET AgentOpenTelemetry sample.

Change

• New examples/02-agents/observability/step01_agent_tracing that installs a stdout OpenTelemetry tracer (stdouttrace, already a dependency) as the global provider and wraps a Foundry agent with otelprovider.NewMiddleware, so the run emits a gen_ai invoke_agent span (model, usage, finish reason) printed to stdout.
• Registered in cmd/verifyexamples (env-gated on FOUNDRY_PROJECT_ENDPOINT).

Builds, go vet, gofumpt clean; no go.mod changes; the verifyexamples test passes.

[Copilot]

Copilot review overview

🟡 Changes recommended

The example description claims a model attribute that the middleware does not emit.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1

Open (1)

• Align sample span model claim with middleware instrumentation · New

What changed in this PR

Adds an OpenTelemetry tracing example for Foundry agents and registers it with verifyexamples.

Changes:

• Exports agent spans to stdout.
• Registers environment-gated example verification.

File	Description
examples/​02-agents/​observability/​step01_agent_tracing/​main.go	New agent tracing sample
cmd/​verifyexamples/​examples.go	Registers the sample for verification

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[github-actions]

Scope: examples, tooling (internal-only)

Changed Go contract: None. This PR only adds a new example (examples/02-agents/observability/step01_agent_tracing/main.go) and registers it in cmd/verifyexamples/examples.go. No exported types, functions, or runtime defaults in library packages (agent, provider/otelprovider, etc.) are added or modified.

Upstream evidence reviewed:

• .NET: dotnet/samples/02-agents/AgentOpenTelemetry/Program.cs — configures an OTel TracerProvider/MeterProvider and runs a Foundry-backed agent, demonstrating gen_ai span emission for agent invocation.
• Python: python/samples/02-agents/observability/configure_otel_providers_with_env_var.py and sibling files in python/samples/02-agents/observability/ — show OTel provider configuration (env-var or parameter based) wrapping Foundry chat client / agent calls.

Result: Aligned. The new Go example fills a real coverage gap (Go had no observability sample even though otelprovider.NewMiddleware already exists) and is conceptually consistent with the upstream .NET/Python samples: it configures an OTel tracer provider (here, a stdouttrace exporter for simplicity, versus OTLP/Azure Monitor in .NET), sets it as the global provider, and wraps a Foundry agent so the run emits a gen_ai invoke_agent span. Using a stdout exporter instead of OTLP/Application Insights is an intentional simplification appropriate for a minimal, dependency-free sample and doesn't diverge from upstream semantics (span attributes, model/usage/finish-reason) which are produced by the existing, unchanged otelprovider middleware. The example follows existing Go example conventions (examples/internal/demo helper package, env-gated registration in verifyexamples). No public API surface changed, so the public-api-change label is not applicable.

Generated by Go API Consistency Review Agent · copilot · auto · 33.3 AIC · ⌖ 6.38 AIC · ⊞ 9.2K · ◷