@aztec/telemetry-client 0.0.0-test.0

package/dest/prom_otel_adapter.js

@@ -0,0 +1,183 @@
+import { createLogger } from '@aztec/foundation/log';
+import { Registry } from 'prom-client';
+export var MessageSource = /*#__PURE__*/ function(MessageSource) {
+    MessageSource["forward"] = "forward";
+    MessageSource["publish"] = "publish";
+    return MessageSource;
+}({});
+/**Otel MetricsType Adapters
+ *
+ * Some dependencies we use export metrics directly in a Prometheus format
+ * This adapter is used to convert those metrics to a format that we can use with OpenTelemetry
+ *
+ * Affected services include:
+ * - chainsafe/gossipsub
+ * - libp2p
+ */ export class OtelGauge {
+    logger;
+    labelNames;
+    gauge;
+    currentValue;
+    labeledValues;
+    collectFns;
+    _collect;
+    get collect() {
+        return this._collect;
+    }
+    set collect(fn) {
+        this._collect = fn;
+    }
+    constructor(logger, meter, name, help, labelNames = []){
+        this.logger = logger;
+        this.labelNames = labelNames;
+        this.currentValue = 0;
+        this.labeledValues = new Map();
+        this.collectFns = [];
+        this._collect = ()=>{};
+        this.gauge = meter.createObservableGauge(name, {
+            description: help
+        });
+        // Only observe in the callback when collect() is called
+        this.gauge.addCallback(this.handleObservation.bind(this));
+    }
+    /**
+   * Add a collect callback
+   * @param collectFn - Callback function
+   */ addCollect(collectFn) {
+        this.collectFns.push(collectFn);
+    }
+    handleObservation(result) {
+        // Execute the main collect function if assigned
+        this._collect();
+        // Execute all the collect functions
+        for (const fn of this.collectFns){
+            fn(this);
+        }
+        // Report the current values
+        if (this.labelNames.length === 0) {
+            result.observe(this.currentValue);
+            return;
+        }
+        for (const [labelStr, value] of this.labeledValues.entries()){
+            const labels = this.parseLabelsSafely(labelStr);
+            if (labels) {
+                result.observe(value, labels);
+            }
+        }
+    }
+    inc(labelsOrValue, value) {
+        if (typeof labelsOrValue === 'number') {
+            this.currentValue += labelsOrValue;
+            return;
+        }
+        if (labelsOrValue) {
+            this.validateLabels(labelsOrValue);
+            const labelKey = JSON.stringify(labelsOrValue);
+            const currentValue = this.labeledValues.get(labelKey) ?? 0;
+            this.labeledValues.set(labelKey, currentValue + (value ?? 1));
+            return;
+        }
+        this.currentValue += value ?? 1;
+    }
+    set(labelsOrValue, value) {
+        if (typeof labelsOrValue === 'number') {
+            this.currentValue = labelsOrValue;
+            return;
+        }
+        this.validateLabels(labelsOrValue);
+        const labelKey = JSON.stringify(labelsOrValue);
+        this.labeledValues.set(labelKey, value);
+    }
+    /**
+   * Decrements the gauge value
+   * @param labels - Optional labels object
+   */ dec(labels) {
+        if (labels) {
+            this.validateLabels(labels);
+            const labelKey = JSON.stringify(labels);
+            const currentValue = this.labeledValues.get(labelKey) ?? 0;
+            this.labeledValues.set(labelKey, currentValue - 1);
+            return;
+        }
+        this.currentValue -= 1;
+    }
+    /**
+   * Resets the gauge to initial state
+   */ reset() {
+        this.currentValue = 0;
+        this.labeledValues.clear();
+    }
+    /**
+   * Validates that provided labels match the expected schema
+   * @param labels - Labels object to validate
+   * @throws Error if invalid labels are provided
+   */ validateLabels(labels) {
+        if (this.labelNames.length === 0) {
+            throw new Error('Gauge was initialized without labels support');
+        }
+        for (const key of Object.keys(labels)){
+            if (!this.labelNames.includes(key)) {
+                throw new Error(`Invalid label key: ${key}`);
+            }
+        }
+    }
+    /**
+   * Safely parses label string back to object
+   * @param labelStr - Stringified labels object
+   * @returns Labels object or null if parsing fails
+   */ parseLabelsSafely(labelStr) {
+        try {
+            return JSON.parse(labelStr);
+        } catch  {
+            this.logger.error(`Failed to parse label string: ${labelStr}`);
+            return null;
+        }
+    }
+}
+/**
+ * Noop implementation of a Historgram collec
+ */ class NoopOtelHistogram {
+    logger;
+    constructor(logger, _meter, _name, _help, _buckets = [], _labelNames = []){
+        this.logger = logger;
+    }
+    observe(_valueOrLabels, _value) {}
+    startTimer(_labels) {
+        return ()=>0;
+    }
+    reset() {
+        // OpenTelemetry histograms cannot be reset, but we implement the interface
+        this.logger.warn('OpenTelemetry histograms cannot be reset');
+    }
+}
+/**
+ * Noop implementation of an AvgMinMax collector
+ */ class NoopOtelAvgMinMax {
+    _logger;
+    constructor(_logger, _meter, _name, _help, _labelNames = []){
+        this._logger = _logger;
+    }
+    set(_valueOrLabels, _values) {}
+    reset() {}
+}
+/**
+ * Otel metrics Adapter
+ *
+ * Maps the PromClient based MetricsRegister from gossipsub and discv5 services to the Otel MetricsRegister
+ */ export class OtelMetricsAdapter extends Registry {
+    logger;
+    meter;
+    constructor(telemetryClient, logger = createLogger('telemetry:otel-metrics-adapter')){
+        super(), this.logger = logger;
+        this.meter = telemetryClient.getMeter('metrics-adapter');
+    }
+    gauge(configuration) {
+        return new OtelGauge(this.logger, this.meter, configuration.name, configuration.help, configuration.labelNames);
+    }
+    histogram(configuration) {
+        return new NoopOtelHistogram(this.logger, this.meter, configuration.name, configuration.help, configuration.buckets, configuration.labelNames);
+    }
+    avgMinMax(configuration) {
+        return new NoopOtelAvgMinMax(this.logger, this.meter, configuration.name, configuration.help, configuration.labelNames);
+    }
+}

