A365 SDK → Microsoft.OpenTelemetry Distro Migration

When to Use

• User asks to "migrate from A365 SDK" or "switch to the distro"
• Project references Microsoft.Agents.A365.Observability.* packages
• User mentions ConfigureOpenTelemetry(), AddA365Tracing(), Builder class, or TokenStore

Procedure

1. Analyze Current State

Scan the project for A365 SDK patterns. See analysis template.

Look for:

• Microsoft.Agents.A365.Observability.* package references
• builder.ConfigureOpenTelemetry()
• builder.AddA365Tracing(config => { ... })
• Agent365ExporterOptions / TokenStore
• Builder class (fluent API from A365 SDK)

2. Swap Packages

See package swap.

Remove A365 observability + individual OTel packages. Add Microsoft.OpenTelemetry.

3. Rewrite Program.cs

See Program.cs migration.

Replace ConfigureOpenTelemetry() + AddA365Tracing() with UseMicrosoftOpenTelemetry().

4. Migrate Token Resolver

See token resolver migration.

Replace TokenStore pattern with DI token cache or custom resolver.

5. Migrate Baggage / Middleware

See baggage middleware migration.

6. Handle API Differences

See API differences.

7. Migrate Auto-Instrumentation Config

See auto-instrumentation migration.

8. Validate

See validation checklist.

• Build succeeds
• No references to removed APIs
• Console exporter shows spans with identity attributes
• Agent responds correctly