@openclaw/diagnostics-otel 2026.5.24-beta.1 → 2026.5.25-beta.1

package/dist/index.js

@@ -1,6 +1,6 @@
 import { isValidDiagnosticSpanId, isValidDiagnosticTraceFlags, isValidDiagnosticTraceId, redactSensitiveText } from "./api.js";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-import { SpanStatusCode, TraceFlags, context, metrics, trace } from "@opentelemetry/api";
+import { SpanKind, SpanStatusCode, TraceFlags, context, metrics, trace } from "@opentelemetry/api";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-proto";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
@@ -10,6 +10,7 @@ import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
 import { NodeSDK } from "@opentelemetry/sdk-node";
 import { ParentBasedSampler, TraceIdRatioBasedSampler } from "@opentelemetry/sdk-trace-base";
 import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import { ATTR_GEN_AI_INPUT_MESSAGES, ATTR_GEN_AI_OUTPUT_MESSAGES, ATTR_GEN_AI_SYSTEM_INSTRUCTIONS, ATTR_GEN_AI_TOOL_DEFINITIONS } from "@opentelemetry/semantic-conventions/incubating";
 import { registerUnhandledRejectionHandler } from "openclaw/plugin-sdk/runtime-env";
 //#region extensions/diagnostics-otel/src/service.ts
 const DEFAULT_SERVICE_NAME = "openclaw";
@@ -36,8 +37,8 @@ const DROPPED_OTEL_ATTRIBUTE_KEYS = new Set([
 	"openclaw.trace_id"
 ]);
 const LOW_CARDINALITY_VALUE_RE = /^[A-Za-z0-9_.:-]{1,120}$/u;
-const MAX_OTEL_CONTENT_ATTRIBUTE_CHARS = 4 * 1024;
-const MAX_OTEL_CONTENT_ARRAY_ITEMS = 16;
+const MAX_OTEL_CONTENT_ATTRIBUTE_CHARS = 128 * 1024;
+const MAX_OTEL_CONTENT_ARRAY_ITEMS = 200;
 const MAX_OTEL_LOG_BODY_CHARS = 4 * 1024;
 const MAX_OTEL_LOG_ATTRIBUTE_COUNT = 64;
 const MAX_OTEL_LOG_ATTRIBUTE_VALUE_CHARS = 4 * 1024;