package/dest/start.d.ts

@@ -0,0 +1,6 @@
+import type { TelemetryClientConfig } from './config.js';
+import type { TelemetryClient } from './telemetry.js';
+export * from './config.js';
+export declare function initTelemetryClient(config: TelemetryClientConfig): TelemetryClient;
+export declare function getTelemetryClient(): TelemetryClient;
+//# sourceMappingURL=start.d.ts.map

package/dest/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,cAAc,aAAa,CAAC;AAK5B,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAgBlF;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD"}

package/dest/start.js

@@ -0,0 +1,24 @@
+import { createLogger } from '@aztec/foundation/log';
+import { NoopTelemetryClient } from './noop.js';
+import { OpenTelemetryClient } from './otel.js';
+export * from './config.js';
+let initialised = false;
+let telemetry = new NoopTelemetryClient();
+export function initTelemetryClient(config) {
+    const log = createLogger('telemetry:client');
+    if (initialised) {
+        log.warn('Telemetry client has already been initialized once');
+        return telemetry;
+    }
+    if (config.metricsCollectorUrl) {
+        log.info(`Using OpenTelemetry client with custom collector`);
+        telemetry = OpenTelemetryClient.createAndStart(config, log);
+    } else {
+        log.info('Using NoopTelemetryClient');
+    }
+    initialised = true;
+    return telemetry;
+}
+export function getTelemetryClient() {
+    return telemetry;
+}

package/dest/telemetry.d.ts

