@openclaw/diagnostics-otel 2026.6.9-beta.1 → 2026.6.10-beta.1

package/README.md

@@ -2,7 +2,7 @@
 
 Official OpenTelemetry diagnostics exporter for OpenClaw.
 
-This plugin exports OpenClaw Gateway traces, metrics, and logs to an OTLP collector for observability stacks such as Grafana, Datadog, Honeycomb, New Relic, Tempo, and compatible collectors.
+This plugin exports OpenClaw Gateway traces, metrics, and logs to an OTLP collector for observability stacks such as Grafana, Datadog, Honeycomb, New Relic, Tempo, and compatible collectors. It can also write diagnostic log records as stdout JSONL for container log pipelines.
 
 ## Install
 

package/dist/index.js

@@ -215,6 +215,31 @@ function lowCardinalityQueueLaneAttr(value, fallback = "unknown") {
 function shouldCaptureOtelLogBody(policy) {
 	return policy.logBodies;
 }
+function otelLogTimestampIso(timestamp) {
+	if (timestamp instanceof Date) return timestamp.toISOString();
+	if (typeof timestamp === "number" && Number.isFinite(timestamp)) return new Date(timestamp).toISOString();
+	if (Array.isArray(timestamp)) {
+		const [seconds, nanoseconds] = timestamp;
+		if (Number.isFinite(seconds) && Number.isFinite(nanoseconds)) return new Date(seconds * 1e3 + Math.trunc(nanoseconds / 1e6)).toISOString();
+	}
+	return (/* @__PURE__ */ new Date()).toISOString();
+}
+function writeStdoutDiagnosticLogRecord(params) {
+	const { logRecord, serviceName, traceContext } = params;
+	const line = {
+		ts: otelLogTimestampIso(logRecord.timestamp),
+		signal: "openclaw.diagnostic.log",
+		"service.name": serviceName,
+		severityText: logRecord.severityText,
+		severityNumber: logRecord.severityNumber,
+		body: logRecord.body,
+		attributes: logRecord.attributes ?? {},
+		...traceContext?.traceId ? { trace_id: traceContext.traceId } : {},
+		...traceContext?.spanId ? { span_id: traceContext.spanId } : {},
+		...traceContext?.traceFlags ? { trace_flags: traceContext.traceFlags } : {}
+	};
+	process.stdout.write(`${JSON.stringify(line)}\n`);
+}
 function hasOtelSemconvOptIn(value, optIn) {
 	return value?.split(",").map((part) => part.trim()).includes(optIn) ?? false;
 }
@@ -688,6 +713,9 @@ function contextForTraceContext(traceContext) {
 function contextForTrustedTraceContext(evt, metadata) {
 	return metadata.trusted || metadata.trustedTraceContext === true ? contextForTraceContext(evt.trace) : void 0;
 }
+function normalizedTrustedTraceContext(evt, metadata) {
+	return metadata.trusted || metadata.trustedTraceContext === true ? normalizeTraceContext(evt.trace) : void 0;
+}
 function addTraceAttributes(attributes, traceContext) {
 	const normalized = normalizeTraceContext(traceContext);
 	if (!normalized) return;
@@ -743,6 +771,14 @@ function createDiagnosticsOtelService() {
 			const tracesEnabled = otel.traces !== false;
 			const metricsEnabled = otel.metrics !== false;
 			const logsEnabled = otel.logs === true;
+			const logsExporter = otel.logsExporter ?? "otlp";
+			const logsToOtlp = logsEnabled && (logsExporter === "otlp" || logsExporter === "both");
+			const logsToStdout = logsEnabled && (logsExporter === "stdout" || logsExporter === "both");
+			const otlpSignals = [
+				...tracesEnabled ? ["traces"] : [],
+				...metricsEnabled ? ["metrics"] : [],
+				...logsToOtlp ? ["logs"] : []
+			];
 			const enabledSignals = [
 				...tracesEnabled ? ["traces"] : [],
 				...metricsEnabled ? ["metrics"] : [],
@@ -750,8 +786,8 @@ function createDiagnosticsOtelService() {
 			];
 			if (enabledSignals.length === 0) return;
 			const protocol = otel.protocol ?? process.env.OTEL_EXPORTER_OTLP_PROTOCOL ?? "http/protobuf";
-			if (protocol !== "http/protobuf") {
-				emitForSignals(enabledSignals, {
+			if (otlpSignals.length > 0 && protocol !== "http/protobuf") {
+				emitForSignals(otlpSignals, {
 					exporter: "diagnostics-otel",
 					status: "failure",
 					reason: "unsupported_protocol"
@@ -1083,81 +1119,98 @@ function createDiagnosticsOtelService() {
 			let recordSecurityEvent;
 			if (logsEnabled) {
 				let logRecordExportFailureLastReportedAt = Number.NEGATIVE_INFINITY;
-				logProvider = new LoggerProvider({
-					resource,
-					processors: [new BatchLogRecordProcessor(new OTLPLogExporter({
-						...logUrl ? { url: logUrl } : {},
-						...headers ? { headers } : {}
-					}), typeof otel.flushIntervalMs === "number" ? { scheduledDelayMillis: Math.max(1e3, otel.flushIntervalMs) } : {})]
-				});
-				const otelLogger = logProvider.getLogger("openclaw");
+				let otelLogger;
+				if (logsToOtlp) {
+					logProvider = new LoggerProvider({
+						resource,
+						processors: [new BatchLogRecordProcessor(new OTLPLogExporter({
+							...logUrl ? { url: logUrl } : {},
+							...headers ? { headers } : {}
+						}), typeof otel.flushIntervalMs === "number" ? { scheduledDelayMillis: Math.max(1e3, otel.flushIntervalMs) } : {})]
+					});
+					otelLogger = logProvider.getLogger("openclaw");
+				}
+				const reportLogExportFailure = (err, label) => {
+					emitExporterEvent({
+						exporter: "diagnostics-otel",
+						signal: "logs",
+						status: "failure",
+						reason: "emit_failed",
+						errorCategory: errorCategory(err)
+					});
+					const now = Date.now();
+					if (now - logRecordExportFailureLastReportedAt >= LOG_RECORD_EXPORT_FAILURE_REPORT_INTERVAL_MS) {
+						logRecordExportFailureLastReportedAt = now;
+						ctx.logger.error(`diagnostics-otel: ${label} export failed: ${formatError(err)}`);
+					}
+				};
+				const emitLogRecord = ({ logRecord, traceContext }) => {
+					if (logsToOtlp) otelLogger?.emit(logRecord);
+					if (logsToStdout) writeStdoutDiagnosticLogRecord({
+						logRecord,
+						serviceName,
+						...traceContext ? { traceContext } : {}
+					});
+				};
+				const buildDiagnosticLogRecord = (evt, metadata) => {
+					const logLevelName = evt.level || "INFO";
+					const severityNumber = logSeverityMap[logLevelName] ?? 9;
+					const body = shouldCaptureOtelLogBody(contentCapturePolicy) ? normalizeOtelLogString(evt.message || "log", MAX_OTEL_LOG_BODY_CHARS) : "log";
+					const attributes = Object.create(null);
+					assignOtelLogAttribute(attributes, "openclaw.log.level", logLevelName);
+					if (evt.loggerName) assignOtelLogAttribute(attributes, "openclaw.logger", evt.loggerName);
+					if (evt.loggerParents?.length) assignOtelLogAttribute(attributes, "openclaw.logger.parents", evt.loggerParents.join("."));
+					assignOtelLogEventAttributes(attributes, evt.attributes);
+					if (evt.code?.line) assignOtelLogAttribute(attributes, "code.lineno", evt.code.line);
+					if (evt.code?.functionName) assignOtelLogAttribute(attributes, "code.function", evt.code.functionName);
+					const traceContext = normalizedTrustedTraceContext(evt, metadata);
+					addTraceAttributes(attributes, traceContext);
+					const logRecord = {
+						body,
+						severityText: logLevelName,
+						severityNumber,
+						attributes: redactOtelAttributes(attributes),
+						timestamp: evt.ts
+					};
+					const logContext = contextForTrustedTraceContext(evt, metadata);
+					if (logContext) logRecord.context = logContext;
+					return {
+						logRecord,
+						...traceContext ? { traceContext } : {}
+					};
+				};
+				const buildSecurityLogRecord = (evt, metadata) => {
+					const severityText = securitySeverityText(evt.severity);
+					const attributes = Object.create(null);
+					assignOtelSecurityAttributes(attributes, evt);
+					const traceContext = normalizedTrustedTraceContext(evt, metadata);
+					const logRecord = {
+						body: "openclaw.security.event",
+						severityText,
+						severityNumber: logSeverityMap[severityText] ?? 9,
+						attributes: redactOtelAttributes(attributes),
+						timestamp: evt.ts
+					};
+					const logContext = contextForTrustedTraceContext(evt, metadata);
+					if (logContext) logRecord.context = logContext;
+					return {
+						logRecord,
+						...traceContext ? { traceContext } : {}
+					};
+				};
 				recordLogRecord = (evt, metadata) => {
 					try {
-						const logLevelName = evt.level || "INFO";
-						const severityNumber = logSeverityMap[logLevelName] ?? 9;
-						const body = shouldCaptureOtelLogBody(contentCapturePolicy) ? normalizeOtelLogString(evt.message || "log", MAX_OTEL_LOG_BODY_CHARS) : "log";
-						const attributes = Object.create(null);
-						assignOtelLogAttribute(attributes, "openclaw.log.level", logLevelName);
-						if (evt.loggerName) assignOtelLogAttribute(attributes, "openclaw.logger", evt.loggerName);
-						if (evt.loggerParents?.length) assignOtelLogAttribute(attributes, "openclaw.logger.parents", evt.loggerParents.join("."));
-						assignOtelLogEventAttributes(attributes, evt.attributes);
-						if (evt.code?.line) assignOtelLogAttribute(attributes, "code.lineno", evt.code.line);
-						if (evt.code?.functionName) assignOtelLogAttribute(attributes, "code.function", evt.code.functionName);
-						if (metadata.trusted || metadata.trustedTraceContext === true) addTraceAttributes(attributes, evt.trace);
-						const logRecord = {
-							body,
-							severityText: logLevelName,
-							severityNumber,
-							attributes: redactOtelAttributes(attributes),
-							timestamp: evt.ts
-						};
-						const logContext = contextForTrustedTraceContext(evt, metadata);
-						if (logContext) logRecord.context = logContext;
-						otelLogger.emit(logRecord);
+						emitLogRecord(buildDiagnosticLogRecord(evt, metadata));
 					} catch (err) {
-						emitExporterEvent({
-							exporter: "diagnostics-otel",
-							signal: "logs",
-							status: "failure",
-							reason: "emit_failed",
-							errorCategory: errorCategory(err)
-						});
-						const now = Date.now();
-						if (now - logRecordExportFailureLastReportedAt >= LOG_RECORD_EXPORT_FAILURE_REPORT_INTERVAL_MS) {
-							logRecordExportFailureLastReportedAt = now;
-							ctx.logger.error(`diagnostics-otel: log record export failed: ${formatError(err)}`);
-						}
+						reportLogExportFailure(err, "log record");
 					}
 				};
 				recordSecurityEvent = (evt, metadata) => {
 					if (!metadata.trusted) return;
 					try {
-						const severityText = securitySeverityText(evt.severity);
-						const attributes = Object.create(null);
-						assignOtelSecurityAttributes(attributes, evt);
-						const logRecord = {
-							body: "openclaw.security.event",
-							severityText,
-							severityNumber: logSeverityMap[severityText] ?? 9,
-							attributes: redactOtelAttributes(attributes),
-							timestamp: evt.ts
-						};
-						const logContext = contextForTrustedTraceContext(evt, metadata);
-						if (logContext) logRecord.context = logContext;
-						otelLogger.emit(logRecord);
+						emitLogRecord(buildSecurityLogRecord(evt, metadata));
 					} catch (err) {
-						emitExporterEvent({
-							exporter: "diagnostics-otel",
-							signal: "logs",
-							status: "failure",
-							reason: "emit_failed",
-							errorCategory: errorCategory(err)
-						});
-						const now = Date.now();
-						if (now - logRecordExportFailureLastReportedAt >= LOG_RECORD_EXPORT_FAILURE_REPORT_INTERVAL_MS) {
-							logRecordExportFailureLastReportedAt = now;
-							ctx.logger.error(`diagnostics-otel: security event export failed: ${formatError(err)}`);
-						}
+						reportLogExportFailure(err, "security event");
 					}
 				};
 			}
@@ -2294,7 +2347,10 @@ function createDiagnosticsOtelService() {
 				status: "started",
 				reason: "configured"
 			});
-			if (logsEnabled) ctx.logger.info("diagnostics-otel: logs exporter enabled (OTLP/Protobuf)");
+			if (logsEnabled) {
+				const label = logsExporter === "both" ? "OTLP/Protobuf + stdout JSONL" : logsExporter === "stdout" ? "stdout JSONL" : "OTLP/Protobuf";
+				ctx.logger.info(`diagnostics-otel: logs exporter enabled (${label})`);
+			}
 		},
 		async stop() {
 			await stopStarted();

package/npm-shrinkwrap.json

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

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "diagnostics-otel",
   "name": "Diagnostics OpenTelemetry",
-  "description": "OpenClaw diagnostics OpenTelemetry exporter for metrics and traces.",
+  "description": "OpenClaw diagnostics OpenTelemetry exporter for metrics, traces, and logs.",
   "activation": {
     "onStartup": true
   },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openclaw/diagnostics-otel",
-  "version": "2026.6.9-beta.1",
-  "description": "OpenClaw diagnostics OpenTelemetry exporter for metrics and traces.",
+  "version": "2026.6.10-beta.1",
+  "description": "OpenClaw diagnostics OpenTelemetry exporter for metrics, traces, and logs.",
   "repository": {
     "type": "git",
     "url": "https://github.com/openclaw/openclaw"
@@ -31,10 +31,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.6.9-beta.1"
+      "pluginApi": ">=2026.6.10-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.6.9-beta.1"
+      "openclawVersion": "2026.6.10-beta.1"
     },
     "release": {
       "publishToClawHub": true,
@@ -51,7 +51,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.6.9-beta.1"
+    "openclaw": ">=2026.6.10-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {