@aztec-labs/telemetry-client 6.0.0-nightly.20260829

package/dest/otel_propagation.js

@@ -0,0 +1,102 @@
+import { Timer } from '@aztec-labs/foundation/timer';
+import { ROOT_CONTEXT, SpanKind, SpanStatusCode, propagation } from '@opentelemetry/api';
+import { getJsonRpcServerMetrics, splitJsonRpcMethod } from './json_rpc_server_metrics.js';
+import { getTelemetryClient } from './start.js';
+import { ATTR_JSONRPC_ERROR_CODE, ATTR_JSONRPC_ERROR_MSG, ATTR_JSONRPC_METHOD, ATTR_JSONRPC_REQUEST_ID, ATTR_JSONRPC_SERVICE } from './vendor/attributes.js';
+export function getOtelJsonRpcPropagationMiddleware(scope = 'JsonRpcServer') {
+    return function otelJsonRpcPropagation(ctx, next) {
+        const tracer = getTelemetryClient().getTracer(scope);
+        const context = propagation.extract(ROOT_CONTEXT, ctx.request.headers);
+        return tracer.startActiveSpan(`JsonRpcServer`, {
+            kind: SpanKind.SERVER
+        }, context, async (span)=>{
+            if (ctx.id) {
+                span.setAttribute(ATTR_JSONRPC_REQUEST_ID, ctx.id);
+            }
+            try {
+                await next();
+                const requestBody = ctx.request.body;
+                if (requestBody && typeof requestBody === 'object' && !Array.isArray(requestBody) && 'method' in requestBody) {
+                    const fullMethod = requestBody.method;
+                    if (typeof fullMethod === 'string') {
+                        const [service, method] = splitJsonRpcMethod(fullMethod);
+                        span.updateName(`JsonRpcServer.${service ? `${service}.` : ''}${method}`);
+                        span.setAttribute(ATTR_JSONRPC_METHOD, method);
+                        if (service) {
+                            span.setAttribute(ATTR_JSONRPC_SERVICE, service);
+                        }
+                    }
+                } else if (Array.isArray(requestBody)) {
+                    span.updateName(`JsonRpcServer.batch`);
+                }
+                const err = ctx.body.error?.message;
+                const code = ctx.body.error?.code;
+                if (err) {
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: err
+                    });
+                    span.setAttribute(ATTR_JSONRPC_ERROR_CODE, code);
+                    span.setAttribute(ATTR_JSONRPC_ERROR_MSG, err);
+                } else {
+                    span.setStatus({
+                        code: SpanStatusCode.OK
+                    });
+                }
+            } catch (err) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: String(err)
+                });
+            } finally{
+                span.end();
+            }
+        });
+    };
+}
+export function getOtelJsonRpcDiagnosticsMiddleware(metricsProvider = getJsonRpcServerMetrics) {
+    return function otelJsonRpcDiagnostics(ctx, next) {
+        const [service, method] = splitJsonRpcMethod(ctx.method);
+        const scope = service ?? 'UnknownHandler';
+        const tracer = getTelemetryClient().getTracer(scope);
+        const attributes = {
+            ...service === undefined ? {} : {
+                [ATTR_JSONRPC_SERVICE]: service
+            },
+            [ATTR_JSONRPC_METHOD]: method
+        };
+        return tracer.startActiveSpan(`${scope}.${method}`, {
+            kind: SpanKind.INTERNAL,
+            attributes
+        }, async (span)=>{
+            const timer = new Timer();
+            let ok = false;
+            if (ctx.id !== null) {
+                span.setAttribute(ATTR_JSONRPC_REQUEST_ID, ctx.id);
+            }
+            try {
+                await next();
+                ok = true;
+                span.setStatus({
+                    code: SpanStatusCode.OK
+                });
+            } catch (err) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: err instanceof Error ? err.message : String(err)
+                });
+                if (typeof err === 'string' || err instanceof Error) {
+                    span.recordException(err);
+                }
+                throw err;
+            } finally{
+                const metrics = metricsProvider();
+                metrics.recordRequest(ctx.method, timer.ms(), ok);
+                if (ctx.requestValidationDurationMs !== undefined && ctx.requestValidationSucceeded !== undefined) {
+                    metrics.recordRequestValidation(ctx.method, ctx.requestValidationDurationMs, ctx.requestValidationSucceeded);
+                }
+                span.end();
+            }
+        });
+    };
+}