@@ -0,0 +1,118 @@
+import { type AttributeValue, type BatchObservableCallback, type MetricOptions, type Observable, type BatchObservableResult as OtelBatchObservableResult, type Gauge as OtelGauge, type Histogram as OtelHistogram, type ObservableGauge as OtelObservableGauge, type ObservableResult as OtelObservableResult, type ObservableUpDownCounter as OtelObservableUpDownCounter, type UpDownCounter as OtelUpDownCounter, type Span, type Tracer } from '@opentelemetry/api';
+import type * as Attributes from './attributes.js';
+import type * as Metrics from './metrics.js';
+export { type Span, SpanStatusCode, ValueType } from '@opentelemetry/api';
+type ValuesOf<T> = T extends Record<string, infer U> ? U : never;
+/** Global registry of attributes */
+type AttributesType = Partial<Record<ValuesOf<typeof Attributes>, AttributeValue>>;
+export type { AttributesType };
+/** Global registry of metrics */
+type MetricsType = (typeof Metrics)[keyof typeof Metrics];
+export type { MetricsType };
+export type Gauge = OtelGauge<AttributesType>;
+export type Histogram = OtelHistogram<AttributesType>;
+export type UpDownCounter = OtelUpDownCounter<AttributesType>;
+export type ObservableGauge = OtelObservableGauge<AttributesType>;
+export type ObservableUpDownCounter = OtelObservableUpDownCounter<AttributesType>;
+export type ObservableResult = OtelObservableResult<AttributesType>;
+export type BatchObservableResult = OtelBatchObservableResult<AttributesType>;
+export type { Tracer };
+/**
+ * A meter that provides instruments for recording metrics.
+ */
+export interface Meter {
+    /**
+     * Creates a new gauge instrument. A gauge is a metric that represents a single numerical value that can arbitrarily go up and down.
+     * @param name - The name of the gauge
+     * @param options - The options for the gauge
+     */
+    createGauge(name: MetricsType, options?: MetricOptions): Gauge;
+    /**
+     * Creates a new gauge instrument. A gauge is a metric that represents a single numerical value that can arbitrarily go up and down.
+     * @param name - The name of the gauge
+     * @param options - The options for the gauge
+     */
+    createObservableGauge(name: MetricsType, options?: MetricOptions): ObservableGauge;
+    addBatchObservableCallback(callback: BatchObservableCallback<AttributesType>, observables: Observable<AttributesType>[]): void;
+    removeBatchObservableCallback(callback: BatchObservableCallback<AttributesType>, observables: Observable<AttributesType>[]): void;
+    /**
+     * Creates a new histogram instrument. A histogram is a metric that samples observations (usually things like request durations or response sizes) and counts them in configurable buckets.
+     * @param name - The name of the histogram
+     * @param options - The options for the histogram
+     */
+    createHistogram(name: MetricsType, options?: MetricOptions): Histogram;
+    /**
+     * Creates a new counter instrument. A counter can go up or down with a delta from the previous value.
+     * @param name - The name of the counter
+     * @param options - The options for the counter
+     */
+    createUpDownCounter(name: MetricsType, options?: MetricOptions): UpDownCounter;
+    /**
+     * Creates a new gauge instrument. A gauge is a metric that represents a single numerical value that can arbitrarily go up and down.
+     * @param name - The name of the gauge
+     * @param options - The options for the gauge
+     */
+    createObservableUpDownCounter(name: MetricsType, options?: MetricOptions): ObservableUpDownCounter;
+}
+/**
+ * A telemetry client that provides meters for recording metrics.
+ */
+export interface TelemetryClient {
+    /**
+     * Whether the client is enabled and reporting metrics.
+     **/
+    isEnabled(): boolean;
+    /**
+     * Creates a new meter
+     * @param name - The name of the meter.
+     */
+    getMeter(name: string): Meter;
+    /**
+     * Creates a new tracer
+     * @param name - The name of the tracer.
+     */
+    getTracer(name: string): Tracer;
+    /**
+     * Stops the telemetry client.
+     */
+    stop(): Promise<void>;
+    /**
+     * Flushes the telemetry client.
+     */
+    flush(): Promise<void>;
+}
+/** Objects that adhere to this interface can use @trackSpan */
+export interface Traceable {
+    tracer: Tracer;
+}
+type SpanDecorator<T extends Traceable, F extends (...args: any[]) => any> = (originalMethod: F, context: ClassMethodDecoratorContext<T>) => F;
+/**
+ * Starts a new span whenever the decorated method is called.
+ * @param spanName - The name of the span to create. Can be a string or a function that returns a string.
+ * @param attributes - Initial attributes to set on the span. If a function is provided, it will be called with the arguments of the method.
+ * @param extraAttributes - Extra attributes to set on the span after the method is called. Will be called with the return value of the method. Note: if the function throws then this will not be called.
+ * @returns A decorator that wraps the method in a span.
+ *
+ * @privateRemarks
+ * This code looks complex but it's not that difficult:
+ * - decorators are functions that _replace_ a method with a different implementation
+ * - normal decorators can't take function arguments, but if we write a function that returns a decorator, we can pass arguments to that function
+ *
+ * The trackSpan function takes a span's name and some attributes and builds a decorator that wraps a method in a span with the given name and props
+ * The decorator can currently only be applied to methods on classes that have a `tracer` property. The compiler will enforce this.
+ */
+export declare function trackSpan<T extends Traceable, F extends (...args: any[]) => any>(spanName: string | ((this: T, ...args: Parameters<F>) => string), attributes?: AttributesType | ((this: T, ...args: Parameters<F>) => Promise<AttributesType> | AttributesType), extraAttributes?: (this: T, returnValue: Awaited<ReturnType<F>>) => AttributesType): SpanDecorator<T, F>;
+/**
+ * Runs an event callback in a span. The span is started immediately and completes once the callback finishes running.
+ * The span will have two events added: 'callbackStart' and 'callbackEnd' to mark the start and end of the callback.
+ *
+ * @param tracer - The tracer instance to use
+ * @param spanName - The name of the span to create
+ * @param attributes - Initial attributes to set on the span
+ * @param callback - The callback to wrap in a span
+ *
+ * @returns - A new function that wraps the callback in a span
+ */
+export declare function wrapCallbackInSpan<F extends (...args: any[]) => any>(tracer: Tracer, spanName: string, attributes: AttributesType, callback: F): F;
+export declare function runInSpan<A extends any[], R>(tracer: Tracer | string, spanName: string, callback: (span: Span, ...args: A) => R): (...args: A) => R;
+//# sourceMappingURL=telemetry.d.ts.map

