@openclaw/diagnostics-prometheus 2026.5.20 → 2026.5.22

package/dist/index.js

@@ -53,8 +53,18 @@ const DROPPED_SERIES_COUNTER_NAME = "openclaw_prometheus_series_dropped_total";
 function lowCardinalityLabel(value, fallback = "unknown") {
 	if (!value) return fallback;
 	const redacted = redactSensitiveText(value.trim());
+	const redactedLower = redacted.toLowerCase();
+	if (redactedLower.startsWith("agent:") || redactedLower.includes(":agent:")) return fallback;
 	return LOW_CARDINALITY_VALUE_RE.test(redacted) ? redacted : fallback;
 }
+function lowCardinalityQueueLaneLabel(value, fallback = "unknown") {
+	if (!value) return fallback;
+	const redacted = redactSensitiveText(value.trim());
+	if (redacted.toLowerCase().startsWith("agent:")) return fallback;
+	const scopedLaneIndex = redacted.indexOf(":");
+	const lane = scopedLaneIndex >= 0 ? redacted.slice(0, scopedLaneIndex) : redacted;
+	return LOW_CARDINALITY_VALUE_RE.test(lane) ? lane : fallback;
+}
 function numericValue(value) {
 	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
 }
@@ -347,6 +357,32 @@ function recordDiagnosticEvent(store, evt, metadata) {
 				delivery_kind: lowCardinalityLabel(evt.deliveryKind, "other")
 			});
 			return;
