@microsoft/opentelemetry 1.0.2 → 1.2.0

package/dist/esm/sdkstats/metrics.js

@@ -8,11 +8,12 @@
  * caller-supplied `MeterProvider`.
  *
  * Mirrors `src/microsoft/opentelemetry/_sdkstats/_metrics.py` from the
- * Python distro.
+ * Python implementation.
  */
 import os from "node:os";
 import { MICROSOFT_OPENTELEMETRY_VERSION } from "../types.js";
 import { getSdkStatsFeatureFlags, getSdkStatsInstrumentationFlags } from "./state.js";
+import { REQUEST_SUCCESS_NAME, REQUEST_FAILURE_NAME, REQUEST_DURATION_NAME, RETRY_COUNT_NAME, THROTTLE_COUNT_NAME, EXCEPTION_COUNT_NAME, drain, } from "./networkStats.js";
 /**
  * Feature SDKStats `type` dimension values, per the Application Insights
  * SDKStats specification.
@@ -23,29 +24,116 @@ export const FEATURE_TYPE_FEATURE = 0;
 export const FEATURE_TYPE_INSTRUMENTATION = 1;
 const FEATURE_METRIC_NAME = "Feature";
 const INSTRUMENTATION_METRIC_NAME = "Feature.instrumentations";
-const STATSBEAT_LANGUAGE = "node";
+const SDKSTATS_LANGUAGE = "node";
+const NETWORK_GAUGE_SPECS = [
+    {
+        metric: REQUEST_SUCCESS_NAME,
+        unit: "count",
+        description: "Number of successful HTTP exports per endpoint",
+        keyAttributes: ["endpoint", "host"],
+    },
+    {
+        metric: REQUEST_FAILURE_NAME,
+        unit: "count",
+        description: "Number of failed HTTP exports per endpoint, broken down by status code",
+        keyAttributes: ["endpoint", "host", "statusCode"],
+    },
+    {
+        metric: REQUEST_DURATION_NAME,
+        unit: "ms",
+        description: "Average HTTP export request duration per endpoint",
+        keyAttributes: ["endpoint", "host"],
+    },
+    {
+        metric: RETRY_COUNT_NAME,
+        unit: "count",
+        description: "Number of HTTP exports that returned a retryable status code",
+        keyAttributes: ["endpoint", "host", "statusCode"],
+    },
+    {
+        metric: THROTTLE_COUNT_NAME,
+        unit: "count",
+        description: "Number of HTTP exports that returned a throttling status code (402/439)",
+        keyAttributes: ["endpoint", "host", "statusCode"],
+    },
+    {
+        metric: EXCEPTION_COUNT_NAME,
+        unit: "count",
+        description: "Number of HTTP exports that raised an exception (no HTTP response)",
+        keyAttributes: ["endpoint", "host", "exceptionType"],
+    },
+];
 /**
  * Registers observable gauges that emit feature/instrumentation data
- * derived from the global SDKStats state.
+ * derived from the global SDKStats state, plus per-export network
+ * SDKStats counters drained from {@link ./networkStats.js}.
  */
 export class SdkStatsMetrics {
     commonAttributes;
-    constructor(meterProvider, distroVersion) {
-        const meter = meterProvider.getMeter("microsoft.opentelemetry.sdkstats");
+    constructor(providerOrOptions, legacyOptions) {
+        let longMeterProvider;
+        let shortMeterProvider;
+        let distroVersion;
+        let networkOnly;
+        let cikey;
+        if ("shortMeterProvider" in providerOrOptions) {
+            // New options-object overload
+            longMeterProvider = providerOrOptions.longMeterProvider;
+            shortMeterProvider = providerOrOptions.shortMeterProvider;
+            distroVersion = providerOrOptions.distroVersion;
+            networkOnly = providerOrOptions.networkOnly ?? false;
+            cikey = providerOrOptions.cikey;
+        }
+        else {
+            // Legacy single-provider overload (used by tests)
+            longMeterProvider = providerOrOptions;
+            shortMeterProvider = providerOrOptions;
+            distroVersion = legacyOptions?.distroVersion;
+            networkOnly = legacyOptions?.networkOnly ?? false;
+            cikey = legacyOptions?.cikey;
+        }
+        // Per spec/sdkstats.md the required customDimensions on every
+        // SDKStats observation are: rp, attach, runtimeVersion, os,
+        // language, version, cikey (plus endpoint/host on network gauges and
+        // statusCode/exceptionType where applicable). `cikey` falls back to
+        // "N/A" when unset.
         this.commonAttributes = {
+            rp: "unknown",
+            attach: "Manual",
             runtimeVersion: process.version,
             os: os.type(),
-            language: STATSBEAT_LANGUAGE,
+            language: SDKSTATS_LANGUAGE,
             version: distroVersion || MICROSOFT_OPENTELEMETRY_VERSION,
+            cikey: cikey || "N/A",
         };
-        const featureGauge = meter.createObservableGauge(FEATURE_METRIC_NAME, {
-            description: "SDKStats metric tracking enabled features",
-        });
-        featureGauge.addCallback(this.observeFeatures);
-        const instrumentationGauge = meter.createObservableGauge(INSTRUMENTATION_METRIC_NAME, {
-            description: "SDKStats metric tracking enabled instrumentations",
-        });
-        instrumentationGauge.addCallback(this.observeInstrumentations);
+        // Feature / instrumentation bitmask gauges are skipped when running
+        // alongside the Azure Monitor exporter's own SDKStats — that pipeline
+        // already emits them (with our feature bits bridged in via
+        // `_bridge_sdkstats_to_azure_monitor`) and would collide with these.
+        // These gauges are registered on the long-interval MeterProvider.
+        if (!networkOnly && longMeterProvider) {
+            const longMeter = longMeterProvider.getMeter("microsoft.opentelemetry.sdkstats");
+            const featureGauge = longMeter.createObservableGauge(FEATURE_METRIC_NAME, {
+                description: "SDKStats metric tracking enabled features",
+            });
+            featureGauge.addCallback(this.observeFeatures);
+            const instrumentationGauge = longMeter.createObservableGauge(INSTRUMENTATION_METRIC_NAME, {
+                description: "SDKStats metric tracking enabled instrumentations",
+            });
+            instrumentationGauge.addCallback(this.observeInstrumentations);
+        }
+        // Network SDKStats gauges — always registered on the short-interval
+        // MeterProvider. Each callback drains the counts accumulated by
+        // exporters between observations and emits one Observation per
+        // (endpoint, host) tuple.
+        const shortMeter = shortMeterProvider.getMeter("microsoft.opentelemetry.sdkstats.network");
+        for (const spec of NETWORK_GAUGE_SPECS) {
+            const gauge = shortMeter.createObservableGauge(spec.metric, {
+                unit: spec.unit,
+                description: spec.description,
+            });
+            gauge.addCallback(this.makeNetworkCallback(spec));
+        }
     }
     observeFeatures = (result) => {
         const featureBits = getSdkStatsFeatureFlags();
@@ -73,5 +161,20 @@ export class SdkStatsMetrics {
             type: FEATURE_TYPE_INSTRUMENTATION,
         });
     };
+    makeNetworkCallback(spec) {
+        return (result) => {
+            for (const [key, value] of drain(spec.metric)) {
+                const attrs = { ...this.commonAttributes };
+                for (let i = 0; i < spec.keyAttributes.length; i++) {
+                    const name = spec.keyAttributes[i];
+                    const part = key[i];
+                    if (part !== undefined) {
+                        attrs[name] = part;
+                    }
+                }
+                result.observe(value, attrs);
+            }
+        };
+    }
 }
 //# sourceMappingURL=metrics.js.map

