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:
bobbanandClaude Sonnet 5.5 committed 2026-10-17 20:41:00 +02:00
1 parent c36e2092c5
commit c17e9aa140
55 files changed
+7177 -27

No files matched your search

+63
View File
@@ -0,0 +1,63 @@
import { Router } from "express";
import { eq } from "drizzle-orm";
import { z } from "zod";
import { db } from "../db/client.js";
import { metricsTokens } from "../db/schema.js";
import { requireAuth, requireRole } from "../auth/middleware.js";
import { recordAudit } from "../services/audit.js";
import { buildMetrics } from "../services/metrics.js";
import { createMetricsToken, publicMetricsToken, resolveMetricsToken } from "../services/metricsTokens.js";
import { asyncHandler } from "../utils/asyncHandler.js";
import { rateLimit } from "../utils/rateLimit.js";
/** Prometheus's scrape: no sign-in, a bearer token instead. The token goes in a header only — never the address, which ends up in logs. */
export const metricsRouter = Router();
const limiter = rateLimit({ windowMs: 60_000, max: 120, message: "Too many requests." });
metricsRouter.get("/", limiter, asyncHandler(async (req, res) => {
const match = /^Bearer\s+(\S+)$/i.exec(req.get("authorization") ?? "");
const token = match ? await resolveMetricsToken(match[1]) : null;
if (!token) {
// The same answer for no token, a wrong one and a removed one.
res.setHeader("WWW-Authenticate", 'Bearer realm="metrics"');
return res.status(401).type("text/plain").send("A metrics token is needed: send it as 'Authorization: Bearer <token>'.\n");
}
res.setHeader("Cache-Control", "no-store");
// Written out as Prometheus documents it (Express would put the parameters in another order).
res.setHeader("Content-Type", "text/plain; version=0.0.4; charset=utf-8");
res.end(await buildMetrics());
}));
/** Managing the tokens: an administrator's. */
export const metricsTokensRouter = Router();
metricsTokensRouter.use(requireAuth, requireRole("admin"));
const MAX_TOKENS = 10;
metricsTokensRouter.get("/", asyncHandler(async (_req, res) => {
const rows = await db.select().from(metricsTokens).orderBy(metricsTokens.createdAt);
res.json({ tokens: rows.map(publicMetricsToken) });
}));
// The secret is in this answer and nowhere else, ever.
metricsTokensRouter.post("/", asyncHandler(async (req, res) => {
const parsed = z.object({ label: z.string().trim().min(1).max(60) }).safeParse(req.body);
if (!parsed.success) return res.status(400).json({ error: "invalid_body", message: "Give the token a name, like Prometheus." });
if ((await db.select({ id: metricsTokens.id }).from(metricsTokens)).length >= MAX_TOKENS) {
return res.status(400).json({ error: "too_many", message: `There are already ${MAX_TOKENS} tokens. Remove one you don't use first.` });
}
const actor = req.currentUser!;
const { row, token } = await createMetricsToken({ label: parsed.data.label, createdBy: actor.name ?? actor.email ?? actor.oidcSub });
await recordAudit({ actor, category: "metrics_token", action: "create", targetType: "metrics_token", targetId: row.id, detail: { label: row.label } });
res.status(201).json({ token: publicMetricsToken(row), secret: token });
}));
metricsTokensRouter.delete("/:id", asyncHandler(async (req, res) => {
const id = /^\d+$/.test(req.params.id) ? Number(req.params.id) : NaN;
if (!Number.isInteger(id)) return res.status(400).json({ error: "invalid_id" });
const [row] = await db.select().from(metricsTokens).where(eq(metricsTokens.id, id)).limit(1);
if (!row) return res.status(404).json({ error: "not_found" });
await db.delete(metricsTokens).where(eq(metricsTokens.id, id));
await recordAudit({ actor: req.currentUser!, category: "metrics_token", action: "delete", targetType: "metrics_token", targetId: id, detail: { label: row.label } });
res.status(204).end();
}));