package/dest/otel_resource.d.ts

@@ -0,0 +1,3 @@
+import { type IResource } from '@opentelemetry/resources';
+export declare function getOtelResource(): IResource;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3RlbF9yZXNvdXJjZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL290ZWxfcmVzb3VyY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUVMLEtBQUssU0FBUyxFQU1mLE1BQU0sMEJBQTBCLENBQUM7QUFxQmxDLHdCQUFnQixlQUFlLElBQUksU0FBUyxDQWUzQyJ9

package/dest/otel_resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel_resource.d.ts","sourceRoot":"","sources":["../src/otel_resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,0BAA0B,CAAC;AAqBlC,wBAAgB,eAAe,IAAI,SAAS,CAe3C"}

package/dest/otel_resource.js

@@ -0,0 +1,53 @@
+import { Resource, detectResourcesSync, envDetectorSync, osDetectorSync, serviceInstanceIdDetectorSync } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { readFileSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { AZTEC_NODE_ROLE, AZTEC_REGISTRY_ADDRESS, AZTEC_ROLLUP_ADDRESS, AZTEC_ROLLUP_VERSION } from './attributes.js';
+/** Reads the Aztec client version from the release manifest. */ function getAztecVersion() {
+    try {
+        const releasePleasePath = resolve(dirname(fileURLToPath(import.meta.url)), '../../../.release-please-manifest.json');
+        return JSON.parse(readFileSync(releasePleasePath, 'utf-8'))['.'];
+    } catch  {
+        return undefined;
+    }
+}
+export function getOtelResource() {
+    const resource = detectResourcesSync({
+        detectors: [
+            aztecNetworkDetectorSync,
+            osDetectorSync,
+            envDetectorSync,
+            // this detector is disabled because:
+            // 1. our software runs in a docker container, a lot of the attributes detected would be identical across different machines (e.g. all run node v22, executing the same script, running PID 1, etc)
+            // 2. it catures process.argv which could contain sensitive values in plain text (e.g. validator private keys)
+            // processDetectorSync,
+            serviceInstanceIdDetectorSync
+        ]
+    });
+    return resource;
+}
+const aztecNetworkDetectorSync = {
+    detect () {
+        let role;
+        if (process.argv.includes('--sequencer')) {
+            role = 'sequencer';
+        } else if (process.argv.includes('--prover-node')) {
+            role = 'prover-node';
+        } else if (process.argv.includes('--node')) {
+            role = 'node';
+        } else if (process.argv.includes('--p2p-bootstrap')) {
+            role = 'bootnode';
+        }
+        const aztecAttributes = {
+            // this gets overwritten by OTEL_RESOURCE_ATTRIBUTES (if set)
+            [ATTR_SERVICE_NAME]: role ? `aztec-${role}` : undefined,
+            [ATTR_SERVICE_VERSION]: getAztecVersion(),
+            [AZTEC_NODE_ROLE]: role,
+            [AZTEC_ROLLUP_VERSION]: process.env.ROLLUP_VERSION ?? 'canonical',
+            [AZTEC_ROLLUP_ADDRESS]: process.env.ROLLUP_CONTRACT_ADDRESS,
+            [AZTEC_REGISTRY_ADDRESS]: process.env.REGISTRY_CONTRACT_ADDRESS
+        };
+        return new Resource(aztecAttributes);
+    }
+};

package/dest/prom_otel_adapter.d.ts

@@ -0,0 +1,176 @@
+import { type Logger, type LoggerBindings } from '@aztec-labs/foundation/log';
+import { Registry } from 'prom-client';
+import type { Meter, TelemetryClient } from './telemetry.js';
+/**
+ * Types matching the gossipsub and libp2p services
+ */
+type TopicStr = string;
+export type TopicLabel = string;
+export type TopicStrToLabel = Map<TopicStr, TopicLabel>;
+export declare enum MessageSource {
+    forward = "forward",
+    publish = "publish"
+}
+type NoLabels = Record<string, never>;
+type LabelsGeneric = Record<string, string | number>;
+type LabelKeys<Labels extends LabelsGeneric> = Extract<keyof Labels, string>;
+interface CollectFn<Labels extends LabelsGeneric> {
+    (metric: IGauge<Labels>): void;
+}
+interface IGauge<Labels extends LabelsGeneric = NoLabels> {
+    inc: NoLabels extends Labels ? (value?: number) => void : (labels: Labels, value?: number) => void;
+    set: NoLabels extends Labels ? (value: number) => void : (labels: Labels, value: number) => void;
+    collect?(): void;
+    addCollect(collectFn: CollectFn<Labels>): void;
+}
+interface IHistogram<Labels extends LabelsGeneric = NoLabels> {
+    startTimer(): () => void;
+    observe: NoLabels extends Labels ? (value: number) => void : (labels: Labels, value: number) => void;
+    reset(): void;
+}
+interface IAvgMinMax<Labels extends LabelsGeneric = NoLabels> {
+    set: NoLabels extends Labels ? (values: number[]) => void : (labels: Labels, values: number[]) => void;
+}
+export type GaugeConfig<Labels extends LabelsGeneric> = {
+    name: string;
+    help: string;
+} & (NoLabels extends Labels ? {
+    labelNames?: never;
+} : {
+    labelNames: [LabelKeys<Labels>, ...Array<LabelKeys<Labels>>];
+});
+export type HistogramConfig<Labels extends LabelsGeneric> = GaugeConfig<Labels> & {
+    buckets?: number[];
+};
+export type AvgMinMaxConfig<Labels extends LabelsGeneric> = GaugeConfig<Labels>;
+export interface MetricsRegister {
+    gauge<Labels extends LabelsGeneric = NoLabels>(config: GaugeConfig<Labels>): IGauge<Labels>;
+    histogram<Labels extends LabelsGeneric = NoLabels>(config: HistogramConfig<Labels>): IHistogram<Labels>;
+    avgMinMax<Labels extends LabelsGeneric = NoLabels>(config: AvgMinMaxConfig<Labels>): IAvgMinMax<Labels>;
+}
+/**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 declare class OtelGauge<Labels extends LabelsGeneric = NoLabels> implements IGauge<Labels> {
+    private logger;
+    private labelNames;
+    private gauge;
+    private currentValue;
+    private labeledValues;
+    private collectFns;
+    private _collect;
+    get collect(): () => void;
+    set collect(fn: () => void);
+    constructor(logger: Logger, meter: Meter, name: string, help: string, labelNames?: Array<keyof Labels>);
+    /**
+     * Add a collect callback
+     * @param collectFn - Callback function
+     */
+    addCollect(collectFn: CollectFn<Labels>): void;
+    handleObservation(result: any): void;
+    /**
+     * Increments the gauge value
+     * @param labelsOrValue - Labels object or numeric value
+     * @param value - Value to increment by (defaults to 1)
+     */
+    inc(value?: number): void;
+    inc(labels: Labels, value?: number): void;
+    /**
+     * Sets the gauge value
+     * @param labelsOrValue - Labels object or numeric value
+     * @param value - Value to set
+     */
+    set(value: number): void;
+    set(labels: Labels, value: number): void;
+    /**
+     * Decrements the gauge value
+     * @param labels - Optional labels object
+     */
+    dec(labels?: Labels): void;
+    /**
+     * Resets the gauge to initial state
+     */
+    reset(): void;
+}
+/**
+ * Implementation of a Histogram collector
+ */
+export declare class OtelHistogram<Labels extends LabelsGeneric = NoLabels> implements IHistogram<Labels> {
+    private logger;
+    private labelNames;
+    private histogram;
+    constructor(logger: Logger, meter: Meter, name: string, help: string, buckets?: number[], labelNames?: Array<keyof Labels>);
+    /**
+     * Starts a timer and returns a function that when called will record the time elapsed
+     * @param labels - Optional labels for the observation
+     */
+    startTimer(labels?: Labels): () => void;
+    /**
+     * Observes a value
+     * @param value - Value to observe
+     */
+    observe(value: number): void;
+    /**
+     * Observes a value with labels
+     * @param labels - Labels object
+     * @param value - Value to observe
+     */
+    observe(labels: Labels, value: number): void;
+    reset(): void;
+}
+/**
+ * Implementation of an AvgMinMax collector
+ */
+export declare class OtelAvgMinMax<Labels extends LabelsGeneric = NoLabels> implements IAvgMinMax<Labels> {
+    private logger;
+    private labelNames;
+    private gauges;
+    private currentValues;
+    private labeledValues;
+    constructor(logger: Logger, meter: Meter, name: string, help: string, labelNames?: Array<keyof Labels>);
+    /**
+     * Sets the values for calculating avg, min, max
+     * @param values - Array of values
+     */
+    set(values: number[]): void;
+    /**
+     * Sets the values for calculating avg, min, max with labels
+     * @param labels - Labels object
+     * @param values - Array of values
+     */
+    set(labels: Labels, values: number[]): void;
+    /**
+     * Resets all stored values
+     */
+    reset(): void;
+    /**
+     * General function to observe an aggregation
+     * @param result - Observer result
+     * @param aggregateFn - Function that calculates the aggregation
+     */
+    private observeAggregation;
+    private observeAvg;
+    private observeMin;
+    private observeMax;
+}
+/**
+ * Otel metrics Adapter
+ *
+ * Maps the PromClient based MetricsRegister from gossipsub and discv5 services to the Otel MetricsRegister
+ */
+export declare class OtelMetricsAdapter extends Registry implements MetricsRegister {
+    private readonly meter;
+    private logger;
+    constructor(telemetryClient: TelemetryClient, bindings?: LoggerBindings);
+    gauge<Labels extends LabelsGeneric = NoLabels>(configuration: GaugeConfig<Labels>): IGauge<Labels>;
+    histogram<Labels extends LabelsGeneric = NoLabels>(configuration: HistogramConfig<Labels>): IHistogram<Labels>;
+    avgMinMax<Labels extends LabelsGeneric = NoLabels>(configuration: AvgMinMaxConfig<Labels>): IAvgMinMax<Labels>;
+}
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvbV9vdGVsX2FkYXB0ZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9wcm9tX290ZWxfYWRhcHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQUUsS0FBSyxjQUFjLEVBQWdCLE1BQU0sNEJBQTRCLENBQUM7QUFFNUYsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUd2QyxPQUFPLEtBQUssRUFBYSxLQUFLLEVBQW1CLGVBQWUsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBRXpGOztHQUVHO0FBQ0gsS0FBSyxRQUFRLEdBQUcsTUFBTSxDQUFDO0FBQ3ZCLE1BQU0sTUFBTSxVQUFVLEdBQUcsTUFBTSxDQUFDO0FBQ2hDLE1BQU0sTUFBTSxlQUFlLEdBQUcsR0FBRyxDQUFDLFFBQVEsRUFBRSxVQUFVLENBQUMsQ0FBQztBQUV4RCxvQkFBWSxhQUFhO0lBQ3ZCLE9BQU8sWUFBWTtJQUNuQixPQUFPLFlBQVk7Q0FDcEI7QUFFRCxLQUFLLFFBQVEsR0FBRyxNQUFNLENBQUMsTUFBTSxFQUFFLEtBQUssQ0FBQyxDQUFDO0FBQ3RDLEtBQUssYUFBYSxHQUFHLE1BQU0sQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FBQyxDQUFDO0FBQ3JELEtBQUssU0FBUyxDQUFDLE1BQU0sU0FBUyxhQUFhLElBQUksT0FBTyxDQUFDLE1BQU0sTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0FBQzdFLFVBQVUsU0FBUyxDQUFDLE1BQU0sU0FBUyxhQUFhO0lBQzlDLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsR0FBRyxJQUFJLENBQUM7Q0FDaEM7QUFFRCxVQUFVLE1BQU0sQ0FBQyxNQUFNLFNBQVMsYUFBYSxHQUFHLFFBQVE7SUFDdEQsR0FBRyxFQUFFLFFBQVEsU0FBUyxNQUFNLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxNQUFNLEtBQUssSUFBSSxH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