package/dist/esm/sdkstats/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/sdkstats/metrics.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,MAAM,mBAAmB,GAAG,SAAS,CAAC;AACtC,MAAM,2BAA2B,GAAG,0BAA0B,CAAC;AAC/D,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,gBAAgB,CAAyB;IAE1D,YAAY,aAA4B,EAAE,aAAsB;QAC9D,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC;QAEzE,IAAI,CAAC,gBAAgB,GAAG;YACtB,cAAc,EAAE,OAAO,CAAC,OAAO;YAC/B,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE;YACb,QAAQ,EAAE,kBAAkB;YAC5B,OAAO,EAAE,aAAa,IAAI,+BAA+B;SAC1D,CAAC;QAEF,MAAM,YAAY,GAAG,KAAK,CAAC,qBAAqB,CAAC,mBAAmB,EAAE;YACpE,WAAW,EAAE,2CAA2C;SACzD,CAAC,CAAC;QACH,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAE/C,MAAM,oBAAoB,GAAG,KAAK,CAAC,qBAAqB,CAAC,2BAA2B,EAAE;YACpF,WAAW,EAAE,mDAAmD;SACjE,CAAC,CAAC;QACH,oBAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACjE,CAAC;IAEO,eAAe,GAAG,CAAC,MAAwB,EAAQ,EAAE;QAC3D,MAAM,WAAW,GAAG,uBAAuB,EAAE,CAAC;QAC9C,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,oEAAoE;YACpE,OAAO;QACT,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE;YAChB,GAAG,IAAI,CAAC,gBAAgB;YACxB,oEAAoE;YACpE,kEAAkE;YAClE,qBAAqB;YACrB,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC;YAC5B,IAAI,EAAE,oBAAoB;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC;IAEM,uBAAuB,GAAG,CAAC,MAAwB,EAAQ,EAAE;QACnE,MAAM,SAAS,GAAG,+BAA+B,EAAE,CAAC;QACpD,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE;YAChB,GAAG,IAAI,CAAC,gBAAgB;YACxB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;YAC1B,IAAI,EAAE,4BAA4B;SACnC,CAAC,CAAC;IACL,CAAC,CAAC;CACH"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/sdkstats/metrics.ts"],"names":[],"mappings":"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"}

