shield360 1.0.1 → 1.2.0

package/dist/otel/log-bridges.js

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLimiter = void 0;
+exports.pinoLevel = pinoLevel;
+exports.pinoStream = pinoStream;
+exports.winstonLevel = winstonLevel;
+exports.winstonTransport = winstonTransport;
+exports.captureConsole = captureConsole;
+exports.releaseConsole = releaseConsole;
+exports.captureStdio = captureStdio;
+exports.releaseStdio = releaseStdio;
+const masking_1 = require("../masking");
+const app_logs_1 = require("./app-logs");
+Object.defineProperty(exports, "createLimiter", { enumerable: true, get: function () { return app_logs_1.createLimiter; } });
+let writing = false;
+/** Messages from the telemetry pipeline itself, which must never be exported back into it. */
+const OWN_MESSAGE = /^(@opentelemetry|OTLPExporterError|Shield360[\s:]|\[shield360\]|\{"stack":"OTLPExporterError)/i;
+/** The bridge's logger: its own scope and its own rate limit. */
+function bridgeLogger(fallbackName, options) {
+    return (0, app_logs_1.createLogger)(options.name || fallbackName, { maxPerSecond: options.maxPerSecond });
+}
+function guarded(logger) {
+    return (level, message, attributes) => {
+        if (writing)
+            return;
+        const text = message instanceof Error ? message.message : message;
+        if (OWN_MESSAGE.test(text))
+            return;
+        writing = true;
+        try {
+            logger[level](message, attributes);
+        }
+        finally {
+            writing = false;
+        }
+    };
+}
+// ------------------------------------------------------------------- pino
+const PINO_LEVELS = [
+    [60, 'fatal'],
+    [50, 'error'],
+    [40, 'warn'],
+    [30, 'info'],
+    [0, 'debug'],
+];
+function pinoLevel(level) {
+    if (typeof level === 'number')
+        return PINO_LEVELS.find(([n]) => level >= n)?.[1] ?? 'info';
+    const name = String(level || '').toLowerCase();
+    if (name === 'trace' || name === 'debug')
+        return 'debug';
+    if (name === 'warn' || name === 'warning')
+        return 'warn';
+    if (name === 'error' || name === 'fatal' || name === 'info')
+        return name;
+    return 'info';
+}
+const PINO_FIELDS = new Set(['level', 'time', 'msg', 'pid', 'hostname', 'v', 'err']);
+function flatAttributes(record, skip) {
+    const out = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (skip.has(key) || value === undefined || value === null)
+            continue;
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
+            out[key] = value;
+        else {
+            try {
+                // Masked before it becomes text, so nested credential names are masked by name.
+                out[key] = JSON.stringify((0, masking_1.maskValue)(key, value, 4096)).slice(0, 4096);
+            }
+            catch {
+                // Not serialisable: left out.
+            }
+        }
+    }
+    return out;
+}
+/**
+ * A pino destination: `pino({}, pino.multistream([{ stream: process.stdout }, { stream: Shield360.pinoStream() }]))`.
+ * Each line pino writes is one JSON record; `msg` becomes the body, `level`
+ * the severity, `err` the exception attributes, the rest attributes.
+ */
+function pinoStream(options = {}) {
+    const emit = guarded(bridgeLogger('pino', options));
+    return {
+        write(line) {
+            for (const chunk of String(line).split('\n')) {
+                if (!chunk.trim())
+                    continue;
+                let record;
+                try {
+                    record = JSON.parse(chunk);
+                }
+                catch {
+                    emit('info', chunk);
+                    continue;
+                }
+                const level = pinoLevel(record.level);
+                const attributes = flatAttributes(record, PINO_FIELDS);
+                const err = record.err;
+                if (err && typeof err === 'object') {
+                    if (err.type)
+                        attributes['exception.type'] = String(err.type);
+                    if (err.message)
+                        attributes['exception.message'] = String(err.message);
+                    if (err.stack)
+                        attributes['exception.stacktrace'] = String(err.stack).slice(0, 16384);
+                }
+                emit(level, typeof record.msg === 'string' ? record.msg : err?.message ? String(err.message) : '', attributes);
+            }
+            return true;
+        },
+    };
+}
+const WINSTON_FIELDS = new Set(['level', 'message', 'timestamp', 'stack']);
+const LEVEL_SYMBOL = Symbol.for('level');
+function winstonLevel(level) {
+    const name = String(level || '').toLowerCase();
+    if (name === 'error' || name === 'crit' || name === 'alert' || name === 'emerg')
+        return name === 'error' ? 'error' : 'fatal';
+    if (name === 'warn' || name === 'warning')
+        return 'warn';
+    if (name === 'debug' || name === 'verbose' || name === 'silly')
+        return 'debug';
+    return 'info';
+}
+/**
+ * A winston transport class on the app's own `winston-transport`:
+ *
+ *   import Transport from 'winston-transport';
+ *   const Shield360Transport = Shield360.winstonTransport(Transport);
+ *   winston.createLogger({ transports: [new winston.transports.Console(), new Shield360Transport()] });
+ */
+function winstonTransport(Transport, options = {}) {
+    const emit = guarded(bridgeLogger('winston', options));
+    return class Shield360WinstonTransport extends Transport {
+        log(info, callback) {
+            try {
+                const level = winstonLevel(info[LEVEL_SYMBOL] ?? info.level);
+                const attributes = flatAttributes(info, WINSTON_FIELDS);
+                if (typeof info.stack === 'string')
+                    attributes['exception.stacktrace'] = info.stack.slice(0, 16384);
+                const message = info.message instanceof Error ? info.message : String(info.message ?? '');
+                emit(level, message, attributes);
+            }
+            finally {
+                this.emit?.('logged', info);
+                callback?.();
+            }
+        }
+    };
+}
+// ---------------------------------------------------------------- console
+const CONSOLE_METHODS = [
+    ['debug', 'debug'],
+    ['log', 'info'],
+    ['info', 'info'],
+    ['warn', 'warn'],
+    ['error', 'error'],
+];
+let original = null;
+function formatArgs(args) {
+    const error = args.find((a) => a instanceof Error);
+    const text = args
+        .map((a) => {
+        if (typeof a === 'string')
+            return a;
+        if (a instanceof Error)
+            return a.message;
+        try {
+            return JSON.stringify(a);
+        }
+        catch {
+            return String(a);
+        }
+    })
+        .join(' ')
+        .slice(0, 16384);
+    if (error)
+        return { message: Object.assign(new Error(text), { name: error.name, stack: error.stack }) };
+    return { message: text };
+}
+/** Copies console output to Shield360 application logs (still printed as before). Call releaseConsole() to stop. */
+function captureConsole(options = {}) {
+    if (original)
+        return;
+    const emit = guarded(bridgeLogger('console', options));
+    original = {};
+    for (const [method, level] of CONSOLE_METHODS) {
+        const previous = console[method];
+        original[method] = previous;
+        console[method] = (...args) => {
+            previous.apply(console, args);
+            if (writing)
+                return;
+            try {
+                const { message } = formatArgs(args);
+                emit(level, message);
+            }
+            catch {
+                // Logging never throws into the application.
+            }
+        };
+    }
+}
+/** Puts console back as it was. */
+function releaseConsole() {
+    if (!original)
+        return;
+    for (const [method, fn] of Object.entries(original)) {
+        if (fn)
+            console[method] = fn;
+    }
+    original = null;
+}
+const LINE_FIELDS = new Set(['level', 'time', 'timestamp', 'msg', 'message', 'pid', 'hostname', 'v', 'err', 'error']);
+/** A line longer than this without a newline is sent as it is. */
+const MAX_PENDING = 65536;
+let stdioOriginal = null;
+/** One written line as a record: JSON log lines (pino, bunyan and most JSON loggers) by their fields, other lines as text. */
+function emitLine(emit, line, plainLevel) {
+    if (!line.trim())
+        return;
+    let record;
+    try {
+        record = line.trimStart().startsWith('{') ? JSON.parse(line) : undefined;
+    }
+    catch {
+        record = undefined;
+    }
+    if (!record || typeof record !== 'object' || Array.isArray(record)) {
+        emit(plainLevel, line);
+        return;
+    }
+    const fields = record;
+    const attributes = flatAttributes(fields, LINE_FIELDS);
+    const err = (fields.err ?? fields.error);
+    if (err && typeof err === 'object') {
+        const type = err.type ?? err.name;
+        if (type)
+            attributes['exception.type'] = String(type);
+        if (err.message)
+            attributes['exception.message'] = String(err.message);
+        if (err.stack)
+            attributes['exception.stacktrace'] = String(err.stack).slice(0, 16384);
+    }
+    const message = typeof fields.msg === 'string' ? fields.msg : typeof fields.message === 'string' ? fields.message : err?.message ? String(err.message) : '';
+    emit(fields.level === undefined ? plainLevel : pinoLevel(fields.level), message, attributes);
+}
+/**
+ * Copies every line written to stdout and stderr to Shield360 application logs; the output itself
+ * is unchanged. JSON lines keep their level, message, fields and error; plain lines are info on
+ * stdout and error on stderr. Lines split across writes are joined. Call releaseStdio() to stop.
+ */
+function captureStdio(options = {}) {
+    if (stdioOriginal)
+        return;
+    stdioOriginal = [];
+    const streams = [
+        [options.stdout ?? process.stdout, 'stdout', 'info'],
+        [options.stderr ?? process.stderr, 'stderr', 'error'],
+    ];
+    for (const [stream, name, plainLevel] of streams) {
+        if (!stream || typeof stream.write !== 'function')
+            continue;
+        const emit = guarded(bridgeLogger(options.name || name, options));
+        const previous = stream.write;
+        let pending = '';
+        stdioOriginal.push({ stream, write: previous, own: Object.prototype.hasOwnProperty.call(stream, 'write') });
+        stream.write = function (chunk, ...rest) {
+            const result = previous.call(this, chunk, ...rest);
+            if (writing)
+                return result;
+            try {
+                const text = typeof chunk === 'string' ? chunk : chunk instanceof Uint8Array ? Buffer.from(chunk).toString('utf8') : '';
+                if (text) {
+                    pending += text;
+                    const lines = pending.split('\n');
+                    pending = lines.pop() ?? '';
+                    if (pending.length > MAX_PENDING) {
+                        lines.push(pending);
+                        pending = '';
+                    }
+                    for (const line of lines)
+                        emitLine(emit, line.replace(/\r$/, ''), plainLevel);
+                }
+            }
+            catch {
+                // Logging never throws into the application.
+            }
+            return result;
+        };
+    }
+}
+/** Puts stdout and stderr back as they were. */
+function releaseStdio() {
+    if (!stdioOriginal)
+        return;
+    for (const { stream, write, own } of stdioOriginal) {
+        if (own)
+            stream.write = write;
+        else
+            delete stream.write;
+    }
+    stdioOriginal = null;
+}
+//# sourceMappingURL=log-bridges.js.map

package/dist/otel/log-bridges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-bridges.js","sourceRoot":"","sources":["../../src/otel/log-bridges.ts"],"names":[],"mappings":"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"}

package/dist/otel/system-metrics.d.ts

@@ -0,0 +1,39 @@
+import type { Meter } from '@opentelemetry/api';
+export declare const SYSTEM_METRIC_NAMES: {
+    readonly systemCpu: "system.cpu.utilization";
+    readonly systemMemoryUtilization: "system.memory.utilization";
+    readonly systemMemoryUsage: "system.memory.usage";
+    readonly processCpu: "process.cpu.utilization";
+    readonly processMemory: "process.memory.usage";
+    readonly eventLoopDelay: "nodejs.eventloop.delay.p99";
+};
+/** The option, else SHIELD360_COLLECT_SYSTEM_METRICS, else off. */
+export declare function resolveCollectSystemMetrics(option?: boolean): boolean;
+type CpuTimes = {
+    idle: number;
+    total: number;
+};
+/** Busy share between two samples of all cores' times; null when no time passed. */
+export declare function cpuBusy(before: CpuTimes, after: CpuTimes): number | null;
+export type SystemSampler = {
+    host(): number | null;
+    process(): number | null;
+    memory(): {
+        used: number;
+        total: number;
+    };
+    rss(): number;
+    loopDelaySeconds(): number | null;
+};
+/** Samples from Node itself; each CPU reading is the share since the previous one. */
+export declare function nodeSampler(): SystemSampler & {
+    stop(): void;
+};
+/**
+ * Registers the gauges on `meter`. Returns a function that stops sampling.
+ * Calling it again replaces the previous registration's sampler.
+ */
+export declare function setupSystemMetrics(meter: Meter, sampler?: SystemSampler & {
+    stop?(): void;
+}): () => void;
+export {};

package/dist/otel/system-metrics.js

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYSTEM_METRIC_NAMES = void 0;
+exports.resolveCollectSystemMetrics = resolveCollectSystemMetrics;
+exports.cpuBusy = cpuBusy;
+exports.nodeSampler = nodeSampler;
+exports.setupSystemMetrics = setupSystemMetrics;
+/**
+ * Server and process metrics, when asked for.
+ *
+ * The TypeScript twin of Python's `collect_system_metrics`: a few observable
+ * gauges sampled each time the SDK's metric reader exports (every 60 s unless
+ * OTEL_EXPORTER_OTLP_METRICS_EXPORT_INTERVAL says otherwise), so nothing runs
+ * between exports except Node's own event-loop delay histogram. They go to the
+ * same destination as the spans, under the application's service.name, and
+ * Shield360's Infrastructure view reads them by those names:
+ *
+ *   system.cpu.utilization       host CPU busy, 0..1 (all cores)
+ *   system.memory.utilization    host memory in use, 0..1
+ *   system.memory.usage          host memory in use, bytes (state=used)
+ *   process.cpu.utilization      this process's CPU, 0..1 of one host
+ *   process.memory.usage         this process's resident set size, bytes
+ *   nodejs.eventloop.delay.p99   event-loop delay, seconds
+ *
+ * Every gauge carries host.name. Nothing is collected unless it is turned on:
+ * `collectSystemMetrics: true` in init(), or SHIELD360_COLLECT_SYSTEM_METRICS=true.
+ */
+const os_1 = __importDefault(require("os"));
+const perf_hooks_1 = require("perf_hooks");
+const utils_1 = require("./utils");
+exports.SYSTEM_METRIC_NAMES = {
+    systemCpu: 'system.cpu.utilization',
+    systemMemoryUtilization: 'system.memory.utilization',
+    systemMemoryUsage: 'system.memory.usage',
+    processCpu: 'process.cpu.utilization',
+    processMemory: 'process.memory.usage',
+    eventLoopDelay: 'nodejs.eventloop.delay.p99',
+};
+/** The option, else SHIELD360_COLLECT_SYSTEM_METRICS, else off. */
+function resolveCollectSystemMetrics(option) {
+    return option ?? (0, utils_1.parseBoolEnv)('SHIELD360_COLLECT_SYSTEM_METRICS') ?? false;
+}
+function cpuTimes() {
+    let idle = 0;
+    let total = 0;
+    for (const cpu of os_1.default.cpus()) {
+        const t = cpu.times;
+        idle += t.idle;
+        total += t.user + t.nice + t.sys + t.irq + t.idle;
+    }
+    return { idle, total };
+}
+/** Busy share between two samples of all cores' times; null when no time passed. */
+function cpuBusy(before, after) {
+    const total = after.total - before.total;
+    if (total <= 0)
+        return null;
+    return Math.min(1, Math.max(0, 1 - (after.idle - before.idle) / total));
+}
+/** Samples from Node itself; each CPU reading is the share since the previous one. */
+function nodeSampler() {
+    let lastHost = cpuTimes();
+    let lastProcess = { usage: process.cpuUsage(), at: process.hrtime.bigint() };
+    let histogram = null;
+    try {
+        histogram = (0, perf_hooks_1.monitorEventLoopDelay)({ resolution: 20 });
+        histogram.enable();
+    }
+    catch {
+        histogram = null;
+    }
+    return {
+        host() {
+            const now = cpuTimes();
+            const busy = cpuBusy(lastHost, now);
+            lastHost = now;
+            return busy;
+        },
+        process() {
+            const usage = process.cpuUsage();
+            const at = process.hrtime.bigint();
+            const elapsedMicros = Number(at - lastProcess.at) / 1000;
+            const used = usage.user - lastProcess.usage.user + (usage.system - lastProcess.usage.system);
+            lastProcess = { usage, at };
+            if (elapsedMicros <= 0)
+                return null;
+            const cores = Math.max(1, os_1.default.cpus().length);
+            return Math.min(1, Math.max(0, used / elapsedMicros / cores));
+        },
+        memory() {
+            const total = os_1.default.totalmem();
+            return { used: total - os_1.default.freemem(), total };
+        },
+        rss() {
+            return process.memoryUsage().rss;
+        },
+        loopDelaySeconds() {
+            if (!histogram)
+                return null;
+            const p99 = histogram.percentile(99);
+            histogram.reset();
+            return Number.isFinite(p99) && p99 > 0 ? p99 / 1e9 : null;
+        },
+        stop() {
+            histogram?.disable();
+        },
+    };
+}
+let active = null;
+/**
+ * Registers the gauges on `meter`. Returns a function that stops sampling.
+ * Calling it again replaces the previous registration's sampler.
+ */
+function setupSystemMetrics(meter, sampler = nodeSampler()) {
+    active?.stop();
+    const attributes = { 'host.name': os_1.default.hostname() };
+    const observe = (fn) => (result) => {
+        try {
+            fn(result);
+        }
+        catch {
+            // A metric never throws into the application.
+        }
+    };
+    meter
+        .createObservableGauge(exports.SYSTEM_METRIC_NAMES.systemCpu, { description: 'Host CPU busy share across all cores', unit: '1' })
+        .addCallback(observe((r) => {
+        const v = sampler.host();
+        if (v !== null)
+            r.observe(v, attributes);
+    }));
+    meter
+        .createObservableGauge(exports.SYSTEM_METRIC_NAMES.systemMemoryUtilization, { description: 'Host memory in use', unit: '1' })
+        .addCallback(observe((r) => {
+        const { used, total } = sampler.memory();
+        if (total > 0)
+            r.observe(used / total, attributes);
+    }));
+    meter
+        .createObservableGauge(exports.SYSTEM_METRIC_NAMES.systemMemoryUsage, { description: 'Host memory in use', unit: 'By' })
+        .addCallback(observe((r) => r.observe(sampler.memory().used, { ...attributes, state: 'used' })));
+    meter
+        .createObservableGauge(exports.SYSTEM_METRIC_NAMES.processCpu, { description: 'This process\'s CPU share of the host', unit: '1' })
+        .addCallback(observe((r) => {
+        const v = sampler.process();
+        if (v !== null)
+            r.observe(v, attributes);
+    }));
+    meter
+        .createObservableGauge(exports.SYSTEM_METRIC_NAMES.processMemory, { description: 'Resident set size of this process', unit: 'By' })
+        .addCallback(observe((r) => r.observe(sampler.rss(), attributes)));
+    meter
+        .createObservableGauge(exports.SYSTEM_METRIC_NAMES.eventLoopDelay, { description: 'Event-loop delay, 99th percentile since the last export', unit: 's' })
+        .addCallback(observe((r) => {
+        const v = sampler.loopDelaySeconds();
+        if (v !== null)
+            r.observe(v, attributes);
+    }));
+    const stop = () => sampler.stop?.();
+    active = { stop };
+    return stop;
+}
+//# sourceMappingURL=system-metrics.js.map

package/dist/otel/system-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-metrics.js","sourceRoot":"","sources":["../../src/otel/system-metrics.ts"],"names":[],"mappings":"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"}

package/dist/otel/tracing.js

@@ -9,6 +9,9 @@ const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-h
 const instrumentation_1 = __importDefault(require("../instrumentation"));
 const config_1 = __importDefault(require("../config"));
 const utils_1 = require("./utils");
+const code_location_1 = require("./code-location");
+// Cost per end customer: stamps the customer in effect on every span.
+const customer_1 = require("../customer");
 let TRACER_SET = false;
 class Tracing {
     static setup(options) {
@@ -22,6 +25,10 @@ class Tracing {
                 if (isSDKProvider) {
                     // Reuse existing SDK TracerProvider
                     this.traceProvider = existingProvider;
+                    existingProvider.addSpanProcessor(new customer_1.CustomerSpanProcessor());
+                    if (options.captureCodeLocation) {
+                        existingProvider.addSpanProcessor(new code_location_1.CodeLocationSpanProcessor({ codeRoot: options.codeRoot }));
+                    }
                 }
                 else {
                     const spanProcessors = Tracing.buildSpanProcessors(options);
@@ -46,7 +53,11 @@ class Tracing {
         }
     }
     static buildSpanProcessors(options) {
-        const processors = [];
+        // The customer processor goes first so every exporter sees its attributes.
+        const processors = [new customer_1.CustomerSpanProcessor()];
+        if (options.captureCodeLocation) {
+            processors.push(new code_location_1.CodeLocationSpanProcessor({ codeRoot: options.codeRoot }));
+        }
         const exporterList = (0, utils_1.parseExporters)('OTEL_TRACES_EXPORTER');
         if (exporterList) {
             for (const name of exporterList) {

package/dist/otel/tracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/otel/tracing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/otel/tracing.ts"],"names":[],"mappings":"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"}