package/dest/telemetry.d.ts.map

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

package/dest/telemetry.js

@@ -0,0 +1,116 @@
+import { SpanStatusCode } from '@opentelemetry/api';
+import { isPromise } from 'node:util/types';
+import { getTelemetryClient } from './start.js';
+export { SpanStatusCode, ValueType } from '@opentelemetry/api';
+/**
+ * Starts a new span whenever the decorated method is called.
+ * @param spanName - The name of the span to create. Can be a string or a function that returns a string.
+ * @param attributes - Initial attributes to set on the span. If a function is provided, it will be called with the arguments of the method.
+ * @param extraAttributes - Extra attributes to set on the span after the method is called. Will be called with the return value of the method. Note: if the function throws then this will not be called.
+ * @returns A decorator that wraps the method in a span.
+ *
+ * @privateRemarks
+ * This code looks complex but it's not that difficult:
+ * - decorators are functions that _replace_ a method with a different implementation
+ * - normal decorators can't take function arguments, but if we write a function that returns a decorator, we can pass arguments to that function
+ *
+ * The trackSpan function takes a span's name and some attributes and builds a decorator that wraps a method in a span with the given name and props
+ * The decorator can currently only be applied to methods on classes that have a `tracer` property. The compiler will enforce this.
+ */ export function trackSpan(spanName, attributes, extraAttributes) {
+    // the return value of trackSpan is a decorator
+    return (originalMethod, _context)=>{
+        // the return value of the decorator replaces the original method
+        // in this wrapper method we start a span, call the original method, and then end the span
+        return async function replacementMethod(...args) {
+            const name = typeof spanName === 'function' ? spanName.call(this, ...args) : spanName;
+            const currentAttrs = typeof attributes === 'function' ? await attributes.call(this, ...args) : attributes;
+            // run originalMethod wrapped in an active span
+            // "active" means the span will be alive for the duration of the function execution
+            // and if any other spans are started during the execution of originalMethod, they will be children of this span
+            // behind the scenes this uses AsyncLocalStorage https://nodejs.org/dist/latest-v18.x/docs/api/async_context.html
+            return this.tracer.startActiveSpan(name, async (span)=>{
+                span.setAttributes(currentAttrs ?? {});
+                try {
+                    const res = await originalMethod.call(this, ...args);
+                    const extraAttrs = extraAttributes?.call(this, res);
+                    span.setAttributes(extraAttrs ?? {});
+                    return res;
+                } catch (err) {
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: String(err)
+                    });
+                    throw err;
+                } finally{
+                    span.end();
+                }
+            });
+        };
+    };
+}
+/**
+ * Runs an event callback in a span. The span is started immediately and completes once the callback finishes running.
+ * The span will have two events added: 'callbackStart' and 'callbackEnd' to mark the start and end of the callback.
+ *
+ * @param tracer - The tracer instance to use
+ * @param spanName - The name of the span to create
+ * @param attributes - Initial attributes to set on the span
+ * @param callback - The callback to wrap in a span
+ *
+ * @returns - A new function that wraps the callback in a span
+ */ export function wrapCallbackInSpan(tracer, spanName, attributes, callback) {
+    const span = tracer.startSpan(spanName, {
+        attributes
+    });
+    return async (...args)=>{
+        try {
+            span.addEvent('callbackStart');
+            const res = await callback(...args);
+            return res;
+        } catch (err) {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: String(err)
+            });
+            throw err;
+        } finally{
+            span.addEvent('callbackEnd');
+            span.end();
+        }
+    };
+}
+export function runInSpan(tracer, spanName, callback) {
+    return (...args)=>{
+        const actualTracer = typeof tracer === 'string' ? getTelemetryClient().getTracer(tracer) : tracer;
+        return actualTracer.startActiveSpan(spanName, (span)=>{
+            let deferSpanEnd = false;
+            try {
+                const res = callback(span, ...args);
+                if (isPromise(res)) {
+                    deferSpanEnd = true;
+                    return res.catch((err)=>{
+                        span.setStatus({
+                            code: SpanStatusCode.ERROR,
+                            message: String(err)
+                        });
+                        throw err;
+                    }).finally(()=>{
+                        span.end();
+                    });
+                } else {
+                    return res;
+                }
+            } catch (err) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: String(err)
+                });
+                throw err;
+            } finally{
+                if (!deferSpanEnd) {
+                    span.end();
+                }
+            }
+        });
+    };
+}

