@openclaw/diagnostics-prometheus 2026.9.5 → 2026.9.6

package/dist/index.js

@@ -4,72 +4,7 @@ import { isDiagnosticsEnabled, normalizeDiagnosticLane, normalizeDiagnosticValue
 import { asNonNegativeFiniteNumber } from "openclaw/plugin-sdk/number-runtime";
 import { getPluginRuntimeGatewayRequestScope } from "openclaw/plugin-sdk/plugin-runtime";
 import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
-//#region extensions/diagnostics-prometheus/src/service.ts
-const DURATION_BUCKETS_SECONDS = [
-	.005,
-	.01,
-	.025,
-	.05,
-	.1,
-	.25,
-	.5,
-	1,
-	2.5,
-	5,
-	10,
-	30,
-	60,
-	120,
-	300,
-	600
-];
-const TOKEN_BUCKETS = [
-	1,
-	4,
-	16,
-	64,
-	256,
-	1024,
-	4096,
-	16384,
-	65536,
-	262144,
-	1048576
-];
-const BYTE_BUCKETS = [
-	1024,
-	4096,
-	16384,
-	65536,
-	262144,
-	1048576,
-	4194304,
-	16777216,
-	67108864,
-	268435456,
-	1073741824,
-	4294967296,
-	17179869184
-];
-const RATIO_BUCKETS = [
-	.01,
-	.05,
-	.1,
-	.25,
-	.5,
-	.75,
-	1,
-	2,
-	4,
-	8,
-	16
-];
-const MAX_PROMETHEUS_SERIES = 2048;
-const DROPPED_SERIES_COUNTER_NAME = "openclaw_prometheus_series_dropped_total";
-function seconds(ms) {
-	const value = asNonNegativeFiniteNumber(ms);
-	return value === void 0 ? void 0 : value / 1e3;
-}
+//#region extensions/diagnostics-prometheus/src/prometheus-format.ts
 function sortedLabels(labels) {
 	const entries = Object.entries(labels);
 	entries.sort(([left], [right]) => left.localeCompare(right));
@@ -96,6 +31,28 @@ function formatPrometheusNumber(value) {
 	if (!Number.isFinite(value)) return "0";
 	return Number.isInteger(value) ? String(value) : String(Number(value.toPrecision(12)));
 }
+//#endregion
+//#region extensions/diagnostics-prometheus/src/prometheus-metric-store.ts
+const DURATION_BUCKETS_SECONDS = [
+	.005,
+	.01,
+	.025,
+	.05,
+	.1,
+	.25,
+	.5,
+	1,
+	2.5,
+	5,
+	10,
+	30,
+	60,
+	120,
+	300,
+	600
+];
+const MAX_PROMETHEUS_SERIES = 2048;
+const DROPPED_SERIES_COUNTER_NAME = "openclaw_prometheus_series_dropped_total";
 function createPrometheusMetricStore() {
 	const counters = /* @__PURE__ */ new Map();
 	const gauges = /* @__PURE__ */ new Map();
@@ -132,6 +89,9 @@ function createPrometheusMetricStore() {
 			value
 		});
 	};
+	const clearGauges = (name) => {
+		for (const key of gauges.keys()) if (key.startsWith(`${name}|`)) gauges.delete(key);
+	};
 	const histogram = (name, help, labels, value, buckets = DURATION_BUCKETS_SECONDS) => {
 		if (value === void 0 || !Number.isFinite(value) || value < 0) return;
 		const key = metricKey(name, labels);
@@ -177,11 +137,59 @@ function createPrometheusMetricStore() {
 	return {
 		counter,
 		gauge,
+		clearGauges,
 		histogram,
 		reset,
 		snapshot
 	};
 }
+//#endregion
+//#region extensions/diagnostics-prometheus/src/service.ts
+const TOKEN_BUCKETS = [
+	1,
+	4,
+	16,
+	64,
+	256,
+	1024,
+	4096,
+	16384,
+	65536,
+	262144,
+	1048576
+];
+const BYTE_BUCKETS = [
+	1024,
+	4096,
+	16384,
+	65536,
+	262144,
+	1048576,
+	4194304,
+	16777216,
+	67108864,
+	268435456,
+	1073741824,
+	4294967296,
+	17179869184
+];
+const RATIO_BUCKETS = [
+	.01,
+	.05,
+	.1,
+	.25,
+	.5,
+	.75,
+	1,
+	2,
+	4,
+	8,
+	16
+];
+function seconds(ms) {
+	const value = asNonNegativeFiniteNumber(ms);
+	return value === void 0 ? void 0 : value / 1e3;
+}
 function safeErrorMessage(err) {
 	const message = err instanceof Error ? err.message ?? err.name : String(err);
 	return truncateUtf16Safe(redactSensitiveText(message).replaceAll("\0", " ").replace(/[\r\n\t\u2028\u2029]/gu, " "), 500);
@@ -525,14 +533,30 @@ function recordDiagnosticEvent(store, evt, metadata) {
 				trigger: evt.trigger
 			});
 			return;
-		case "diagnostic.memory.sample":
+		case "diagnostic.child_process.spawn":
+			store.counter("openclaw_child_process_spawn_total", "Successful child launches through the shared spawn and exec owners.", { family: normalizeDiagnosticValue(evt.family) }, asNonNegativeFiniteNumber(evt.count) ?? 0);
+			return;
+		case "diagnostic.memory.sample": {
 			for (const [kind, field] of [
 				["rss", "rssBytes"],
 				["heap_total", "heapTotalBytes"],
-				["heap_used", "heapUsedBytes"]
-			]) store.gauge("openclaw_memory_bytes", "Latest process memory usage by memory kind.", { kind }, evt.memory[field]);
+				["heap_used", "heapUsedBytes"],
+				["external", "externalBytes"],
+				["array_buffers", "arrayBuffersBytes"],
+				["worker_heap_total", "workerHeapTotalBytes"],
+				["worker_heap_used", "workerHeapUsedBytes"]
+			]) store.gauge("openclaw_memory_bytes", "Latest process memory usage by memory kind.", { kind }, asNonNegativeFiniteNumber(evt.memory[field]));
+			for (const [name, field] of [["openclaw_worker_count", "workerCount"], ["openclaw_worker_heap_sampled_count", "workerHeapSampledCount"]]) store.gauge(name, "Worker isolate counts.", {}, asNonNegativeFiniteNumber(evt.memory[field]));
+			const workerHeaps = /* @__PURE__ */ new Map();
+			for (const worker of evt.memory.workerHeaps ?? []) {
+				const heapUsed = asNonNegativeFiniteNumber(worker.heapUsed);
+				if (heapUsed !== void 0) workerHeaps.set(worker.script, (workerHeaps.get(worker.script) ?? 0) + heapUsed);
+			}
+			store.clearGauges("openclaw_worker_heap_used_bytes");
+			for (const [script, heapUsed] of workerHeaps) store.gauge("openclaw_worker_heap_used_bytes", "Latest live Worker heap usage by bounded script basename.", { script }, heapUsed);
 			store.histogram("openclaw_memory_rss_bytes", "RSS memory sample distribution in bytes.", {}, asNonNegativeFiniteNumber(evt.memory.rssBytes), BYTE_BUCKETS);
 			return;
+		}
 		case "diagnostic.memory.pressure":
 			store.counter("openclaw_memory_pressure_total", "Memory pressure events by level and reason.", {
 				level: evt.level,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/diagnostics-prometheus",
-  "version": "2026.9.5",
+  "version": "2026.9.6",
   "description": "OpenClaw diagnostics Prometheus exporter for runtime metrics.",
   "repository": {
     "type": "git",
@@ -18,10 +18,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.9.5"
+      "pluginApi": ">=2026.9.6"
     },
     "build": {
-      "openclawVersion": "2026.9.5"
+      "openclawVersion": "2026.9.6"
     },
     "release": {
       "publishToClawHub": true,
@@ -39,7 +39,7 @@
     "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.9.5"
+    "openclaw": ">=2026.9.6"
   },
   "peerDependenciesMeta": {
     "openclaw": {