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>
296 lines
7.8 KiB
JavaScript
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
|
|
};
|