package/dest/vendor/attributes.d.ts

@@ -0,0 +1,5 @@
+export declare const ATTR_JSONRPC_METHOD = "rpc.method";
+export declare const ATTR_JSONRPC_REQUEST_ID = "rpc.jsonrpc.request_id";
+export declare const ATTR_JSONRPC_ERROR_CODE = "rpc.jsonrpc.error_code";
+export declare const ATTR_JSONRPC_ERROR_MSG = "rpc.jsonrpc.error_message";
+//# sourceMappingURL=attributes.d.ts.map

package/dest/vendor/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/vendor/attributes.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAChD,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,sBAAsB,8BAA8B,CAAC"}

package/dest/vendor/attributes.js

@@ -0,0 +1,5 @@
+// See https://opentelemetry.io/docs/specs/semconv/rpc/json-rpc/
+export const ATTR_JSONRPC_METHOD = 'rpc.method';
+export const ATTR_JSONRPC_REQUEST_ID = 'rpc.jsonrpc.request_id';
+export const ATTR_JSONRPC_ERROR_CODE = 'rpc.jsonrpc.error_code';
+export const ATTR_JSONRPC_ERROR_MSG = 'rpc.jsonrpc.error_message';

package/dest/vendor/otel-pino-stream.d.ts

@@ -0,0 +1,41 @@
+/// <reference types="node" resolution-mode="require"/>
+import { Writable } from 'stream';
+/**
+ * Return a function that knows how to convert the "time" field value on a
+ * Pino log record to an OTel LogRecord timestamp value.
+ *
+ * How to convert the serialized "time" on a Pino log record
+ * depends on the Logger's `Symbol(pino.time)` prop, configurable
+ * via https://getpino.io/#/docs/api?id=timestamp-boolean-function
+ *
+ * For example:
+ *    const logger = pino({timestamp: pino.stdTimeFunctions.isoTime})
+ * results in log record entries of the form:
+ *    ,"time":"2024-05-17T22:03:25.969Z"
+ * `otelTimestampFromTime` will be given the value of the "time" field:
+ *   "2024-05-17T22:03:25.969Z"
+ * which should be parsed to a number of milliseconds since the epoch.
+ */
+export declare function getTimeConverter(pinoLogger: any, pinoMod: any): ((time: number) => number) | ((time: string) => number);
+interface OTelPinoStreamOptions {
+    messageKey?: string;
+    levels: any;
+    otelTimestampFromTime?: (time: any) => number;
+}
+/**
+ * A Pino stream for sending records to the OpenTelemetry Logs API.
+ *
+ * - This stream emits an 'unknown' event on an unprocessable pino record.
+ *   The event arguments are: `logLine: string`, `err: string | Error`.
+ */
+export declare class OTelPinoStream extends Writable {
+    private _otelLogger;
+    private _messageKey;
+    private _levels;
+    private _otelTimestampFromTime;
+    constructor(options: OTelPinoStreamOptions);
+    _write(s: string, _encoding: string, callback: Function): void;
+}
+export default function (options: OTelPinoStreamOptions): OTelPinoStream;
+export {};
+//# sourceMappingURL=otel-pino-stream.d.ts.map

package/dest/vendor/otel-pino-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-pino-stream.d.ts","sourceRoot":"","sources":["../../src/vendor/otel-pino-stream.ts"],"names":[],"mappings":";AAoBA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AA8ElC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,WAI5C,MAAM,uBAIN,MAAM,aAOvB;AAED,UAAU,qBAAqB;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC;IACZ,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC;CAC/C;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,sBAAsB,CAAC;gBAEnB,OAAO,EAAE,qBAAqB;IAmBjC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAqGjE;AAMD,MAAM,CAAC,OAAO,WAAW,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAMvE"}