package/dist/esm/sdkstats/networkStats.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Network SDKStats accumulator for SDK self-telemetry.
+ *
+ * Per-export counters and timings for telemetry exporters. Exporters call
+ * the {@link recordSuccess} / {@link recordFailure} / {@link recordRetry} /
+ * {@link recordThrottle} / {@link recordException} / {@link recordDuration}
+ * functions after each transmit; the {@link SdkStatsMetrics}
+ * observable-gauge callbacks drain the accumulated counts on each export
+ * interval.
+ *
+ * Mirrors `src/microsoft/opentelemetry/_sdkstats/_utils.py` from the Python
+ * implementation.
+ */
+import { REQUEST_SUCCESS_NAME, REQUEST_FAILURE_NAME, REQUEST_DURATION_NAME, RETRY_COUNT_NAME, THROTTLE_COUNT_NAME, EXCEPTION_COUNT_NAME, NETWORK_METRIC_NAMES, type NetworkMetricName } from "./constants.js";
+export { REQUEST_SUCCESS_NAME, REQUEST_FAILURE_NAME, REQUEST_DURATION_NAME, RETRY_COUNT_NAME, THROTTLE_COUNT_NAME, EXCEPTION_COUNT_NAME, NETWORK_METRIC_NAMES, };
+export type { NetworkMetricName };
+/**
+ * Composite key for an aggregated network SDKStats counter.
+ *
+ * Per the Application Insights SDKStats spec the per-key dimensions are
+ * `endpoint` (category, e.g. "a365") and `host` (stamp-specific
+ * region or hostname), optionally followed by a third dimension —
+ * `statusCode` (failure/retry/throttle) or `exceptionType` (exception).
+ *
+ * @internal
+ */
+export type NetworkKey = readonly string[];
+export declare function recordSuccess(endpoint: string, host: string): void;
+export declare function recordFailure(endpoint: string, host: string, statusCode: number | string): void;
+export declare function recordRetry(endpoint: string, host: string, statusCode: number | string): void;
+export declare function recordThrottle(endpoint: string, host: string, statusCode: number | string): void;
+export declare function recordException(endpoint: string, host: string, exceptionType: string): void;
+export declare function recordDuration(endpoint: string, host: string, durationMs: number): void;
+/**
+ * Classification of an HTTP status code per the Application Insights
+ * SDKStats Network specification.
+ *
+ * - `success`: 200 (and 206 if all envelopes were accepted — handled by
+ *   the caller, this helper only returns the bucket for a single response
+ *   code).
+ * - `retry`: 401, 403, 408, 429, 500, 502, 503, 504.
+ * - `throttle`: 402, 439.
+ * - `failure`: everything else (excluding redirects 307/308 which are
+ *   followed transparently and never reported).
+ */
+export type StatusCodeKind = "success" | "retry" | "throttle" | "failure" | "ignored";
+export declare function classifyStatusCode(status: number): StatusCodeKind;
+/**
+ * Compute the stamp-specific short host for the SDKStats `host` dimension.
+ *
+ * Mirrors `getShortHost` in the AzMon exporter's `NetworkStatsbeatMetrics` class
+ * but additionally strips any trailing port (`:4318`) so localhost-style
+ * URLs report a clean `localhost` instead of `localhost:4318`. Examples:
+ *   `https://westus2-1.in.applicationinsights.azure.com` → `westus2`
+ *   `http://localhost:4318/v1/traces`                    → `localhost`
+ *   `https://collector.example.com:8080`                  → `collector`
+ *   `https://my-otlp-collector.example.com`               → `my-otlp-collector`
+ * For non-URL inputs, returns the hostname or the raw input on failure.
+ *
+ * @internal
+ */
+export declare function shortHost(input: string): string;
+/**
+ * Atomically return and reset the counts for `metric`.
+ *
+ * Used by the observable-gauge callbacks so each observation reports only
+ * the delta accumulated during the export interval.
+ *
+ * For {@link REQUEST_DURATION_NAME} the reported value is the average of
+ * all durations recorded since the previous drain, per the spec
+ * ("Request_Duration ... avg request duration during the scheduled
+ * interval").
+ */
+export declare function drain(metric: NetworkMetricName): Map<NetworkKey, number>;
+/**
+ * @internal Test-only: clear all network SDKStats counters.
+ */
+export declare function _resetAllForTest(): void;
+//# sourceMappingURL=networkStats.d.ts.map

