Squad Observability: Tracing Agents with OpenTelemetry

squad aspire

import { initSquadTelemetry } from '@bradygaster/squad-sdk';

// One call — everything lights up when OTEL_EXPORTER_OTLP_ENDPOINT is set
const telemetry = initSquadTelemetry();

// Access the cost tracker for manual queries
console.log(telemetry.costTracker.formatSummary());

// Access the event bus for custom subscriptions
telemetry.eventBus.on('agent.session.complete', (event) => {
  console.log('Session complete:', event);
});

// Graceful shutdown — flushes pending spans
await telemetry.shutdown();

import { initAgentModeTelemetry } from '@bradygaster/squad-sdk';

const telemetry = initAgentModeTelemetry({
  endpoint: 'http://localhost:4317',
});

import { getTracer, getMeter } from '@bradygaster/squad-sdk';

const tracer = getTracer('my-extension');
const meter = getMeter('my-extension');

// Create a custom span
const span = tracer.startSpan('my-operation');
span.setAttribute('custom.attribute', 'value');
span.end();

// Create a custom counter
const counter = meter.createCounter('my.events', { unit: 'events' });
counter.add(1, { 'event.type': 'my-event' });

builder.Services.AddOpenTelemetry()
    .WithTracing(t => t.AddSource(SquadAgentDiagnostics.ActivitySourceName));

builder.Services.AddSquadAgent(o =>
{
    o.SquadFolderPath = @"C:\path\to\team-root";
    o.OnSubagentTrace = (traceEvent) =>
    {
        if (traceEvent.Kind == SquadAgentTraceEventKind.SubagentStarted)
        {
            Console.WriteLine($"Agent started: {traceEvent.SubagentDisplayName}");
        }
    };
});

import { CostTracker } from '@bradygaster/squad-sdk';

const tracker = new CostTracker();

// Wire to EventBus for automatic updates
const unwire = tracker.wireToEventBus(eventBus);

// Get a formatted summary
console.log(tracker.formatSummary());
// e.g.:
// Session cost summary:
//   Keyser (claude-sonnet-4): 1,240 in / 892 out — $0.0024
//   McManus (claude-haiku-4.5): 380 in / 201 out — $0.0003
//   Total: 1,620 in / 1,093 out — $0.0027

// Get structured data
const summary = tracker.getSummary();
for (const [name, entry] of summary.agents) {
  console.log(`${name}: $${entry.estimatedCost.toFixed(4)}`);
}

// Cleanup
unwire();

import { TelemetryCollector } from '@bradygaster/squad-sdk';

const collector = new TelemetryCollector({ enabled: false });

// User opts in
collector.setConsent(true);

// Collect events
collector.collectEvent({ name: 'squad.init' });
collector.collectEvent({ name: 'squad.agent.spawn', properties: { role: 'developer' } });

// Flush to endpoint
await collector.flush();