+		case "message.received":
+			store.counter("openclaw_message_received_total", "Inbound messages received by channel.", {
+				channel: lowCardinalityLabel(evt.channel),
+				source: lowCardinalityLabel(evt.source)
+			});
+			return;
+		case "message.dispatch.started":
+			store.counter("openclaw_message_dispatch_started_total", "Inbound message dispatch attempts started by channel.", {
+				channel: lowCardinalityLabel(evt.channel),
+				source: lowCardinalityLabel(evt.source)
+			});
+			return;
+		case "message.dispatch.completed":
+			store.counter("openclaw_message_dispatch_completed_total", "Inbound message dispatch attempts completed by outcome.", {
+				channel: lowCardinalityLabel(evt.channel),
+				outcome: evt.outcome,
+				reason: lowCardinalityLabel(evt.reason, "none"),
+				source: lowCardinalityLabel(evt.source)
+			});
+			store.histogram("openclaw_message_dispatch_duration_seconds", "Inbound message dispatch duration in seconds.", {
+				channel: lowCardinalityLabel(evt.channel),
+				outcome: evt.outcome,
+				reason: lowCardinalityLabel(evt.reason, "none"),
+				source: lowCardinalityLabel(evt.source)
+			}, seconds(evt.durationMs));
+			return;
 		case "message.delivery.completed":
 		case "message.delivery.error":
 			store.counter("openclaw_message_delivery_total", "Outbound message delivery attempts by outcome.", {
@@ -374,8 +410,8 @@ function recordDiagnosticEvent(store, evt, metadata) {
 			return;
 		case "queue.lane.enqueue":
 		case "queue.lane.dequeue":
-			store.gauge("openclaw_queue_lane_size", "Current diagnostic queue lane size.", { lane: lowCardinalityLabel(evt.lane) }, numericValue(evt.queueSize));
-			if (evt.type === "queue.lane.dequeue") store.histogram("openclaw_queue_lane_wait_seconds", "Queue lane wait time in seconds.", { lane: lowCardinalityLabel(evt.lane) }, seconds(evt.waitMs));
+			store.gauge("openclaw_queue_lane_size", "Current diagnostic queue lane size.", { lane: lowCardinalityQueueLaneLabel(evt.lane) }, numericValue(evt.queueSize));
+			if (evt.type === "queue.lane.dequeue") store.histogram("openclaw_queue_lane_wait_seconds", "Queue lane wait time in seconds.", { lane: lowCardinalityQueueLaneLabel(evt.lane) }, seconds(evt.waitMs));
 			return;
 		case "session.state":
 			store.counter("openclaw_session_state_total", "Session state observations.", {
@@ -384,6 +420,13 @@ function recordDiagnosticEvent(store, evt, metadata) {
 			});
 			if (evt.queueDepth !== void 0) store.gauge("openclaw_session_queue_depth", "Latest observed session queue depth.", { state: evt.state }, numericValue(evt.queueDepth));
 			return;
+		case "session.turn.created":
+			store.counter("openclaw_session_turn_created_total", "Agent session turns created.", {
+				agent: lowCardinalityLabel(evt.agentId),
+				channel: lowCardinalityLabel(evt.channel),
+				trigger: evt.trigger
+			});
+			return;
 		case "diagnostic.memory.sample":
 			store.gauge("openclaw_memory_bytes", "Latest process memory usage by memory kind.", { kind: "rss" }, evt.memory.rssBytes);
 			store.gauge("openclaw_memory_bytes", "Latest process memory usage by memory kind.", { kind: "heap_total" }, evt.memory.heapTotalBytes);
@@ -396,6 +439,13 @@ function recordDiagnosticEvent(store, evt, metadata) {
 				reason: evt.reason
 			});
 			return;
+		case "diagnostic.async_queue.dropped":
+			store.counter("openclaw_diagnostic_async_queue_dropped_total", "Async diagnostic queue drops by dropped event class.", { drop_class: "total" }, numericValue(evt.droppedEvents));
+			if (evt.droppedTrustedEvents !== void 0) store.counter("openclaw_diagnostic_async_queue_dropped_total", "Async diagnostic queue drops by dropped event class.", { drop_class: "trusted" }, numericValue(evt.droppedTrustedEvents));
+			if (evt.droppedUntrustedEvents !== void 0) store.counter("openclaw_diagnostic_async_queue_dropped_total", "Async diagnostic queue drops by dropped event class.", { drop_class: "untrusted" }, numericValue(evt.droppedUntrustedEvents));
+			if (evt.droppedPriorityEvents !== void 0) store.counter("openclaw_diagnostic_async_queue_dropped_total", "Async diagnostic queue drops by dropped event class.", { drop_class: "priority" }, numericValue(evt.droppedPriorityEvents));
+			store.gauge("openclaw_diagnostic_async_queue_length", "Latest async diagnostic queue length after a drop summary.", {}, numericValue(evt.queueLength));
+			return;
 		case "diagnostic.heartbeat":
 		case "diagnostic.liveness.warning": return;
 		case "telemetry.exporter":

package/npm-shrinkwrap.json

@@ -0,0 +1,12 @@
+{
+  "name": "@openclaw/diagnostics-prometheus",
+  "version": "2026.5.22",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@openclaw/diagnostics-prometheus",
+      "version": "2026.5.22"
+    }
+  }
+}

package/package.json

@@ -1,15 +1,12 @@
 {
   "name": "@openclaw/diagnostics-prometheus",
-  "version": "2026.5.20",
+  "version": "2026.5.22",
   "description": "OpenClaw diagnostics Prometheus exporter",
   "repository": {
     "type": "git",
     "url": "https://github.com/openclaw/openclaw"
   },
   "type": "module",
-  "devDependencies": {
-    "@openclaw/plugin-sdk": "workspace:*"
-  },
   "openclaw": {
     "extensions": [
       "./index.ts"
@@ -21,10 +18,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.20"
+      "pluginApi": ">=2026.5.22"
     },
     "build": {
-      "openclawVersion": "2026.5.20"
+      "openclawVersion": "2026.5.22"
     },
     "release": {
       "publishToClawHub": true,
@@ -36,14 +33,16 @@
   },
   "files": [
     "dist/**",
-    "openclaw.plugin.json"
+    "openclaw.plugin.json",
+    "npm-shrinkwrap.json"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.5.20"
+    "openclaw": ">=2026.5.22"
   },
   "peerDependenciesMeta": {
     "openclaw": {
       "optional": true
     }
-  }
+  },
+  "bundledDependencies": []
 }