package/dist/esm/sdkstats/networkStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStats.d.ts","sourceRoot":"","sources":["../../../src/sdkstats/networkStats.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAOH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EAIpB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,CAAC;AACF,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,MAAM,EAAE,CAAC;AA0C3C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE/F;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7F;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhG;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAE3F;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAUvF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAMjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAgBxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC"}

package/dist/esm/sdkstats/networkStats.js

@@ -0,0 +1,172 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Network SDKStats accumulator for SDK self-telemetry.
+ *
+ * Per-export counters and timings for telemetry exporters. Exporters call
+ * the {@link recordSuccess} / {@link recordFailure} / {@link recordRetry} /
+ * {@link recordThrottle} / {@link recordException} / {@link recordDuration}
+ * functions after each transmit; the {@link SdkStatsMetrics}
+ * observable-gauge callbacks drain the accumulated counts on each export
+ * interval.
+ *
+ * Mirrors `src/microsoft/opentelemetry/_sdkstats/_utils.py` from the Python
+ * implementation.
+ */
+// Wire-format metric names and the set of HTTP status-code buckets used
+// below live in `./constants.js` so the A365 exporter wrapper can
+// share a single source of truth. Re-exported here for backwards
+// compatibility with existing imports of these symbols from
+// `./networkStats.js`.
+import { REQUEST_SUCCESS_NAME, REQUEST_FAILURE_NAME, REQUEST_DURATION_NAME, RETRY_COUNT_NAME, THROTTLE_COUNT_NAME, EXCEPTION_COUNT_NAME, NETWORK_METRIC_NAMES, RETRY_STATUSES, THROTTLE_STATUSES, IGNORED_STATUSES, } from "./constants.js";
+export { REQUEST_SUCCESS_NAME, REQUEST_FAILURE_NAME, REQUEST_DURATION_NAME, RETRY_COUNT_NAME, THROTTLE_COUNT_NAME, EXCEPTION_COUNT_NAME, NETWORK_METRIC_NAMES, };
+const REQUESTS_MAP = {
+    [REQUEST_SUCCESS_NAME]: new Map(),
+    [REQUEST_FAILURE_NAME]: new Map(),
+    [RETRY_COUNT_NAME]: new Map(),
+    [THROTTLE_COUNT_NAME]: new Map(),
+    [EXCEPTION_COUNT_NAME]: new Map(),
+};
+const DURATION_MAP = new Map();
+// `Map` keys are compared by identity for arrays/objects, so we serialize
+// the key tuple to a string. The `\u0000` separator can't appear in a URL
+// hostname, HTTP status code, or exception-type string, so this is
+// unambiguous.
+const KEY_SEPARATOR = "\u0000";
+function encodeKey(key) {
+    return key.join(KEY_SEPARATOR);
+}
+function decodeKey(encoded) {
+    return encoded.split(KEY_SEPARATOR);
+}
+function bump(metric, key, value = 1) {
+    const bucket = REQUESTS_MAP[metric];
+    const encoded = encodeKey(key);
+    bucket.set(encoded, (bucket.get(encoded) ?? 0) + value);
+}
+export function recordSuccess(endpoint, host) {
+    bump(REQUEST_SUCCESS_NAME, [endpoint, host]);
+}
+export function recordFailure(endpoint, host, statusCode) {
+    bump(REQUEST_FAILURE_NAME, [endpoint, host, String(statusCode)]);
+}
+export function recordRetry(endpoint, host, statusCode) {
+    bump(RETRY_COUNT_NAME, [endpoint, host, String(statusCode)]);
+}
+export function recordThrottle(endpoint, host, statusCode) {
+    bump(THROTTLE_COUNT_NAME, [endpoint, host, String(statusCode)]);
+}
+export function recordException(endpoint, host, exceptionType) {
+    bump(EXCEPTION_COUNT_NAME, [endpoint, host, exceptionType]);
+}
+export function recordDuration(endpoint, host, durationMs) {
+    if (!Number.isFinite(durationMs) || durationMs < 0)
+        return;
+    const encoded = encodeKey([endpoint, host]);
+    const existing = DURATION_MAP.get(encoded);
+    if (existing) {
+        existing.sum += durationMs;
+        existing.count += 1;
+    }
+    else {
+        DURATION_MAP.set(encoded, { sum: durationMs, count: 1 });
+    }
+}
+export function classifyStatusCode(status) {
+    if (status >= 200 && status < 300 && status !== 206)
+        return "success";
+    if (IGNORED_STATUSES.has(status))
+        return "ignored";
+    if (THROTTLE_STATUSES.has(status))
+        return "throttle";
+    if (RETRY_STATUSES.has(status))
+        return "retry";
+    return "failure";
+}
+/**
+ * Compute the stamp-specific short host for the SDKStats `host` dimension.
+ *
+ * Mirrors `getShortHost` in the AzMon exporter's `NetworkStatsbeatMetrics` class
+ * but additionally strips any trailing port (`:4318`) so localhost-style
+ * URLs report a clean `localhost` instead of `localhost:4318`. Examples:
+ *   `https://westus2-1.in.applicationinsights.azure.com` → `westus2`
+ *   `http://localhost:4318/v1/traces`                    → `localhost`
+ *   `https://collector.example.com:8080`                  → `collector`
+ *   `https://my-otlp-collector.example.com`               → `my-otlp-collector`
+ * For non-URL inputs, returns the hostname or the raw input on failure.
+ *
+ * @internal
+ */
+export function shortHost(input) {
+    if (!input)
+        return "unknown";
+    let host = input;
+    try {
+        const hostRegex = /^https?:\/\/(?:www\.)?([^/.]+)/;
+        const res = hostRegex.exec(input);
+        if (res && res.length > 1) {
+            host = res[1];
+        }
+        else {
+            try {
+                host = new URL(input).hostname || input;
+            }
+            catch {
+                host = input;
+            }
+        }
+        host = host.replace(".in.applicationinsights.azure.com", "");
+        // Strip Azure stamp suffix (e.g. westus2-1 → westus2)
+        host = host.replace(/-\d+$/, "");
+        const colon = host.indexOf(":");
+        if (colon > 0)
+            host = host.slice(0, colon);
+    }
+    catch {
+        /* fall through */
+    }
+    return host;
+}
+/**
+ * Atomically return and reset the counts for `metric`.
+ *
+ * Used by the observable-gauge callbacks so each observation reports only
+ * the delta accumulated during the export interval.
+ *
+ * For {@link REQUEST_DURATION_NAME} the reported value is the average of
+ * all durations recorded since the previous drain, per the spec
+ * ("Request_Duration ... avg request duration during the scheduled
+ * interval").
+ */
+export function drain(metric) {
+    const snapshot = new Map();
+    if (metric === REQUEST_DURATION_NAME) {
+        for (const [encoded, acc] of DURATION_MAP) {
+            if (acc.count === 0)
+                continue;
+            snapshot.set(decodeKey(encoded), acc.sum / acc.count);
+        }
+        DURATION_MAP.clear();
+        return snapshot;
+    }
+    const bucket = REQUESTS_MAP[metric];
+    for (const [encoded, value] of bucket) {
+        snapshot.set(decodeKey(encoded), value);
+    }
+    bucket.clear();
+    return snapshot;
+}
+/**
+ * @internal Test-only: clear all network SDKStats counters.
+ */
+export function _resetAllForTest() {
+    for (const name of NETWORK_METRIC_NAMES) {
+        if (name === REQUEST_DURATION_NAME) {
+            DURATION_MAP.clear();
+        }
+        else {
+            REQUESTS_MAP[name].clear();
+        }
+    }
+}
+//# sourceMappingURL=networkStats.js.map

