Melic.AgentFramework.Observability.Sessions 0.1.0

Melic.AgentFramework.Observability

OpenTelemetry-native observability for the Microsoft Agent Framework (MAF). Adds session identity tracking, per-session token aggregation, custom business tags, optional session-scoped parent spans, tool-call span enrichment, and export-boundary telemetry redaction — all without modifying MAF internals.

Packages

Quick Start

using Melic.AgentFramework.Observability.Redaction;
using Melic.AgentFramework.Observability.Sessions;
using Melic.AgentFramework.Observability.Tools;
using OpenTelemetry;
using OpenTelemetry.Trace;

// Register the middleware (order matters: UseOpenTelemetry must be outermost)
var agent = new AIAgentBuilder(innerAgent)
    .UseOpenTelemetry()       // outermost — creates the invoke_agent span
    .UseSessionTelemetry()    // innermost — enriches the open span
    .UseToolTelemetry()       // enriches execute_tool spans for tools
    .Build();

// Each AgentSession gets a stable, auto-generated session ID automatically.
// Optionally assign your own:
session.AssignSessionId("order-42");

// Optionally attach business context tags:
session.SetSessionTag("tenant.id", "contoso");
session.SetSessionTag("user.tier", "premium");

using var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddSource("Experimental.Microsoft.Agents.AI")
    .AddSource("Melic.AgentFramework.Observability.Sessions")
    .AddSource("Melic.AgentFramework.Observability.Tools")
    .AddTelemetryRedaction()
    .AddConsoleExporter()
    .Build();

Installing the metapackage is the recommended entrypoint for most consumers. If you only want part of the suite, you can still install Sessions, Tools, and Redaction individually.

Key Features

• Zero-config session IDs — every session gets a stable genai.session.id automatically
• Token aggregation — genai.session.input_tokens and genai.session.output_tokens accumulate across all turns
• Custom tags — attach arbitrary genai.* business context to every span in a session
• Mode B tracing — opt-in explicit parent span via BeginSessionTrace() for visual trace trees
• Tool-call enrichment — adds stable genai.tool.* attributes to MAF execute_tool spans
• Payload diagnostics — optional valid-JSON input and output capture with bounded size
• Retry detection — repeated tool call ids are marked with retry attributes within the current invocation
• Telemetry redaction — selected high-risk tool and GenAI attributes can be masked before export
• OTel-only dependencies — depends only on OpenTelemetry.Api, no MAF internals

Documentation

Full technical documentation — including deployment patterns, stateless REST API guidance, public API reference, and the complete telemetry schema — lives in the GitHub repository:

• Sessions package — full reference
• Tools package — full reference
• Redaction package — full reference

Links

• GitHub repository
• Microsoft Agent Framework
• OpenTelemetry .NET