- api и worker отдают traces, metrics и logs по OTLP в Collector (memory_limiter, redaction, batch, ограниченная очередь и retry); хранилища: Prometheus (OTLP receiver), Loki, Tempo; Grafana с provisioning datasources и dashboard «Messenger lab6» - W3C trace context через outbox и RabbitMQ: producer/consumer spans связывают upload, публикации и попытки worker в одном trace - SLO доступности API (SLI на HAProxy) и времени до ready, multiwindow burn-rate alerts, ApiHighErrorRate, JobQueueLagGrowing, DbPoolSaturated, TelemetryExportFailing; unit-тесты promtool, runbooks - кампания трека 2 (k6, 6 отказов по расписанию), разбор и графики; проверки сигналов и истории telemetry, evidence и REPORT.md
61 lines
2.9 KiB
TypeScript
61 lines
2.9 KiB
TypeScript
// Разбор и проверка входных данных запроса.
|
|
import type { IncomingMessage } from 'node:http';
|
|
import { badRequest, tooLarge, unsupported } from './errors.ts';
|
|
|
|
const BODY_LIMIT = 1 << 20; // 1 MiB: с запасом для 4000 символов в худшем JSON-экранировании
|
|
export const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
|
|
// Тело запроса как JSON: только application/json, строгий UTF-8, ограничение размера.
|
|
export async function readJson(req: IncomingMessage): Promise<unknown> {
|
|
if (mediaType(req) !== 'application/json') throw unsupported('Ожидается application/json');
|
|
const chunks: Buffer[] = [];
|
|
let size = 0;
|
|
for await (const chunk of req) {
|
|
size += chunk.length;
|
|
if (size > BODY_LIMIT) throw tooLarge('Слишком большое тело запроса');
|
|
chunks.push(chunk);
|
|
}
|
|
try {
|
|
return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks)));
|
|
} catch {
|
|
throw badRequest('Некорректный JSON');
|
|
}
|
|
}
|
|
|
|
// Тип тела без параметров (charset и т.п.), в нижнем регистре.
|
|
export function mediaType(req: IncomingMessage): string {
|
|
return (req.headers['content-type'] ?? '').split(';')[0].trim().toLowerCase();
|
|
}
|
|
|
|
// Для эндпоинтов без тела: любое непустое тело — 400, а не молча игнорируется.
|
|
export async function requireEmptyBody(req: IncomingMessage): Promise<void> {
|
|
let size = 0;
|
|
for await (const chunk of req) {
|
|
size += chunk.length;
|
|
if (size > BODY_LIMIT) break;
|
|
}
|
|
if (size > 0) throw badRequest('Тело запроса не допускается');
|
|
}
|
|
|
|
// JSON-объект только с разрешёнными ключами: лишние поля по контракту дают 400.
|
|
export function jsonObject(value: unknown, keys: string[]): Record<string, unknown> {
|
|
if (typeof value !== 'object' || value === null || Array.isArray(value) || Object.keys(value).some((k) => !keys.includes(k))) {
|
|
throw badRequest('Ожидается JSON-объект без лишних полей');
|
|
}
|
|
return value as Record<string, unknown>;
|
|
}
|
|
|
|
// Обязательная строка: не только пробелы, длина в Unicode code points (эмодзи = 1 символ).
|
|
export function isText(v: unknown, min: number, max: number): v is string {
|
|
if (typeof v !== 'string' || v.trim() === '') return false;
|
|
const n = [...v].length;
|
|
return n >= min && n <= max;
|
|
}
|
|
|
|
// UUID из пути в каноническом нижнем регистре.
|
|
export function uuidParam(c: { params: string[] }, name: string): string {
|
|
const value = c.params[0];
|
|
if (!UUID.test(value)) throw badRequest(`Некорректный ${name}`);
|
|
return value.toLowerCase();
|
|
}
|