package/dist/esm/sdkstats/networkStats.js.map

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

package/dist/esm/sdkstats/state.d.ts

@@ -3,20 +3,20 @@
  *
  * Feature and instrumentation flags are stored as bitmasks so they can be
  * combined and reported efficiently. The bitmask values are intentionally
- * compatible with the Azure Monitor Exporter statsbeat encoding so that
- * Azure Monitor consumers see no behavioural change when the distro
- * bridges its bits into the exporter's existing pipeline.
+ * compatible with the Azure Monitor Exporter SDKStats encoding so that
+ * Azure Monitor consumers see no behavioural change when our bits are
+ * bridged into the exporter's existing pipeline.
  *
  * Mirrors `src/microsoft/opentelemetry/_sdkstats/_state.py` from the
- * Python distro (microsoft/opentelemetry-distro-python#89).
+ * Python implementation (microsoft/opentelemetry-distro-python#89).
  */
-import { StatsbeatFeature, StatsbeatInstrumentation } from "../types.js";
+import { SdkStatsFeature, SdkStatsInstrumentation } from "../types.js";
 /**
- * Distro-specific feature flags, in addition to the
- * {@link StatsbeatFeature} flags shared with the Azure Monitor exporter.
+ * Microsoft OpenTelemetry specific feature flags, in addition to the
+ * {@link SdkStatsFeature} flags shared with the Azure Monitor exporter.
  *
  * These bit values intentionally start above the values used by
- * {@link StatsbeatFeature} so that distro bits and exporter bits can be
+ * {@link SdkStatsFeature} so that the bits and exporter bits can be
  * OR-combined into a single 64-bit mask without collision.
  */
 export declare enum SdkStatsDistroFeature {
@@ -45,9 +45,9 @@ export declare const APPLICATIONINSIGHTS_STATSBEAT_DISABLED_ALL = "APPLICATIONIN
  * Return `true` unless SDKStats has been disabled via env var.
  */
 export declare function isSdkStatsEnabled(): boolean;
-export declare function setSdkStatsFeature(flag: StatsbeatFeature | SdkStatsDistroFeature): void;
+export declare function setSdkStatsFeature(flag: SdkStatsFeature | SdkStatsDistroFeature): void;
 export declare function getSdkStatsFeatureFlags(): number;
-export declare function setSdkStatsInstrumentation(flag: StatsbeatInstrumentation): void;
+export declare function setSdkStatsInstrumentation(flag: SdkStatsInstrumentation): void;
 export declare function getSdkStatsInstrumentationFlags(): number;
 export declare function setSdkStatsShutdown(shutdown?: boolean): void;
 export declare function getSdkStatsShutdown(): boolean;

package/dist/esm/sdkstats/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/sdkstats/state.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEzE;;;;;;;GAOG;AACH,oBAAY,qBAAqB;IAC/B,IAAI,IAAI;IACR,WAAW,MAAM;IACjB,WAAW,OAAO;IAClB,cAAc,OAAO;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,qCAAqC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,0CAA0C,+CACT,CAAC;AAI/C;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAS3C;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,qBAAqB,GAAG,IAAI,CAEvF;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAE/E;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,UAAO,GAAG,IAAI,CAEzD;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/sdkstats/state.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;;;;GAOG;AACH,oBAAY,qBAAqB;IAC/B,IAAI,IAAI;IACR,WAAW,MAAM;IACjB,WAAW,OAAO;IAClB,cAAc,OAAO;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,qCAAqC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,0CAA0C,+CACT,CAAC;AAI/C;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAS3C;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,qBAAqB,GAAG,IAAI,CAEtF;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAE9E;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,UAAO,GAAG,IAAI,CAEzD;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}

package/dist/esm/sdkstats/state.js

@@ -1,11 +1,11 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 /**
- * Distro-specific feature flags, in addition to the
- * {@link StatsbeatFeature} flags shared with the Azure Monitor exporter.
+ * Microsoft OpenTelemetry specific feature flags, in addition to the
+ * {@link SdkStatsFeature} flags shared with the Azure Monitor exporter.
  *
  * These bit values intentionally start above the values used by
- * {@link StatsbeatFeature} so that distro bits and exporter bits can be
+ * {@link SdkStatsFeature} so that the bits and exporter bits can be
  * OR-combined into a single 64-bit mask without collision.
  */
 export var SdkStatsDistroFeature;
@@ -48,7 +48,7 @@ export function isSdkStatsEnabled() {
 }
 // ---------------------------------------------------------------------------
 // Mutable global state — kept module-local to ensure a single source of truth
-// across the distro process. Node.js executes JS in a single thread (modulo
+// across the process. Node.js executes JS in a single thread (modulo
 // worker_threads), so no explicit locking is needed.
 // ---------------------------------------------------------------------------
 let _featureBits = 0;

package/dist/esm/sdkstats/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/sdkstats/state.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAiBlC;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,iEAAQ,CAAA;IACR,iFAAiB,CAAA;IACjB,kFAAkB,CAAA;IAClB,wFAAqB,CAAA;AACvB,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,kCAAkC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0CAA0C,GACrD,4CAA4C,CAAC;AAE/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,KAAK,MAAM,MAAM,IAAI,CAAC,qBAAqB,EAAE,0CAA0C,CAAC,EAAE,CAAC;QACzF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,qDAAqD;AACrD,8EAA8E;AAE9E,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,IAAI,oBAAoB,GAAG,CAAC,CAAC;AAC7B,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,kBAAkB,CAAC,IAA8C;IAC/E,YAAY,IAAI,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAA8B;IACvE,oBAAoB,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAQ,GAAG,IAAI;IACjD,SAAS,GAAG,QAAQ,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,YAAY,GAAG,CAAC,CAAC;IACjB,oBAAoB,GAAG,CAAC,CAAC;IACzB,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/sdkstats/state.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAiBlC;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,iEAAQ,CAAA;IACR,iFAAiB,CAAA;IACjB,kFAAkB,CAAA;IAClB,wFAAqB,CAAA;AACvB,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,kCAAkC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0CAA0C,GACrD,4CAA4C,CAAC;AAE/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,KAAK,MAAM,MAAM,IAAI,CAAC,qBAAqB,EAAE,0CAA0C,CAAC,EAAE,CAAC;QACzF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,8EAA8E;AAC9E,qEAAqE;AACrE,qDAAqD;AACrD,8EAA8E;AAE9E,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,IAAI,oBAAoB,GAAG,CAAC,CAAC;AAC7B,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,kBAAkB,CAAC,IAA6C;IAC9E,YAAY,IAAI,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAA6B;IACtE,oBAAoB,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAQ,GAAG,IAAI;IACjD,SAAS,GAAG,QAAQ,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,YAAY,GAAG,CAAC,CAAC;IACjB,oBAAoB,GAAG,CAAC,CAAC;IACzB,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC"}

package/dist/esm/shared/config.d.ts

@@ -37,7 +37,7 @@ export declare class InternalConfig {
     browserSdkLoaderOptions: BrowserSdkLoaderOptions;
     /**
      * Initializes a new instance of InternalConfig.
-     * Accepts MicrosoftOpenTelemetryOptions (distro-level) — global options come
+     * Accepts MicrosoftOpenTelemetryOptions (top-level) — global options come
      * from the top level, Azure Monitor-specific options from the azureMonitor key.
      */
     constructor(options?: MicrosoftOpenTelemetryOptions);

package/dist/esm/shared/config.js

@@ -42,7 +42,7 @@ export class InternalConfig {
     browserSdkLoaderOptions;
     /**
      * Initializes a new instance of InternalConfig.
-     * Accepts MicrosoftOpenTelemetryOptions (distro-level) — global options come
+     * Accepts MicrosoftOpenTelemetryOptions (top-level) — global options come
      * from the top level, Azure Monitor-specific options from the azureMonitor key.
      */
     constructor(options) {