package/dest/prom_otel_adapter.d.ts.map

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

package/dest/prom_otel_adapter.js

@@ -0,0 +1,292 @@
+import { createLogger } from '@aztec-labs/foundation/log';
+import { Timer } from '@aztec-labs/foundation/timer';
+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 = ()=>{};
+        const metricDef = {
+            name,
+            description: help
+        };
+        this.gauge = meter.createObservableGauge(metricDef);
+        // 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 = parseLabelsSafely(labelStr, this.logger);
+            if (labels) {
+                result.observe(value, labels);
+            }
+        }
+    }
+    inc(labelsOrValue, value) {
+        if (typeof labelsOrValue === 'number') {
+            this.currentValue += labelsOrValue;
+            return;
+        }
+        if (labelsOrValue) {
+            validateLabels(labelsOrValue, this.labelNames, 'Gauge');
+            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;
+        }
+        validateLabels(labelsOrValue, this.labelNames, 'Gauge');
+        const labelKey = JSON.stringify(labelsOrValue);
+        this.labeledValues.set(labelKey, value);
+    }
+    /**
+   * Decrements the gauge value
+   * @param labels - Optional labels object
+   */ dec(labels) {
+        if (labels) {
+            validateLabels(labels, this.labelNames, 'Gauge');
+            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();
+    }
+}
+/**
+ * Implementation of a Histogram collector
+ */ export class OtelHistogram {
+    logger;
+    labelNames;
+    histogram;
+    constructor(logger, meter, name, help, buckets = [], labelNames = []){
+        this.logger = logger;
+        this.labelNames = labelNames;
+        const metricDef = {
+            name,
+            description: help
+        };
+        this.histogram = meter.createHistogram(metricDef, {
+            advice: buckets.length ? {
+                explicitBucketBoundaries: buckets
+            } : undefined
+        });
+    }
+    /**
+   * Starts a timer and returns a function that when called will record the time elapsed
+   * @param labels - Optional labels for the observation
+   */ startTimer(labels) {
+        if (labels) {
+            validateLabels(labels, this.labelNames, 'Histogram');
+        }
+        const timer = new Timer();
+        return ()=>{
+            // Use timer.s() here to get the duration in seconds since this is only currently used by gossipsub_heartbeat_duration_seconds
+            const duration = timer.s();
+            if (labels) {
+                this.observe(labels, duration);
+            } else {
+                this.observe(duration);
+            }
+        };
+    }
+    observe(labelsOrValue, value) {
+        if (typeof labelsOrValue === 'number') {
+            this.histogram.record(labelsOrValue);
+        } else {
+            validateLabels(labelsOrValue, this.labelNames, 'Histogram');
+            this.histogram.record(value, labelsOrValue);
+        }
+    }
+    reset() {
+        // OpenTelemetry histograms cannot be reset, but we implement the interface
+        this.logger.silent('OpenTelemetry histograms cannot be fully reset');
+    }
+}
+/**
+ * Implementation of an AvgMinMax collector
+ */ export class OtelAvgMinMax {
+    logger;
+    labelNames;
+    gauges;
+    currentValues;
+    labeledValues;
+    constructor(logger, meter, name, help, labelNames = []){
+        this.logger = logger;
+        this.labelNames = labelNames;
+        this.currentValues = [];
+        this.labeledValues = new Map();
+        // Create three separate gauges for avg, min, and max
+        this.gauges = {
+            avg: meter.createObservableGauge({
+                name: `${name}_avg`,
+                description: `${help} (average)`
+            }),
+            min: meter.createObservableGauge({
+                name: `${name}_min`,
+                description: `${help} (minimum)`
+            }),
+            max: meter.createObservableGauge({
+                name: `${name}_max`,
+                description: `${help} (maximum)`
+            })
+        };
+        // Register callbacks for each gauge
+        this.gauges.avg.addCallback(this.observeAvg.bind(this));
+        this.gauges.min.addCallback(this.observeMin.bind(this));
+        this.gauges.max.addCallback(this.observeMax.bind(this));
+    }
+    set(labelsOrValues, values) {
+        if (Array.isArray(labelsOrValues)) {
+            this.currentValues = labelsOrValues;
+            return;
+        } else {
+            validateLabels(labelsOrValues, this.labelNames, 'AvgMinMax');
+            const labelKey = JSON.stringify(labelsOrValues);
+            this.labeledValues.set(labelKey, values || []);
+        }
+    }
+    /**
+   * Resets all stored values
+   */ reset() {
+        this.currentValues = [];
+        this.labeledValues.clear();
+    }
+    /**
+   * General function to observe an aggregation
+   * @param result - Observer result
+   * @param aggregateFn - Function that calculates the aggregation
+   */ observeAggregation(result, aggregateFn) {
+        // Observe unlabeled values
+        if (this.currentValues.length > 0) {
+            result.observe(aggregateFn(this.currentValues));
+        }
+        // Observe labeled values
+        for (const [labelStr, values] of this.labeledValues.entries()){
+            if (values.length > 0) {
+                const labels = parseLabelsSafely(labelStr, this.logger);
+                if (labels) {
+                    result.observe(aggregateFn(values), labels);
+                }
+            }
+        }
+    }
+    observeAvg(result) {
+        this.observeAggregation(result, (arr)=>arr.reduce((sum, val)=>sum + val, 0) / arr.length);
+    }
+    observeMin(result) {
+        this.observeAggregation(result, (arr)=>Math.min.apply(null, arr));
+    }
+    observeMax(result) {
+        this.observeAggregation(result, (arr)=>Math.max.apply(null, arr));
+    }
+}
+/**
+ * Validates that provided labels match the expected schema
+ * @param labels - Labels object to validate
+ * @param labelNames - Array of allowed label names
+ * @param metricType - Type of metric for error message ('Gauge', 'Histogram', 'AvgMinMax')
+ * @throws Error if invalid labels are provided
+ */ function validateLabels(labels, labelNames, metricType) {
+    if (labelNames.length === 0) {
+        throw new Error(`${metricType} was initialized without labels support`);
+    }
+    for (const key of Object.keys(labels)){
+        if (!labelNames.includes(key)) {
+            throw new Error(`Invalid label key: ${key}`);
+        }
+    }
+}
+/**
+ * Safely parses label string back to object
+ * @param labelStr - Stringified labels object
+ * @param logger - Logger instance for error reporting
+ * @returns Labels object or null if parsing fails
+ */ function parseLabelsSafely(labelStr, logger) {
+    try {
+        return JSON.parse(labelStr);
+    } catch  {
+        logger.error(`Failed to parse label string: ${labelStr}`);
+        return null;
+    }
+}
+/**
+ * Otel metrics Adapter
+ *
+ * Maps the PromClient based MetricsRegister from gossipsub and discv5 services to the Otel MetricsRegister
+ */ export class OtelMetricsAdapter extends Registry {
+    meter;
+    logger;
+    constructor(telemetryClient, bindings){
+        super();
+        this.logger = createLogger('telemetry:otel-metrics-adapter', bindings);
+        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 OtelHistogram(this.logger, this.meter, configuration.name, configuration.help, configuration.buckets, configuration.labelNames);
+    }
+    avgMinMax(configuration) {
+        return new OtelAvgMinMax(this.logger, this.meter, configuration.name, configuration.help, configuration.labelNames);
+    }
+}

package/dest/start.d.ts

@@ -0,0 +1,7 @@
+import { type LoggerBindings } from '@aztec-labs/foundation/log';
+import type { TelemetryClientConfig } from './config.js';
+import type { TelemetryClient } from './telemetry.js';
+export * from './config.js';
+export declare function initTelemetryClient(config: TelemetryClientConfig, bindings?: LoggerBindings): Promise<TelemetryClient>;
+export declare function getTelemetryClient(): TelemetryClient;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhcnQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9zdGFydC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQWdCLE1BQU0sNEJBQTRCLENBQUM7QUFFL0UsT0FBTyxLQUFLLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFekQsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFdEQsY0FBYyxhQUFhLENBQUM7QUFLNUIsd0JBQXNCLG1CQUFtQixDQUN2QyxNQUFNLEVBQUUscUJBQXFCLEVBQzdCLFFBQVEsQ0FBQyxFQUFFLGNBQWMsR0FDeEIsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQXVCMUI7QUFFRCx3QkFBZ0Isa0JBQWtCLElBQUksZUFBZSxDQUVwRCJ9

package/dest/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,4BAA4B,CAAC;AAE/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,cAAc,aAAa,CAAC;AAK5B,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD"}