Files
swarm-master/openclaw/hooks/agentmon/handler.js
William Valentin 0215c037da feat: add agentmon monitoring hook for OpenClaw telemetry
Add hook handler that forwards OpenClaw agent events to the agentmon
ingest endpoint for monitoring and observability.

- ansible/playbooks/files/agentmon-hook/: Ansible-deployable hook
- openclaw/hooks/agentmon/: Hook installed in OpenClaw instance

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 15:35:47 -07:00

296 lines
7.8 KiB
JavaScript

import { randomUUID } from "node:crypto";
import { hostname } from "node:os";
const INGEST_URL = process.env.AGENTMON_INGEST_URL || "http://192.168.122.1:8080";
const VM_NAME = process.env.AGENTMON_VM_NAME || hostname();
const BATCH_SIZE = 10;
const FLUSH_MS = 2e3;
const FETCH_TIMEOUT_MS = 500;
let buffer = [];
let flushTimer = null;
let isFlushing = false;
const activeRuns = /* @__PURE__ */ new Map();
function isRecord(value) {
return value !== null && typeof value === "object" && !Array.isArray(value);
}
function pickString(...values) {
for (const value of values) {
if (typeof value === "string" && value.trim() !== "") {
return value;
}
}
return void 0;
}
function pickNumber(...values) {
for (const value of values) {
if (typeof value === "number" && Number.isFinite(value)) {
return value;
}
}
return void 0;
}
function truncate(value, limit) {
if (value === void 0 || value === null) {
return void 0;
}
const text = typeof value === "string" ? value : safeJSONStringify(value);
if (!text) {
return void 0;
}
if (text.length <= limit) {
return text;
}
return text.slice(0, limit) + "...";
}
function safeJSONStringify(value) {
try {
return JSON.stringify(value);
} catch {
return String(value);
}
}
function getEventName(input) {
const direct = pickString(input.name, input.event);
if (direct) {
return direct;
}
if (typeof input.type === "string" && input.type.includes(":")) {
return input.type;
}
if (typeof input.type === "string" && typeof input.action === "string") {
return `${input.type}:${input.action}`;
}
if (typeof input.type === "string") {
return input.type;
}
return "";
}
function getContext(input) {
return isRecord(input.context) ? input.context : {};
}
function getSessionKey(input, context) {
return pickString(
input.sessionKey,
context.sessionKey,
context.session_id,
input.session_id,
isRecord(input.session) ? input.session.key : void 0,
isRecord(context.session) ? context.session.key : void 0
);
}
function buildEnvelope(type, sessionKey, opts = {}) {
const correlation = {};
if (sessionKey) {
correlation.session_id = sessionKey;
}
if (opts.runId) {
correlation.run_id = opts.runId;
}
if (opts.spanId) {
correlation.span_id = opts.spanId;
}
if (opts.parentSpanId) {
correlation.parent_span_id = opts.parentSpanId;
}
const envelope = {
schema: { name: "agentmon.event", version: 1 },
event: {
id: randomUUID(),
type,
ts: (/* @__PURE__ */ new Date()).toISOString(),
source: {
framework: "openclaw",
client_id: VM_NAME,
host: VM_NAME
}
}
};
if (Object.keys(correlation).length > 0) {
envelope.correlation = correlation;
}
if (opts.attributes && Object.keys(opts.attributes).length > 0) {
envelope.attributes = opts.attributes;
}
if (opts.payload && Object.keys(opts.payload).length > 0) {
envelope.payload = opts.payload;
}
return envelope;
}
function scheduleFlush() {
if (!flushTimer) {
flushTimer = setTimeout(() => {
void flush();
}, FLUSH_MS);
}
}
function enqueue(event) {
buffer.push(event);
if (buffer.length >= BATCH_SIZE) {
void flush();
} else {
scheduleFlush();
}
}
async function postBatch(batch) {
const controller = new AbortController();
const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
try {
await fetch(`${INGEST_URL}/v1/events`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(batch),
signal: controller.signal
});
} finally {
clearTimeout(timeout);
}
}
async function flush() {
if (flushTimer) {
clearTimeout(flushTimer);
flushTimer = null;
}
if (isFlushing || buffer.length === 0) {
return;
}
isFlushing = true;
const batch = buffer.splice(0, BATCH_SIZE);
try {
await postBatch(batch);
} catch {
console.debug(`[agentmon] failed to flush ${batch.length} events`);
} finally {
isFlushing = false;
if (buffer.length > 0) {
if (buffer.length >= BATCH_SIZE) {
void flush();
} else {
scheduleFlush();
}
}
}
}
function emitError(sessionKey, runId, spanId, errorValue) {
if (errorValue === void 0 || errorValue === null || errorValue === false) {
return;
}
const errorRecord = isRecord(errorValue) ? errorValue : {};
const message = pickString(errorRecord.message, errorRecord.error, errorValue) || "unknown";
const errType = pickString(errorRecord.type, errorRecord.code) || "openclaw";
enqueue(buildEnvelope("error", sessionKey, {
runId,
spanId,
payload: {
error: {
type: errType,
message
}
}
}));
}
function buildRunPayload(context, success) {
const payload = {
status: success ? "success" : "error"
};
const duration = pickNumber(context.duration_ms, context.durationMs, context.elapsed_ms);
if (duration !== void 0) {
payload.duration_ms = duration;
}
const usage = isRecord(context.usage) ? context.usage : void 0;
if (usage) {
payload.usage = usage;
}
const errorMessage = pickString(context.error, isRecord(context.result) ? context.result.error : void 0);
if (errorMessage) {
payload.error = errorMessage;
}
return payload;
}
const handler = async (rawEvent) => {
if (!isRecord(rawEvent)) {
return;
}
const context = getContext(rawEvent);
const eventName = getEventName(rawEvent);
const sessionKey = getSessionKey(rawEvent, context);
try {
if (eventName === "command:new") {
enqueue(buildEnvelope("session.start", sessionKey));
return;
}
if (eventName === "command:stop") {
enqueue(buildEnvelope("session.end", sessionKey));
if (sessionKey) {
activeRuns.delete(sessionKey);
}
return;
}
if (eventName === "command:reset") {
enqueue(buildEnvelope("session.end", sessionKey));
enqueue(buildEnvelope("session.start", sessionKey));
if (sessionKey) {
activeRuns.delete(sessionKey);
}
return;
}
if (eventName === "agent:bootstrap") {
const existingRunId = sessionKey ? activeRuns.get(sessionKey) : void 0;
if (!existingRunId) {
const runId = randomUUID();
if (sessionKey) {
activeRuns.set(sessionKey, runId);
}
enqueue(buildEnvelope("run.start", sessionKey, {
runId,
attributes: {
agent_id: pickString(context.agentId),
run_kind: "embedded"
}
}));
}
return;
}
if (eventName === "message:received") {
const runId = randomUUID();
if (sessionKey) {
activeRuns.set(sessionKey, runId);
}
enqueue(buildEnvelope("run.start", sessionKey, {
runId,
attributes: {
channel: pickString(context.channelId, context.channel_id),
from: pickString(context.from, context.sender)
},
payload: {
message_preview: truncate(
pickString(context.content, context.message, context.text) || context.input,
200
)
}
}));
return;
}
if (eventName === "message:sent") {
const runId = sessionKey ? activeRuns.get(sessionKey) : void 0;
const success = context.success !== false && !context.error;
enqueue(buildEnvelope("run.end", sessionKey, {
runId,
attributes: {
channel: pickString(context.channelId, context.channel_id),
to: pickString(context.to, context.recipient)
},
payload: buildRunPayload(context, success)
}));
if (!success) {
emitError(sessionKey, runId, void 0, context.error);
}
return;
}
} catch {
console.debug("[agentmon] handler error");
}
};
var handler_default = handler;
export {
handler_default as default
};