Add runbooks, backup coverage, inventory, roles from groups, Prometheus metrics and event webhooks
- Runbooks: notes per server/integration, shown next to matching alerts - Backup coverage page across Proxmox and PBS, with a digest section - Hardware inventory with warranty, power and running cost - Authentik group to role mapping with preview and safeguards - /metrics (bearer token) and signed outgoing event webhooks - Docs: README, DATABASE, NOTIFICATIONS, ROLES and new API.md Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c36e2092c5
commit
c17e9aa140
55 files changed
+7177
-27
No files matched your search
@@ -0,0 +1,53 @@
|
||||
/**
|
||||
* Turns maintenance windows beginning and ending into events, whatever made the window — by hand, in bulk, from a recurring schedule or
|
||||
* mirrored from Uptime Kuma, and whether it ended on its own or was ended early. It simply watches which windows are running: one that
|
||||
* wasn't a moment ago is "started", one that was and isn't now is "ended". After a restart it starts from what is running then, so nothing
|
||||
* is announced twice or announced for a window that began before.
|
||||
*/
|
||||
import { listActiveWindows, describeTarget, type ActiveWindow } from "./maintenance.js";
|
||||
import { emitEvent } from "./eventWebhooks.js";
|
||||
|
||||
const INTERVAL_MS = 30_000;
|
||||
|
||||
let known: Map<number, ActiveWindow> | null = null;
|
||||
let timer: ReturnType<typeof setInterval> | null = null;
|
||||
|
||||
async function describe(w: ActiveWindow) {
|
||||
const target = await describeTarget(w.targetType, w.targetId);
|
||||
return { id: w.id, targetType: w.targetType, targetId: w.targetId, targetName: target?.name ?? null, reason: w.reason, startedAt: w.startedAt, endsAt: w.endsAt, source: w.source };
|
||||
}
|
||||
|
||||
/** One look. Returns what it announced, for the tests. */
|
||||
export async function checkMaintenanceEvents(now: Date = new Date()): Promise<{ started: number[]; ended: number[] }> {
|
||||
const active = new Map((await listActiveWindows(now)).map((w) => [w.id, w]));
|
||||
const started: number[] = [];
|
||||
const ended: number[] = [];
|
||||
if (known !== null) {
|
||||
for (const [id, w] of active) {
|
||||
if (!known.has(id)) {
|
||||
started.push(id);
|
||||
emitEvent("maintenance.started", { window: await describe(w) });
|
||||
}
|
||||
}
|
||||
for (const [id, w] of known) {
|
||||
if (!active.has(id)) {
|
||||
ended.push(id);
|
||||
// The window as it was last seen (one ended early has had its end brought forward since), and when it was noticed to be over.
|
||||
emitEvent("maintenance.ended", { window: { ...(await describe(w)), endedAt: now.toISOString() } });
|
||||
}
|
||||
}
|
||||
}
|
||||
known = active;
|
||||
return { started, ended };
|
||||
}
|
||||
|
||||
/** For tests: forget what was running, so the next look is a first look. */
|
||||
export function resetMaintenanceEventsForTests(): void {
|
||||
known = null;
|
||||
}
|
||||
|
||||
export function initMaintenanceEvents(): void {
|
||||
if (timer) return;
|
||||
void checkMaintenanceEvents().catch((err) => console.error("[maintenanceEvents]", err));
|
||||
timer = setInterval(() => void checkMaintenanceEvents().catch((err) => console.error("[maintenanceEvents]", err)), INTERVAL_MS);
|
||||
}
|
||||
Reference in new issue
Block a user