openlit 1.11.0 → 1.13.0

package/dist/instrumentation/openai-agents/processor.js

@@ -0,0 +1,249 @@
+"use strict";
+/**
+ * OpenLIT OpenAI Agents TracingProcessor implementation.
+ *
+ * Integrates with the @openai/agents TracingProcessor interface.
+ * All span data fields are read at onSpanEnd (when fully populated).
+ * Compliant with OTel GenAI semantic conventions.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenLITTracingProcessor = void 0;
+const api_1 = require("@opentelemetry/api");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const semantic_convention_1 = __importDefault(require("../../semantic-convention"));
+const constant_1 = require("../../constant");
+const config_1 = __importDefault(require("../../config"));
+const helpers_1 = require("../../helpers");
+const utils_1 = require("./utils");
+const [OPENAI_SERVER_ADDRESS, OPENAI_SERVER_PORT] = (0, helpers_1.getServerAddressForProvider)('openai');
+const LLM_SPAN_TYPES = new Set(['response', 'generation']);
+/**
+ * TracingProcessor that emits OTel GenAI-compliant spans from
+ * the @openai/agents SDK tracing lifecycle.
+ *
+ * Thread-safe by design: each trace/span entry is keyed independently.
+ * LLM span types (response, generation) are skipped -- the OpenAI
+ * provider instrumentation handles those with richer telemetry.
+ */
+class OpenLITTracingProcessor {
+    constructor(tracer, agentCreationRegistry = null) {
+        // SDK span_id -> SpanEntry
+        this._otelSpans = new Map();
+        // SDK trace_id -> TraceEntry
+        this._rootSpans = new Map();
+        // trace_id -> group_id (conversation id)
+        this._traceGroupIds = new Map();
+        // Agent handoff tracker (bounded Map)
+        this._handoffTracker = new Map();
+        this._tracer = tracer;
+        this._agentCreationRegistry = agentCreationRegistry;
+    }
+    // ------------------------------------------------------------------
+    // Trace lifecycle
+    // ------------------------------------------------------------------
+    async onTraceStart(sdkTrace) {
+        try {
+            const traceId = sdkTrace.traceId ?? 'unknown';
+            const traceName = sdkTrace.name ?? 'workflow';
+            const groupId = sdkTrace.groupId ?? null;
+            const operation = semantic_convention_1.default.GEN_AI_OPERATION_TYPE_FRAMEWORK;
+            const spanName = `${operation} ${traceName}`;
+            const otelSpan = this._tracer.startSpan(spanName, {
+                kind: api_1.SpanKind.INTERNAL,
+                attributes: {
+                    [semantic_convention_1.default.GEN_AI_OPERATION]: operation,
+                    [semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL]: semantic_convention_1.default.GEN_AI_SYSTEM_OPENAI,
+                },
+            });
+            const startTime = Date.now();
+            this._rootSpans.set(traceId, { otelSpan, startTime });
+            if (groupId) {
+                this._traceGroupIds.set(traceId, String(groupId));
+            }
+            (0, helpers_1.setFrameworkParentContext)(api_1.trace.setSpan(api_1.context.active(), otelSpan));
+        }
+        catch {
+            // swallow
+        }
+    }
+    async onTraceEnd(sdkTrace) {
+        try {
+            const traceId = sdkTrace.traceId ?? 'unknown';
+            const traceName = sdkTrace.name ?? 'workflow';
+            const entry = this._rootSpans.get(traceId);
+            this._rootSpans.delete(traceId);
+            const groupId = this._traceGroupIds.get(traceId) ?? null;
+            this._traceGroupIds.delete(traceId);
+            if (!entry)
+                return;
+            const { otelSpan, startTime } = entry;
+            const endTime = Date.now();
+            const durationMs = endTime - startTime;
+            // Set common framework attributes
+            otelSpan.setAttribute(semantic_conventions_1.ATTR_TELEMETRY_SDK_NAME, constant_1.SDK_NAME);
+            otelSpan.setAttribute(semantic_convention_1.default.GEN_AI_SDK_VERSION, constant_1.SDK_VERSION);
+            otelSpan.setAttribute(semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL, semantic_convention_1.default.GEN_AI_SYSTEM_OPENAI);
+            otelSpan.setAttribute(semantic_convention_1.default.GEN_AI_OPERATION, semantic_convention_1.default.GEN_AI_OPERATION_TYPE_FRAMEWORK);
+            if (OPENAI_SERVER_ADDRESS) {
+                otelSpan.setAttribute(semantic_convention_1.default.SERVER_ADDRESS, OPENAI_SERVER_ADDRESS);
+                if (OPENAI_SERVER_PORT) {
+                    otelSpan.setAttribute(semantic_convention_1.default.SERVER_PORT, OPENAI_SERVER_PORT);
+                }
+            }
+            otelSpan.setAttribute(semantic_convention_1.default.ATTR_DEPLOYMENT_ENVIRONMENT, config_1.default.environment ?? 'default');
+            otelSpan.setAttribute(semantic_conventions_1.ATTR_SERVICE_NAME, config_1.default.applicationName ?? 'default');
+            otelSpan.setAttribute(semantic_convention_1.default.GEN_AI_CLIENT_OPERATION_DURATION, durationMs / 1000);
+            otelSpan.setAttribute(semantic_convention_1.default.GEN_AI_WORKFLOW_NAME, traceName);
+            if (groupId) {
+                otelSpan.setAttribute(semantic_convention_1.default.GEN_AI_CONVERSATION_ID, groupId);
+            }
+            (0, helpers_1.applyCustomSpanAttributes)(otelSpan);
+            // Error handling
+            const error = sdkTrace.error;
+            if (error) {
+                const errorType = typeof error === 'object' && error !== null
+                    ? error.constructor?.name || error.code || '_OTHER'
+                    : '_OTHER';
+                const errorMsg = typeof error === 'object' && error !== null
+                    ? error.message ?? String(error)
+                    : String(error);
+                otelSpan.setAttribute(semantic_convention_1.default.ERROR_TYPE, errorType);
+                otelSpan.setStatus({ code: api_1.SpanStatusCode.ERROR, message: errorMsg });
+            }
+            else {
+                otelSpan.setStatus({ code: api_1.SpanStatusCode.OK });
+            }
+            // Metrics
+            if (!config_1.default.disableMetrics) {
+                (0, utils_1.recordMetrics)(semantic_convention_1.default.GEN_AI_OPERATION_TYPE_FRAMEWORK, durationMs / 1000, null);
+            }
+            otelSpan.end();
+            (0, helpers_1.clearFrameworkParentContext)();
+        }
+        catch {
+            // swallow
+        }
+    }
+    // ------------------------------------------------------------------
+    // Span lifecycle
+    // ------------------------------------------------------------------
+    async onSpanStart(sdkSpan) {
+        try {
+            const spanData = sdkSpan.spanData;
+            const spanType = spanData?.type ?? 'unknown';
+            // Skip LLM span types -- let the OpenAI provider instrumentation handle them
+            if (LLM_SPAN_TYPES.has(spanType))
+                return;
+            const traceId = sdkSpan.traceId ?? 'unknown';
+            const sdkSpanId = sdkSpan.spanId ?? null;
+            const parentSdkId = sdkSpan.parentId ?? null;
+            const operation = (0, utils_1.getOperationType)(spanType);
+            const kind = (0, utils_1.getSpanKind)(operation);
+            const spanName = (0, utils_1.generateSpanName)(spanData);
+            // Find parent OTel span context
+            let parentCtx = api_1.context.active();
+            if (parentSdkId && this._otelSpans.has(parentSdkId)) {
+                const parentEntry = this._otelSpans.get(parentSdkId);
+                parentCtx = api_1.trace.setSpan(api_1.context.active(), parentEntry.otelSpan);
+            }
+            else if (this._rootSpans.has(traceId)) {
+                const rootEntry = this._rootSpans.get(traceId);
+                parentCtx = api_1.trace.setSpan(api_1.context.active(), rootEntry.otelSpan);
+            }
+            // Span links: connect invoke_agent back to create_agent
+            const links = [];
+            if (spanType === 'agent' && this._agentCreationRegistry) {
+                const agentName = spanData.name;
+                if (agentName) {
+                    const creationCtx = this._agentCreationRegistry.get(String(agentName));
+                    if (creationCtx) {
+                        links.push({ context: creationCtx, attributes: {} });
+                    }
+                }
+            }
+            const otelSpan = this._tracer.startSpan(spanName, {
+                kind,
+                links,
+                attributes: {
+                    [semantic_convention_1.default.GEN_AI_OPERATION]: operation,
+                    [semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL]: semantic_convention_1.default.GEN_AI_SYSTEM_OPENAI,
+                },
+            }, parentCtx);
+            const startTime = Date.now();
+            if (sdkSpanId) {
+                this._otelSpans.set(sdkSpanId, { otelSpan, startTime });
+            }
+            (0, helpers_1.setFrameworkParentContext)(api_1.trace.setSpan(parentCtx, otelSpan));
+        }
+        catch {
+            // swallow
+        }
+    }
+    async onSpanEnd(sdkSpan) {
+        try {
+            const spanData = sdkSpan.spanData;
+            const spanType = spanData?.type ?? 'unknown';
+            // Skip LLM span types
+            if (LLM_SPAN_TYPES.has(spanType))
+                return;
+            const sdkSpanId = sdkSpan.spanId ?? null;
+            const traceId = sdkSpan.traceId ?? 'unknown';
+            if (!sdkSpanId)
+                return;
+            const entry = this._otelSpans.get(sdkSpanId);
+            this._otelSpans.delete(sdkSpanId);
+            if (!entry)
+                return;
+            const { otelSpan, startTime } = entry;
+            const conversationId = this._traceGroupIds.get(traceId) ?? null;
+            (0, utils_1.processSpanEnd)(otelSpan, sdkSpan, startTime, conversationId, this._handoffTracker);
+            otelSpan.end();
+            // Restore parent context so subsequent provider spans nest correctly
+            const parentSdkId = sdkSpan.parentId ?? null;
+            if (parentSdkId && this._otelSpans.has(parentSdkId)) {
+                const parentEntry = this._otelSpans.get(parentSdkId);
+                (0, helpers_1.setFrameworkParentContext)(api_1.trace.setSpan(api_1.context.active(), parentEntry.otelSpan));
+            }
+            else if (this._rootSpans.has(traceId)) {
+                const rootEntry = this._rootSpans.get(traceId);
+                (0, helpers_1.setFrameworkParentContext)(api_1.trace.setSpan(api_1.context.active(), rootEntry.otelSpan));
+            }
+        }
+        catch {
+            // swallow
+        }
+    }
+    // ------------------------------------------------------------------
+    // Lifecycle management
+    // ------------------------------------------------------------------
+    async forceFlush() {
+        try {
+            for (const [, { otelSpan }] of this._otelSpans) {
+                try {
+                    otelSpan.end();
+                }
+                catch { /* ignore */ }
+            }
+            this._otelSpans.clear();
+            for (const [, { otelSpan }] of this._rootSpans) {
+                try {
+                    otelSpan.end();
+                }
+                catch { /* ignore */ }
+            }
+            this._rootSpans.clear();
+            this._traceGroupIds.clear();
+        }
+        catch {
+            // swallow
+        }
+    }
+    async shutdown() {
+        await this.forceFlush();
+    }
+}
+exports.OpenLITTracingProcessor = OpenLITTracingProcessor;
+//# sourceMappingURL=processor.js.map

package/dist/instrumentation/openai-agents/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../../../src/instrumentation/openai-agents/processor.ts"],"names":[],"mappings":"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"}

package/dist/instrumentation/openai-agents/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenAI Agents utilities for OTel GenAI semantic convention compliant telemetry.
+ *
+ * Maps SDK span types to OTel operation names, determines SpanKind,
+ * generates span names, and sets type-specific attributes on OTel spans.
+ *
+ * All attribute setting happens at on_span_end (when span data is fully
+ * populated), matching the Python SDK pattern.
+ */
+import { Span as OtelSpan, SpanKind } from '@opentelemetry/api';
+export declare function getOperationType(spanType: string): string;
+export declare function getSpanKind(operationType: string): SpanKind;
+export declare function generateSpanName(spanData: any): string;
+/**
+ * Set all OTel-compliant attributes on the OTel span using fully-populated SDK data.
+ * Called from on_span_end in the processor.
+ */
+export declare function processSpanEnd(otelSpan: OtelSpan, sdkSpan: any, startTime: number, conversationId: string | null, handoffTracker: Map<string, string>): void;
+export declare function recordMetrics(operationType: string, durationSeconds: number, requestModel: string | null): void;
+export declare function extractModelFromSpanData(spanData: any): string | null;