@openclaw/diagnostics-prometheus 2026.9.7 → 2026.10.1-beta.1

package/dist/index.js

@@ -106,7 +106,7 @@ function createPrometheusMetricStore() {
 		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;
+		if (value === void 0 || !Number.isFinite(value)) return;
 		const key = metricKey(name, labels);
 		if (!canCreateSeries(histograms, key)) return;
 		let sample = histograms.get(key);
@@ -158,7 +158,22 @@ function createPrometheusMetricStore() {
 	};
 }
 //#endregion
+//#region extensions/diagnostics-prometheus/src/service-child-process.ts
+/** Git launches carry a bounded owner label; every other executable family reports `none`. */
+function recordChildProcessSpawn(store, evt) {
+	store.counter("openclaw_child_process_spawn_total", "Successful child launches through the shared spawn and exec owners.", {
+		family: normalizeDiagnosticValue(evt.family),
+		operation: normalizeDiagnosticValue(evt.operation ?? (evt.family === "git" ? "unknown" : "none"))
+	}, asNonNegativeFiniteNumber(evt.count) ?? 0);
+}
+//#endregion
 //#region extensions/diagnostics-prometheus/src/service-gateway-rpc.ts
+const RESPONSE_BYTE_BUCKETS = Array.from({ length: 17 }, (_, index) => 1024 * 2 ** index);
+const HEAP_DELTA_BYTE_BUCKETS = [
+	...RESPONSE_BYTE_BUCKETS.toReversed().map((bytes) => -bytes),
+	0,
+	...RESPONSE_BYTE_BUCKETS
+];
 const CATALOG_LIST_METHOD = "sessions.catalog.list";
 const CATALOG_LIST_PHASE_PREFIX = `${CATALOG_LIST_METHOD}.`;
 const CATALOG_LIST_PHASES = /* @__PURE__ */ new Set([
@@ -191,12 +206,18 @@ function recordGatewayRpcEvent(store, evt, metadata) {
 				store.counter("openclaw_gateway_rpc_requests_total", "Authenticated Gateway WebSocket requests received.", labels);
 				return;
 			}
+			if (evt.phase === "response" && (evt.outcome === "ok" || evt.outcome === "error")) {
+				store.histogram("openclaw_gateway_rpc_response_bytes", "Encoded Gateway RPC response frame size in bytes, including later frames.", labels, evt.responseBytes, RESPONSE_BYTE_BUCKETS);
+				if (evt.firstResponse === false) return;
+			}
 			store.counter("openclaw_gateway_rpc_outcomes_total", "Gateway RPC observations by phase and outcome.", {
 				phase: evt.phase,
 				outcome: evt.outcome
 			});
 			if (evt.phase === "response" && (evt.outcome === "ok" || evt.outcome === "error")) store.histogram("openclaw_gateway_rpc_first_response_seconds", "Elapsed time until the first Gateway RPC response is sent.", labels, seconds(evt.durationMs));
 			else if (evt.phase === "handler") {
+				if (evt.heapDeltaBytes !== void 0) store.counter("openclaw_gateway_rpc_handler_heap_delta_exclusive_total", "Gateway RPC handlers with an exclusive main-thread heap-change sample.", labels);
+				store.histogram("openclaw_gateway_rpc_handler_heap_delta_bytes", "Exclusive RPC handler heap change; background work and GC can affect signed samples.", labels, evt.heapDeltaBytes, HEAP_DELTA_BYTE_BUCKETS);
 				store.histogram("openclaw_gateway_rpc_handler_seconds", "Gateway RPC handler duration until return or throw.", labels, seconds(evt.durationMs));
 				store.histogram("openclaw_gateway_rpc_admission_seconds", "Elapsed time from Gateway RPC receipt until handler invocation.", labels, seconds(evt.admissionMs));
 			} else if (evt.phase === "dispatch") store.histogram("openclaw_gateway_rpc_queue_wait_seconds", "Gateway operator request start queue wait.", labels, seconds(evt.queueWaitMs));
@@ -223,6 +244,16 @@ function recordMemorySample(store, memory, byteBuckets) {
 		["worker_heap_used", "workerHeapUsedBytes"]
 	]) store.gauge("openclaw_memory_bytes", "Latest process memory usage by memory kind.", { kind }, asNonNegativeFiniteNumber(memory[field]));
 	for (const [name, field] of [["openclaw_worker_count", "workerCount"], ["openclaw_worker_heap_sampled_count", "workerHeapSampledCount"]]) store.gauge(name, "Worker isolate counts.", {}, asNonNegativeFiniteNumber(memory[field]));
+	store.clearGauges("openclaw_heap_space_bytes");
+	for (const space of memory.heapSpaces ?? []) for (const [stat, field] of [
+		["used", "space_used_size"],
+		["size", "space_size"],
+		["available", "space_available_size"],
+		["physical", "physical_space_size"]
+	]) store.gauge("openclaw_heap_space_bytes", "Latest main-isolate V8 heap space usage in bytes.", {
+		space: space.space_name,
+		stat
+	}, space[field]);
 	const workerHeaps = /* @__PURE__ */ new Map();
 	for (const worker of memory.workerHeaps ?? []) {
 		const heapUsed = asNonNegativeFiniteNumber(worker.heapUsed);
@@ -581,7 +612,7 @@ function recordDiagnosticEvent(store, evt, metadata) {
 			});
 			return;
 		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);
+			recordChildProcessSpawn(store, evt);
 			return;
 		case "diagnostic.memory.sample":
 			recordMemorySample(store, evt.memory, BYTE_BUCKETS);
@@ -683,10 +714,16 @@ function createDiagnosticsPrometheusExporter() {
 	const store = createPrometheusMetricStore();
 	let unsubscribe;
 	let internalDiagnostics;
-	const reportExporterHealth = (update) => {
+	const reportExporterStatus = (update) => {
 		try {
 			internalDiagnostics?.reportExporterHealth?.(update);
 		} catch {}
+		const { transport: _transport, ...event } = update;
+		internalDiagnostics?.emit({
+			type: "telemetry.exporter",
+			exporter: "diagnostics-prometheus",
+			...event
+		});
 	};
 	return {
 		handler: createMetricsHandler(store),
@@ -712,34 +749,21 @@ function createDiagnosticsPrometheusExporter() {
 					}
 				}, { exclude: ["log.record"] }, { includePrivateData: false });
 				internalDiagnostics = ctx.internalDiagnostics;
-				reportExporterHealth({
+				reportExporterStatus({
 					signal: "metrics",
 					transport: "prometheus-scrape",
 					status: "started",
 					reason: "configured"
 				});
-				internalDiagnostics.emit({
-					type: "telemetry.exporter",
-					exporter: "diagnostics-prometheus",
-					signal: "metrics",
-					status: "started",
-					reason: "configured"
-				});
 			},
 			stop() {
 				unsubscribe?.();
 				unsubscribe = void 0;
-				reportExporterHealth({
+				reportExporterStatus({
 					signal: "metrics",
 					transport: "prometheus-scrape",
 					status: "dropped"
 				});
-				internalDiagnostics?.emit({
-					type: "telemetry.exporter",
-					exporter: "diagnostics-prometheus",
-					signal: "metrics",
-					status: "dropped"
-				});
 				internalDiagnostics = void 0;
 				store.reset();
 			}

package/package.json

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