Files
OmniRoute/tests/unit/observability-payloads.test.ts
Xiangzhe 8ca40e7971 feat(api): wire shared admission across LLM routes
Acquire admission once after API-key policy, preserve lazy raw-request snapshots, and bind lease settlement to JSON, SSE, abort, deadline, and failure lifecycles. Expose a low-cardinality health summary and preserve non-SSE Ollama errors unchanged.
2026-08-05 08:44:59 -03:00

276 lines
7.8 KiB
TypeScript

import test from "node:test";
import assert from "node:assert/strict";
import {
buildHealthPayload,
buildSessionsSummary,
buildTelemetryPayload,
projectAdaptiveAdmissionSummary,
} from "../../src/lib/monitoring/observability.ts";
test("buildSessionsSummary returns sticky counts and ordered top sessions", () => {
const summary = buildSessionsSummary({
activeSessions: [
{
sessionId: "sess-b",
createdAt: 1_000,
lastActive: 5_000,
requestCount: 3,
connectionId: "conn-b",
ageMs: 4_000,
},
{
sessionId: "sess-a",
createdAt: 1_000,
lastActive: 8_000,
requestCount: 5,
connectionId: null,
ageMs: 7_000,
},
],
activeSessionsByKey: { key1: 2 },
});
assert.equal(summary.activeCount, 2);
assert.equal(summary.stickyBoundCount, 1);
assert.equal(summary.byApiKey.key1, 2);
assert.equal(summary.top[0].sessionId, "sess-a");
assert.equal(summary.top[1].sessionId, "sess-b");
});
test("buildTelemetryPayload exposes totalRequests alias plus quota/session signals", () => {
const payload = buildTelemetryPayload({
summary: {
count: 7,
p50: 120,
p95: 320,
p99: 450,
phaseBreakdown: {
connect: { p50: 80, p95: 200, avg: 110, count: 7 },
},
},
quotaMonitorSummary: {
active: 3,
alerting: 2,
exhausted: 1,
errors: 1,
statusCounts: {
starting: 0,
idle: 0,
healthy: 1,
warning: 1,
exhausted: 1,
error: 0,
},
byProvider: { codex: 3 },
},
activeSessions: [
{
sessionId: "sess-a",
createdAt: 1_000,
lastActive: 8_000,
requestCount: 5,
connectionId: "conn-a",
ageMs: 7_000,
},
],
});
assert.equal(payload.totalRequests, 7);
assert.equal(payload.sessions.activeCount, 1);
assert.equal(payload.sessions.stickyBoundCount, 1);
assert.equal(payload.quotaMonitor.active, 3);
assert.equal(payload.quotaMonitor.exhausted, 1);
});
test("buildHealthPayload keeps legacy aliases and adds session/quota observability blocks", () => {
const payload = buildHealthPayload({
appVersion: "1.2.3",
catalogCount: 99,
settings: { setupComplete: true },
connections: [
{ provider: "codex", isActive: true },
{ provider: "openai", isActive: false },
],
circuitBreakers: [
{ name: "codex", state: "OPEN", failureCount: 2, lastFailureTime: "2026-04-12T12:00:00Z" },
{ name: "test-ignore", state: "OPEN", failureCount: 9, lastFailureTime: null },
],
rateLimitStatus: { codex: { blocked: 1 } },
lockouts: { codex: { "conn-1": { until: "2026-04-12T13:00:00Z" } } },
localProviders: { ollama: { ok: true } },
inflightRequests: 4,
quotaMonitorSummary: {
active: 1,
alerting: 1,
exhausted: 0,
errors: 0,
statusCounts: {
starting: 0,
idle: 0,
healthy: 0,
warning: 1,
exhausted: 0,
error: 0,
},
byProvider: { codex: 1 },
},
quotaMonitorMonitors: [
{
sessionId: "sess-a",
provider: "codex",
accountId: "conn-1",
status: "warning",
startedAt: "2026-04-12T12:00:00.000Z",
lastPolledAt: "2026-04-12T12:01:00.000Z",
lastSuccessAt: "2026-04-12T12:01:00.000Z",
lastErrorAt: null,
lastError: null,
lastQuotaPercent: 0.91,
lastQuotaUsed: 91,
lastQuotaTotal: 100,
lastResetAt: "2026-04-12T17:00:00.000Z",
lastAlertAt: "2026-04-12T12:01:00.000Z",
nextPollDelayMs: 15000,
nextPollAt: "2026-04-12T12:01:15.000Z",
totalPolls: 1,
totalAlerts: 1,
consecutiveFailures: 0,
},
],
activeSessions: [
{
sessionId: "sess-a",
createdAt: 1_000,
lastActive: 8_000,
requestCount: 5,
connectionId: "conn-1",
ageMs: 7_000,
},
],
activeSessionsByKey: { key1: 1 },
});
assert.equal(payload.version, "1.2.3");
assert.equal(payload.providerSummary.catalogCount, 99);
assert.equal(payload.providerSummary.configuredCount, 2);
assert.equal(payload.providerSummary.activeCount, 1);
assert.equal(payload.providerSummary.monitoredCount, 1);
assert.equal(payload.activeConnections, 2);
assert.equal(payload.circuitBreakers.open, 1);
assert.equal(payload.sessions.activeCount, 1);
assert.equal(payload.sessions.stickyBoundCount, 1);
assert.equal(payload.quotaMonitor.active, 1);
assert.equal(payload.quotaMonitor.monitors[0].provider, "codex");
assert.equal(payload.setupComplete, true);
assert.equal(payload.adaptiveAdmission, null);
});
test("buildHealthPayload projects allowlisted adaptiveAdmission aggregates only", () => {
const snapshot = {
mode: "enforce",
currentLimit: 4,
minLimit: 1,
maxLimit: 8,
activeCost: 2,
activeCount: 1,
queuedCost: 3,
queuedCount: 1,
virtualActiveCost: 99,
virtualActiveCount: 99,
virtualQueuedCost: 99,
virtualQueuedCount: 99,
admittedCount: 10,
rejectedCount: 2,
wouldAdmitCount: 7,
wouldQueueCount: 1,
wouldRejectCount: 3,
shortLatencyEwma: 12.5,
longLatencyEwma: 40.1,
utilization: 0.42,
pressure: "high",
resourceSeverity: "normal",
resourceReason: "none",
resourceObservedAtMs: 1_700_000_000_000,
pressureGuardRejectCount: 5,
shutdown: false,
// Malicious / high-card sentinels that must never appear in the public payload.
tenantId: "tenant-SECRET-should-not-leak",
apiKey: "sk-live-SHOULD-NOT-LEAK",
model: "openai/gpt-secret-model",
sessionId: "sess-secret",
requestId: "req-secret",
body: { messages: [{ role: "user", content: "PII-body-secret" }] },
queueItems: [{ tenantKey: "t-secret", cost: 9 }],
resourcePath: "/sys/fs/cgroup/memory.current",
} as unknown as import("../../open-sse/services/admission/runtime.ts").AdaptiveAdmissionPublicSnapshot;
const payload = buildHealthPayload({
appVersion: "9.9.9",
settings: { setupComplete: false },
connections: [],
circuitBreakers: [],
rateLimitStatus: {},
learnedLimits: {},
lockouts: {},
localProviders: {},
inflightRequests: 0,
quotaMonitorSummary: {
active: 0,
alerting: 0,
exhausted: 0,
errors: 0,
statusCounts: {
starting: 0,
idle: 0,
healthy: 0,
warning: 0,
exhausted: 0,
error: 0,
},
byProvider: {},
},
quotaMonitorMonitors: [],
activeSessions: [],
adaptiveAdmission: snapshot,
});
assert.deepEqual(payload.adaptiveAdmission, {
mode: "enforce",
currentLimit: 4,
minLimit: 1,
maxLimit: 8,
activeCost: 2,
activeCount: 1,
queuedCost: 3,
queuedCount: 1,
admittedCount: 10,
rejectedCount: 2,
wouldAdmitCount: 7,
wouldQueueCount: 1,
wouldRejectCount: 3,
utilization: 0.42,
pressure: "high",
resourceSeverity: "normal",
resourceReason: "none",
resourceObservedAtMs: 1_700_000_000_000,
pressureGuardRejectCount: 5,
shutdown: false,
});
const json = JSON.stringify(payload);
assert.equal(json.includes("tenant-SECRET"), false);
assert.equal(json.includes("sk-live-SHOULD-NOT-LEAK"), false);
assert.equal(json.includes("gpt-secret-model"), false);
assert.equal(json.includes("PII-body-secret"), false);
assert.equal(json.includes("t-secret"), false);
assert.equal(json.includes("memory.current"), false);
assert.equal(json.includes("queueItems"), false);
assert.equal(json.includes("virtualActiveCost"), false);
assert.equal(json.includes("shortLatencyEwma"), false);
// Direct projector also null-safe.
assert.equal(projectAdaptiveAdmissionSummary(null), null);
assert.equal(projectAdaptiveAdmissionSummary(undefined), null);
});