@@ -94,6 +95,7 @@ const NO_CONTENT_CAPTURE = {
 	toolInputs: false,
 	toolOutputs: false,
 	systemPrompt: false,
+	toolDefinitions: false,
 	logBodies: false
 };
 function normalizeEndpoint(endpoint) {
@@ -104,6 +106,11 @@ function resolveOtelUrl(endpoint, path) {
 	if (!endpoint) return;
 	const endpointWithoutQueryOrFragment = endpoint.split(/[?#]/, 1)[0] ?? endpoint;
 	if (/\/v1\/(?:traces|metrics|logs)$/i.test(endpointWithoutQueryOrFragment)) return endpoint;
+	if (/[?#]/u.test(endpoint)) try {
+		const url = new URL(endpoint);
+		url.pathname = `${url.pathname.replace(/\/+$/u, "")}/${path}`;
+		return url.toString();
+	} catch {}
 	return `${endpoint}/${path}`;
 }
 function resolveSignalOtelUrl(params) {
@@ -231,6 +238,13 @@ function assignGenAiSpanIdentityAttrs(attrs, input) {
 function assignGenAiModelCallAttrs(attrs, evt) {
 	assignGenAiSpanIdentityAttrs(attrs, evt);
 }
+function modelCallSpanName(evt) {
+	if (!emitLatestGenAiSemconv()) return "openclaw.model.call";
+	return `${genAiOperationName(evt.api)} ${lowCardinalityAttr(evt.model)}`;
+}
+function modelCallSpanKind() {
+	return emitLatestGenAiSemconv() ? SpanKind.CLIENT : void 0;
+}
 function addUpstreamRequestIdSpanEvent(span, upstreamRequestIdHash) {
 	if (!upstreamRequestIdHash) return;
 	const boundedHash = lowCardinalityAttr(upstreamRequestIdHash);
@@ -250,6 +264,7 @@ function resolveContentCapturePolicy(value) {
 		toolInputs: true,
 		toolOutputs: true,
 		systemPrompt: false,
+		toolDefinitions: true,
 		logBodies: true
 	};
 	if (!value || typeof value !== "object" || Array.isArray(value)) return NO_CONTENT_CAPTURE;
@@ -261,6 +276,7 @@ function resolveContentCapturePolicy(value) {
 		toolInputs: config.toolInputs === true,
 		toolOutputs: config.toolOutputs === true,
 		systemPrompt: config.systemPrompt === true,
+		toolDefinitions: config.toolDefinitions === true,
 		logBodies: false
 	};
 }
@@ -274,15 +290,276 @@ function normalizeOtelContentValue(value) {
 		for (const item of value.slice(0, MAX_OTEL_CONTENT_ARRAY_ITEMS)) if (typeof item === "string") items.push(item);
 		if (items.length > 0) return normalizeOtelLogString(items.join("\n"), MAX_OTEL_CONTENT_ATTRIBUTE_CHARS);
 	}
+	const json = safeJsonString(value, MAX_OTEL_CONTENT_ATTRIBUTE_CHARS);
+	if (json) return json;
+}
+const TRUNCATED_JSON_TEXT_SUFFIX = "...(truncated)";
+const JSON_TRUNCATION_STRING_BUDGETS = [
+	8192,
+	4096,
+	2048,
+	1024,
+	512,
+	256,
+	128,
+	64,
+	32
+];
+const JSON_TRUNCATION_ARRAY_ITEM_BUDGETS = [
+	MAX_OTEL_CONTENT_ARRAY_ITEMS,
+	100,
+	50,
+	25,
+	10,
+	5,
+	1
+];
+const JSON_TRUNCATION_MAX_OBJECT_FIELDS = 64;
+const JSON_TRUNCATION_MAX_DEPTH = 8;
+function safeJsonString(value, maxChars) {
+	if (value === void 0 || typeof value === "function" || typeof value === "symbol") return;
+	const exact = stringifyJsonForOtelAttribute(value);
+	if (exact && exact.length <= maxChars) return exact;
+	for (const maxArrayItems of JSON_TRUNCATION_ARRAY_ITEM_BUDGETS) for (const maxStringChars of JSON_TRUNCATION_STRING_BUDGETS) {
+		const json = stringifyJsonForOtelAttribute(truncateJsonValueForOtelAttribute(value, {
+			maxArrayItems,
+			maxDepth: JSON_TRUNCATION_MAX_DEPTH,
+			maxObjectFields: JSON_TRUNCATION_MAX_OBJECT_FIELDS,
+			maxStringChars,
+			seen: /* @__PURE__ */ new WeakSet()
+		}));
+		if (json && json.length <= maxChars) return json;
+	}
+	const summary = stringifyJsonForOtelAttribute({
+		truncated: true,
+		reason: exact ? "max_attribute_size" : "unserializable_value",
+		type: describeJsonValue(value)
+	});
+	return summary && summary.length <= maxChars ? summary : void 0;
+}
+function stringifyJsonForOtelAttribute(value) {
+	try {
+		const json = JSON.stringify(value);
+		if (!json) return;
+		return redactSensitiveText(json);
+	} catch {
+		return;
+	}
+}
+function truncateJsonValueForOtelAttribute(value, options) {
+	if (typeof value === "string") return truncateJsonTextForOtelAttribute(value, options.maxStringChars);
+	if (typeof value === "number" || typeof value === "boolean" || value === null) return value;
+	if (typeof value === "bigint") return truncateJsonTextForOtelAttribute(String(value), options.maxStringChars);
+	if (value === void 0 || typeof value === "function" || typeof value === "symbol") return;
+	if (options.maxDepth <= 0) return {
+		truncated: true,
+		reason: "max_depth"
+	};
+	if (Array.isArray(value)) return truncateJsonArrayForOtelAttribute(value, options);
+	if (typeof value === "object") return truncateJsonObjectForOtelAttribute(value, options);
+}
+function truncateJsonArrayForOtelAttribute(value, options) {
+	if (options.seen.has(value)) return [{
+		truncated: true,
+		reason: "circular_reference"
+	}];
+	options.seen.add(value);
+	const nextOptions = {
+		...options,
+		maxDepth: options.maxDepth - 1
+	};
+	const items = value.slice(0, options.maxArrayItems).map((item) => truncateJsonValueForOtelAttribute(item, nextOptions));
+	if (value.length > items.length) items.push({
+		truncated: true,
+		omittedItems: value.length - items.length
+	});
+	options.seen.delete(value);
+	return items;
+}
+function truncateJsonObjectForOtelAttribute(value, options) {
+	if (options.seen.has(value)) return {
+		truncated: true,
+		reason: "circular_reference"
+	};
+	options.seen.add(value);
+	const nextOptions = {
+		...options,
+		maxDepth: options.maxDepth - 1
+	};
+	const result = {};
+	const entries = Object.entries(value).filter(([, field]) => field !== void 0 && typeof field !== "function" && typeof field !== "symbol");
+	for (const [key, field] of entries.slice(0, options.maxObjectFields)) result[key] = truncateJsonValueForOtelAttribute(field, nextOptions);
+	if (entries.length > options.maxObjectFields) {
+		result.truncated = true;
+		result.omittedFields = entries.length - options.maxObjectFields;
+	}
+	options.seen.delete(value);
+	return result;
+}
+function truncateJsonTextForOtelAttribute(value, maxChars) {
+	const redacted = redactSensitiveText(value);
+	if (redacted.length <= maxChars) return redacted;
+	const suffixBudget = Math.min(14, maxChars);
+	const prefixBudget = Math.max(0, maxChars - suffixBudget);
+	return `${redacted.slice(0, prefixBudget)}${TRUNCATED_JSON_TEXT_SUFFIX.slice(14 - suffixBudget)}`;
+}
+function describeJsonValue(value) {
+	if (Array.isArray(value)) return "array";
+	if (value === null) return "null";
+	return typeof value;
+}
+function isRecord(value) {
+	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function textPart(content) {
+	return {
+		type: "text",
+		content
+	};
+}
+function toolCallResponsePart(part) {
+	return {
+		type: "tool_call_response",
+		...typeof part.id === "string" ? { id: part.id } : {},
+		result: part.result ?? part.response ?? part.content ?? part.details ?? ""
+	};
+}
+function contentParts(value) {
+	if (typeof value === "string") return value.length > 0 ? [textPart(value)] : [];
+	if (!Array.isArray(value)) {
+		if (value === void 0 || value === null) return [];
+		if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return [textPart(String(value))];
+		const json = safeJsonString(value, MAX_OTEL_CONTENT_ATTRIBUTE_CHARS);
+		return json ? [textPart(json)] : [];
+	}
+	const parts = [];
+	for (const part of value) {
+		if (typeof part === "string") {
+			if (part.length > 0) parts.push(textPart(part));
+			continue;
+		}
+		if (!isRecord(part)) continue;
+		if (part.type === "text" && typeof part.text === "string") parts.push(textPart(part.text));
+		else if (part.type === "text" && typeof part.content === "string") parts.push(textPart(part.content));
+		else if (part.type === "thinking" && typeof part.thinking === "string") parts.push({
+			type: "reasoning",
+			content: part.thinking
+		});
+		else if (part.type === "toolCall" && typeof part.name === "string") parts.push({
+			type: "tool_call",
+			name: part.name,
+			...typeof part.id === "string" ? { id: part.id } : {},
+			...part.arguments !== void 0 ? { arguments: part.arguments } : {}
+		});
+		else if (part.type === "tool_call" && typeof part.name === "string") parts.push({
+			type: "tool_call",
+			name: part.name,
+			...typeof part.id === "string" ? { id: part.id } : {},
+			...part.arguments !== void 0 ? { arguments: part.arguments } : {}
+		});
+		else if (part.type === "tool_call_response") parts.push(toolCallResponsePart(part));
+		else if (part.type === "image") {
+			const data = typeof part.data === "string" ? part.data : void 0;
+			parts.push({
+				type: "blob",
+				modality: "image",
+				...typeof part.mimeType === "string" ? { mime_type: part.mimeType } : {},
+				...typeof part.mime_type === "string" ? { mime_type: part.mime_type } : {},
+				...data ? { content: data } : {}
+			});
+		}
+	}
+	return parts;
+}
+function normalizeGenAiMessage(value, fallbackRole = "user") {
+	if (typeof value === "string") return {
+		role: fallbackRole,
+		parts: [textPart(value)]
+	};
+	if (!isRecord(value)) return;
+	const rawRole = typeof value.role === "string" ? value.role : fallbackRole;
+	const role = rawRole === "toolResult" ? "tool" : rawRole;
+	let parts;
+	if (role === "tool") {
+		const explicitParts = contentParts(value.parts);
+		parts = explicitParts.length > 0 ? explicitParts : [toolCallResponsePart({
+			id: value.toolCallId,
+			result: value.content ?? value.details ?? ""
+		})];
+	} else parts = contentParts(value.parts ?? value.content);
+	if (parts.length === 0) return;
+	return {
+		role,
+		parts,
+		...typeof value.name === "string" ? { name: value.name } : {},
+		...typeof value.finish_reason === "string" ? { finish_reason: value.finish_reason } : {},
+		...typeof value.stopReason === "string" ? { finish_reason: value.stopReason } : {}
+	};
+}
+function normalizeGenAiMessages(value, fallbackRole) {
+	const source = Array.isArray(value) ? value : value === void 0 ? [] : [value];
+	const messages = [];
+	for (const item of source.slice(0, MAX_OTEL_CONTENT_ARRAY_ITEMS)) {
+		const message = normalizeGenAiMessage(item, fallbackRole);
+		if (message) messages.push(message);
+	}
+	return messages;
+}
+function normalizeGenAiToolDefinition(value) {
+	if (!isRecord(value) || typeof value.name !== "string" || value.name.trim().length === 0) return;
+	return {
+		type: typeof value.type === "string" ? value.type : "function",
+		name: value.name,
+		...typeof value.description === "string" ? { description: value.description } : {},
+		...value.parameters !== void 0 ? { parameters: value.parameters } : {}
+	};
+}
+function normalizeGenAiToolDefinitions(value) {
+	if (!Array.isArray(value)) return [];
+	const definitions = [];
+	for (const item of value.slice(0, MAX_OTEL_CONTENT_ARRAY_ITEMS)) {
+		const definition = normalizeGenAiToolDefinition(item);
+		if (definition) definitions.push(definition);
+	}
+	return definitions;
+}
+function assignJsonAttribute(attributes, key, value) {
+	const json = safeJsonString(value, MAX_OTEL_CONTENT_ATTRIBUTE_CHARS);
+	if (json) attributes[key] = json;
+}
+function assignGenAiModelContentAttributes(attributes, content, policy) {
+	if (policy.systemPrompt && typeof content?.systemPrompt === "string") assignJsonAttribute(attributes, ATTR_GEN_AI_SYSTEM_INSTRUCTIONS, [textPart(content.systemPrompt)]);
+	if (policy.inputMessages) {
+		const inputMessages = normalizeGenAiMessages(content?.inputMessages, "user");
+		if (inputMessages.length > 0) {
+			assignJsonAttribute(attributes, ATTR_GEN_AI_INPUT_MESSAGES, inputMessages);
+			assignJsonAttribute(attributes, "input.value", inputMessages);
+			attributes["input.mime_type"] = "application/json";
+		}
+	}
+	if (policy.toolDefinitions) {
+		const toolDefinitions = normalizeGenAiToolDefinitions(content?.toolDefinitions);
+		if (toolDefinitions.length > 0) assignJsonAttribute(attributes, ATTR_GEN_AI_TOOL_DEFINITIONS, toolDefinitions);
+	}
+	if (policy.outputMessages) {
+		const outputMessages = normalizeGenAiMessages(content?.outputMessages, "assistant");
+		if (outputMessages.length > 0) {
+			assignJsonAttribute(attributes, ATTR_GEN_AI_OUTPUT_MESSAGES, outputMessages);
+			assignJsonAttribute(attributes, "output.value", outputMessages);
+			attributes["output.mime_type"] = "application/json";
+		}
+	}
 }
 function assignOtelContentAttribute(attributes, key, value) {
 	const normalized = normalizeOtelContentValue(value);
 	if (normalized) attributes[key] = normalized;
 }
-function assignOtelModelContentAttributes(attributes, event, policy) {
-	if (policy.inputMessages) assignOtelContentAttribute(attributes, "openclaw.content.input_messages", event.inputMessages);
-	if (policy.outputMessages) assignOtelContentAttribute(attributes, "openclaw.content.output_messages", event.outputMessages);
-	if (policy.systemPrompt) assignOtelContentAttribute(attributes, "openclaw.content.system_prompt", event.systemPrompt);
+function assignOtelModelContentAttributes(attributes, content, policy) {
+	assignGenAiModelContentAttributes(attributes, content, policy);
+	if (policy.inputMessages) assignOtelContentAttribute(attributes, "openclaw.content.input_messages", content?.inputMessages);
+	if (policy.toolDefinitions) assignOtelContentAttribute(attributes, "openclaw.content.tool_definitions", content?.toolDefinitions);
+	if (policy.outputMessages) assignOtelContentAttribute(attributes, "openclaw.content.output_messages", content?.outputMessages);
+	if (policy.systemPrompt) assignOtelContentAttribute(attributes, "openclaw.content.system_prompt", content?.systemPrompt);
 }
 function assignOtelToolContentAttributes(attributes, event, policy) {
 	if (policy.toolInputs) assignOtelContentAttribute(attributes, "openclaw.content.tool_input", event.toolInput);
@@ -382,7 +659,7 @@ function createDiagnosticsOtelService() {
 			await stopStarted();
 			const cfg = ctx.config.diagnostics;
 			const otel = cfg?.otel;
-			if (!cfg?.enabled || !otel?.enabled) return;
+			if (!cfg || cfg.enabled === false || !otel?.enabled) return;
 			const emitExporterEvent = (event) => {
 				try {
 					ctx.internalDiagnostics?.emit({
@@ -657,10 +934,18 @@ function createDiagnosticsOtelService() {
 				unit: "ms",
 				description: "Elapsed time before the first streamed model response event"
 			});
+			const modelFailoverCounter = meter.createCounter("openclaw.model.failover", {
+				unit: "1",
+				description: "Model failovers by source, destination, lane, and reason"
+			});
 			const toolExecutionDurationHistogram = meter.createHistogram("openclaw.tool.execution.duration_ms", {
 				unit: "ms",
 				description: "Tool execution duration"
 			});
+			const toolExecutionBlockedCounter = meter.createCounter("openclaw.tool.execution.blocked", {
+				unit: "1",
+				description: "Tool executions blocked by policy or sandbox diagnostics"
+			});
 			const execProcessDurationHistogram = meter.createHistogram("openclaw.exec.duration_ms", {
 				unit: "ms",
 				description: "Exec process duration"
@@ -693,6 +978,14 @@ function createDiagnosticsOtelService() {
 				unit: "1",
 				description: "Async diagnostic queue drops by dropped event class"
 			});
+			const payloadLargeCounter = meter.createCounter("openclaw.payload.large", {
+				unit: "1",
+				description: "Oversized payload diagnostics by surface and action"
+			});
+			const payloadLargeBytesHistogram = meter.createHistogram("openclaw.payload.large_bytes", {
+				unit: "By",
+				description: "Oversized payload byte sizes by surface and action"
+			});
 			const livenessWarningCounter = meter.createCounter("openclaw.liveness.warning", {
 				unit: "1",
 				description: "Diagnostic liveness warning events"
@@ -773,6 +1066,7 @@ function createDiagnosticsOtelService() {
 				const parentContext = "parentContext" in options ? options.parentContext ?? void 0 : void 0;
 				return tracer.startSpan(name, {
 					attributes: redactOtelAttributes(attributes),
+					...options.kind !== void 0 ? { kind: options.kind } : {},
 					...startTime !== void 0 ? { startTime } : {}
 				}, parentContext);
 			};
@@ -1277,6 +1571,16 @@ function createDiagnosticsOtelService() {
 				}).end(evt.ts);
 			};
 			const recordModelFailover = (evt, metadata) => {
+				const metricAttrs = {
+					"openclaw.failover.reason": lowCardinalityAttr(evt.reason, "unknown"),
+					"openclaw.failover.suspended": evt.suspended === void 0 ? "unknown" : String(evt.suspended),
+					"openclaw.lane": lowCardinalityQueueLaneAttr(evt.lane, "unknown"),
+					"openclaw.model": lowCardinalityAttr(evt.fromModel),
+					"openclaw.provider": lowCardinalityAttr(evt.fromProvider),
+					"openclaw.failover.to_model": lowCardinalityAttr(evt.toModel),
+					"openclaw.failover.to_provider": lowCardinalityAttr(evt.toProvider)
+				};
+				modelFailoverCounter.add(1, metricAttrs);
 				if (!tracesEnabled) return;
 				const spanAttrs = { "openclaw.failover.reason": lowCardinalityAttr(evt.reason, "unknown") };
 				if (evt.fromProvider) spanAttrs["openclaw.provider"] = evt.fromProvider;
@@ -1320,12 +1624,13 @@ function createDiagnosticsOtelService() {
 				assignGenAiModelCallAttrs(spanAttrs, evt);
 				if (evt.api) spanAttrs["openclaw.api"] = evt.api;
 				if (evt.transport) spanAttrs["openclaw.transport"] = evt.transport;
-				trackTrustedSpan(evt, metadata, spanWithDuration("openclaw.model.call", spanAttrs, void 0, {
+				trackTrustedSpan(evt, metadata, spanWithDuration(modelCallSpanName(evt), spanAttrs, void 0, {
+					kind: modelCallSpanKind(),
 					parentContext: activeTrustedParentContext(evt, metadata),
 					startTimeMs: evt.ts
 				}));
 			};
-			const recordModelCallCompleted = (evt, metadata) => {
+			const recordModelCallCompleted = (evt, metadata, modelContent) => {
 				const metricAttrs = modelCallMetricAttrs(evt);
 				modelCallDurationHistogram.record(evt.durationMs, metricAttrs);
 				recordModelCallSizeTimingMetrics(evt, metricAttrs);
@@ -1339,8 +1644,9 @@ function createDiagnosticsOtelService() {
 				if (evt.api) spanAttrs["openclaw.api"] = evt.api;
 				if (evt.transport) spanAttrs["openclaw.transport"] = evt.transport;
 				assignModelCallSizeTimingAttrs(spanAttrs, evt);
-				assignOtelModelContentAttributes(spanAttrs, evt, contentCapturePolicy);
-				const span = takeTrackedTrustedSpan(evt, metadata) ?? spanWithDuration("openclaw.model.call", spanAttrs, evt.durationMs, {
+				assignOtelModelContentAttributes(spanAttrs, modelContent, contentCapturePolicy);
+				const span = takeTrackedTrustedSpan(evt, metadata) ?? spanWithDuration(modelCallSpanName(evt), spanAttrs, evt.durationMs, {
+					kind: modelCallSpanKind(),
 					parentContext: activeTrustedParentContext(evt, metadata),
 					endTimeMs: evt.ts
 				});
@@ -1348,7 +1654,7 @@ function createDiagnosticsOtelService() {
 				addUpstreamRequestIdSpanEvent(span, evt.upstreamRequestIdHash);
 				span.end(evt.ts);
 			};
-			const recordModelCallError = (evt, metadata) => {
+			const recordModelCallError = (evt, metadata, modelContent) => {
 				const errorType = lowCardinalityAttr(evt.errorCategory, "other");
 				const metricAttrs = {
 					...modelCallMetricAttrs(evt),
@@ -1370,8 +1676,9 @@ function createDiagnosticsOtelService() {
 				if (evt.api) spanAttrs["openclaw.api"] = evt.api;
 				if (evt.transport) spanAttrs["openclaw.transport"] = evt.transport;
 				assignModelCallSizeTimingAttrs(spanAttrs, evt);
-				assignOtelModelContentAttributes(spanAttrs, evt, contentCapturePolicy);
-				const span = takeTrackedTrustedSpan(evt, metadata) ?? spanWithDuration("openclaw.model.call", spanAttrs, evt.durationMs, {
+				assignOtelModelContentAttributes(spanAttrs, modelContent, contentCapturePolicy);
+				const span = takeTrackedTrustedSpan(evt, metadata) ?? spanWithDuration(modelCallSpanName(evt), spanAttrs, evt.durationMs, {
+					kind: modelCallSpanKind(),
 					parentContext: activeTrustedParentContext(evt, metadata),
 					endTimeMs: evt.ts
 				});
@@ -1458,6 +1765,10 @@ function createDiagnosticsOtelService() {
 				span.end(evt.ts);
 			};
 			const recordToolExecutionBlocked = (evt, metadata) => {
+				toolExecutionBlockedCounter.add(1, {
+					...toolExecutionBaseAttrs(evt),
+					"openclaw.deniedReason": lowCardinalityAttr(evt.deniedReason, "other")
+				});
 				if (!tracesEnabled) return;
 				const spanAttrs = {
 					...toolExecutionBaseAttrs(evt),
@@ -1472,6 +1783,18 @@ function createDiagnosticsOtelService() {
 				setSpanAttrs(span, spanAttrs);
 				span.end(evt.ts);
 			};
+			const recordPayloadLarge = (evt) => {
+				const attrs = {
+					"openclaw.payload.action": evt.action,
+					"openclaw.payload.surface": lowCardinalityAttr(evt.surface, "unknown"),
+					"openclaw.channel": lowCardinalityAttr(evt.channel, "none"),
+					"openclaw.plugin": lowCardinalityAttr(evt.pluginId, "none"),
+					"openclaw.reason": lowCardinalityAttr(evt.reason, "none")
+				};
+				payloadLargeCounter.add(1, attrs);
+				const bytes = positiveFiniteNumber(evt.bytes);
+				if (bytes !== void 0) payloadLargeBytesHistogram.record(bytes, attrs);
+			};
 			const recordExecProcessCompleted = (evt) => {
 				const attrs = {
 					"openclaw.exec.target": evt.target,
@@ -1555,7 +1878,7 @@ function createDiagnosticsOtelService() {
 				ctx.logger.error("diagnostics-otel: internal diagnostics capability unavailable");
 				return;
 			}
-			unsubscribe = subscribe((evt, metadata) => {
+			unsubscribe = subscribe((evt, metadata, privateData) => {
 				try {
 					switch (evt.type) {
 						case "model.usage":
@@ -1655,10 +1978,10 @@ function createDiagnosticsOtelService() {
 							recordModelCallStarted(evt, metadata);
 							return;
 						case "model.call.completed":
-							recordModelCallCompleted(evt, metadata);
+							recordModelCallCompleted(evt, metadata, privateData.modelContent);
 							return;
 						case "model.call.error":
-							recordModelCallError(evt, metadata);
+							recordModelCallError(evt, metadata, privateData.modelContent);
 							return;
 						case "tool.execution.started":
 							recordToolExecutionStarted(evt, metadata);
@@ -1696,7 +2019,9 @@ function createDiagnosticsOtelService() {
 						case "telemetry.exporter":
 							recordTelemetryExporter(evt, metadata);
 							return;
-						case "payload.large": return;
+						case "payload.large":
+							recordPayloadLarge(evt);
+							return;
 						case "model.failover":
 							recordModelFailover(evt, metadata);
 							return;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/diagnostics-otel",
-  "version": "2026.5.24-beta.1",
+  "version": "2026.5.25-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/diagnostics-otel",
-      "version": "2026.5.24-beta.1",
+      "version": "2026.5.25-beta.1",
       "dependencies": {
         "@opentelemetry/api": "1.9.1",
         "@opentelemetry/api-logs": "0.218.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/diagnostics-otel",
-  "version": "2026.5.24-beta.1",
+  "version": "2026.5.25-beta.1",
   "description": "OpenClaw diagnostics OpenTelemetry exporter",
   "repository": {
     "type": "git",
@@ -31,10 +31,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.24-beta.1"
+      "pluginApi": ">=2026.5.25-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.24-beta.1"
+      "openclawVersion": "2026.5.25-beta.1"
     },
     "release": {
       "publishToClawHub": true,
@@ -50,7 +50,7 @@
     "npm-shrinkwrap.json"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.5.24-beta.1"
+    "openclaw": ">=2026.5.25-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {