@microsoft/opentelemetry 1.0.2 → 1.2.0

package/dist/commonjs/sdkstats/manager.d.ts

@@ -6,20 +6,24 @@
  */
 export declare class SdkStatsManager {
     private static _instance;
-    private _meterProvider;
+    private _longMeterProvider;
+    private _shortMeterProvider;
     private _metrics;
     private _initialized;
     private _initialExportTimer;
     static getInstance(): SdkStatsManager;
     get isInitialized(): boolean;
     /**
-     * Set up SDKStats export via the Azure Monitor statsbeat endpoint.
+     * Set up SDKStats export via the Azure Monitor SDKStats endpoint.
      *
      * Returns `true` if the standalone pipeline was initialized (or was
      * already initialized), `false` if SDKStats are disabled via env var
      * or initialization failed.
      */
-    initialize(): Promise<boolean>;
+    initialize(options?: {
+        networkOnly?: boolean;
+        cikey?: string;
+    }): Promise<boolean>;
     shutdown(): Promise<boolean>;
     private _cleanup;
     /**

package/dist/commonjs/sdkstats/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/sdkstats/manager.ts"],"names":[],"mappings":"AAyDA;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAA8B;IAEtD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,mBAAmB,CAA6B;IAExD,MAAM,CAAC,WAAW,IAAI,eAAe;IAOrC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA2E9B,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBlC,OAAO,CAAC,QAAQ;IAUhB;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAG7B"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/sdkstats/manager.ts"],"names":[],"mappings":"AAsFA;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAA8B;IAEtD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,mBAAmB,CAA6B;IAExD,MAAM,CAAC,WAAW,IAAI,eAAe;IAOrC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA8GrF,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAsBlC,OAAO,CAAC,QAAQ;IAWhB;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAG7B"}

package/dist/commonjs/sdkstats/manager.js

@@ -5,19 +5,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SdkStatsManager = void 0;
 /**
  * SDKStats manager — sends SDK self-telemetry to the Application Insights
- * statsbeat ingestion endpoint, independent of the customer's telemetry
+ * SDKStats ingestion endpoint, independent of the customer's telemetry
  * pipeline.
  *
  * When the full Azure Monitor pipeline is enabled, the exporter package's
- * own statsbeat machinery handles SDKStats emission and the distro just
- * publishes its bits via the `AZURE_MONITOR_STATSBEAT_FEATURES` env var
+ * own SDKStats machinery handles SDKStats emission and we just
+ * publish our bits via the `AZURE_MONITOR_STATSBEAT_FEATURES` env var
  * for the exporter to read. For A365-only, OTLP-only, or Console-only
  * customers this manager spins up a standalone `MeterProvider` →
  * `AzureMonitorStatsbeatExporter` pipeline so feature/instrumentation
  * SDKStats are still collected.
  *
  * Mirrors `src/microsoft/opentelemetry/_sdkstats/_manager.py` from the
- * Python distro.
+ * Python implementation.
  */
 const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
 const resources_1 = require("@opentelemetry/resources");
@@ -41,6 +41,32 @@ const DEFAULT_LONG_EXPORT_INTERVAL_MS = 24 * 60 * 60 * 1000;
  * @internal
  */
 const SDKSTATS_LONG_EXPORT_INTERVAL_ENV = "APPLICATIONINSIGHTS_STATS_LONG_EXPORT_INTERVAL";
+/**
+ * Default short export interval (15 minutes) for network SDKStats
+ * counters. Matches the Application Insights SDKStats short-interval
+ * cadence used by the Python package (`_get_stats_short_export_interval()`
+ * in `azure.monitor.opentelemetry.exporter.statsbeat._utils`).
+ *
+ * @internal
+ */
+const DEFAULT_SHORT_EXPORT_INTERVAL_MS = 15 * 60 * 1000;
+/**
+ * Override env var: short (network) export interval in seconds.
+ * Matches the Python package env var name.
+ *
+ * @internal
+ */
+const SDKSTATS_SHORT_EXPORT_INTERVAL_ENV = "APPLICATIONINSIGHTS_STATS_SHORT_EXPORT_INTERVAL";
+/**
+ * Override env var: redirect SDKStats envelopes to a custom App
+ * Insights connection string. When unset, SDKStats flow to the
+ * Microsoft-owned SDKStats resource (`NON_EU_CONNECTION_STRING` in
+ * the AzMon exporter package). Primarily useful for testing.
+ * Matches the Python package env var name.
+ *
+ * @internal
+ */
+const SDKSTATS_CONNECTION_STRING_ENV = "APPLICATIONINSIGHTS_STATS_CONNECTION_STRING";
 /**
  * Initial-export delay (15 seconds) before the first long-interval flush.
  *
@@ -59,7 +85,8 @@ const INITIAL_EXPORT_DELAY_MS = 15 * 1000;
  */
 class SdkStatsManager {
     static _instance;
-    _meterProvider;
+    _longMeterProvider;
+    _shortMeterProvider;
     _metrics;
     _initialized = false;
     _initialExportTimer;
@@ -73,13 +100,13 @@ class SdkStatsManager {
         return this._initialized;
     }
     /**
-     * Set up SDKStats export via the Azure Monitor statsbeat endpoint.
+     * Set up SDKStats export via the Azure Monitor SDKStats endpoint.
      *
      * Returns `true` if the standalone pipeline was initialized (or was
      * already initialized), `false` if SDKStats are disabled via env var
      * or initialization failed.
      */
-    async initialize() {
+    async initialize(options = {}) {
         if (!(0, state_js_1.isSdkStatsEnabled)()) {
             return false;
         }
@@ -90,33 +117,62 @@ class SdkStatsManager {
             // The exporter package's `exports` map blocks subpath imports, so
             // we resolve the package's own package.json to find its install
             // location on disk and require the internal modules by absolute
-            // path. The statsbeat exporter is the correct vehicle for SDKStats
-            // — it tags envelopes with the statsbeat ikey/endpoint and avoids
-            // recursive statsbeat-of-statsbeat reporting via its
+            // path. The AzureMonitorStatsbeatExporter is the correct vehicle for
+            // SDKStats — it tags envelopes with the SDKStats ikey/endpoint and
+            // avoids recursive SDKStats-of-SDKStats reporting via its
             // `isStatsbeatExporter` flag.
             const baseUrl = (0, module_js_1.getModuleParentURL)() ?? (0, node_url_1.pathToFileURL)(process.cwd() + "/").href;
             const requireFromHere = (0, node_module_1.createRequire)(baseUrl);
             const exporterPackageJsonPath = requireFromHere.resolve("@azure/monitor-opentelemetry-exporter/package.json");
             const exporterPackageDir = (0, node_path_1.dirname)(exporterPackageJsonPath);
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const statsbeatExporterModule = requireFromHere((0, node_path_1.join)(exporterPackageDir, "dist", "esm", "export", "statsbeat", "statsbeatExporter.js"));
+            const sdkStatsExporterModule = requireFromHere((0, node_path_1.join)(exporterPackageDir, "dist", "esm", "export", "statsbeat", "statsbeatExporter.js"));
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const statsbeatTypesModule = requireFromHere((0, node_path_1.join)(exporterPackageDir, "dist", "esm", "export", "statsbeat", "types.js"));
-            const AzureMonitorStatsbeatExporter = statsbeatExporterModule.AzureMonitorStatsbeatExporter;
-            const NON_EU_CONNECTION_STRING = statsbeatTypesModule.NON_EU_CONNECTION_STRING;
-            const exporter = new AzureMonitorStatsbeatExporter({
-                connectionString: NON_EU_CONNECTION_STRING,
+            const sdkStatsTypesModule = requireFromHere((0, node_path_1.join)(exporterPackageDir, "dist", "esm", "export", "statsbeat", "types.js"));
+            const AzureMonitorStatsbeatExporter = sdkStatsExporterModule.AzureMonitorStatsbeatExporter;
+            const NON_EU_CONNECTION_STRING = sdkStatsTypesModule.NON_EU_CONNECTION_STRING;
+            // Allow overriding the SDKStats ingestion target via env var,
+            // matching the Python package's APPLICATIONINSIGHTS_STATS_CONNECTION_STRING
+            // hook. Primarily useful for testing — production should leave
+            // this unset so SDKStats flows to the Microsoft-owned SDKStats
+            // resource (NON_EU_CONNECTION_STRING).
+            const connectionString = process.env[SDKSTATS_CONNECTION_STRING_ENV] ?? NON_EU_CONNECTION_STRING;
+            const emptyResource = (0, resources_1.resourceFromAttributes)({});
+            // Long-interval pipeline (24h) — Feature / Feature.instrumentations.
+            // Skipped when `networkOnly` is true (AzMon exporter owns those).
+            if (!options.networkOnly) {
+                const longExporter = new AzureMonitorStatsbeatExporter({
+                    connectionString,
+                    disableOfflineStorage: true,
+                });
+                const longReader = new sdk_metrics_1.PeriodicExportingMetricReader({
+                    exporter: longExporter,
+                    exportIntervalMillis: resolveLongExportInterval(),
+                });
+                this._longMeterProvider = new sdk_metrics_1.MeterProvider({
+                    readers: [longReader],
+                    resource: emptyResource,
+                });
+            }
+            // Short-interval pipeline (15 min) — network SDKStats gauges.
+            const shortExporter = new AzureMonitorStatsbeatExporter({
+                connectionString,
                 disableOfflineStorage: true,
             });
-            const reader = new sdk_metrics_1.PeriodicExportingMetricReader({
-                exporter,
-                exportIntervalMillis: resolveExportInterval(),
+            const shortReader = new sdk_metrics_1.PeriodicExportingMetricReader({
+                exporter: shortExporter,
+                exportIntervalMillis: resolveShortExportInterval(),
+            });
+            this._shortMeterProvider = new sdk_metrics_1.MeterProvider({
+                readers: [shortReader],
+                resource: emptyResource,
             });
-            this._meterProvider = new sdk_metrics_1.MeterProvider({
-                readers: [reader],
-                resource: (0, resources_1.resourceFromAttributes)({}),
+            this._metrics = new metrics_js_1.SdkStatsMetrics({
+                longMeterProvider: this._longMeterProvider,
+                shortMeterProvider: this._shortMeterProvider,
+                networkOnly: options.networkOnly,
+                cikey: options.cikey,
             });
-            this._metrics = new metrics_js_1.SdkStatsMetrics(this._meterProvider);
             this._initialized = true;
             (0, state_js_1.setSdkStatsShutdown)(false);
             // Spec: long-interval SDKStats should perform an initial export
@@ -125,7 +181,10 @@ class SdkStatsManager {
             // excess startup traffic. `unref()` so the timer never blocks
             // process shutdown.
             this._initialExportTimer = setTimeout(() => {
-                this._meterProvider?.forceFlush().catch((err) => {
+                Promise.all([
+                    this._longMeterProvider?.forceFlush(),
+                    this._shortMeterProvider?.forceFlush(),
+                ]).catch((err) => {
                     index_js_1.Logger.getInstance().debug("[SDKStats] Initial forceFlush failed.", err);
                 });
             }, INITIAL_EXPORT_DELAY_MS);
@@ -148,7 +207,10 @@ class SdkStatsManager {
             this._initialExportTimer = undefined;
         }
         try {
-            await this._meterProvider?.shutdown();
+            await Promise.all([
+                this._longMeterProvider?.shutdown(),
+                this._shortMeterProvider?.shutdown(),
+            ]);
         }
         catch (error) {
             index_js_1.Logger.getInstance().debug("[SDKStats] Error shutting down standalone pipeline.", error);
@@ -160,7 +222,8 @@ class SdkStatsManager {
         return true;
     }
     _cleanup() {
-        this._meterProvider = undefined;
+        this._longMeterProvider = undefined;
+        this._shortMeterProvider = undefined;
         this._metrics = undefined;
         this._initialized = false;
         if (this._initialExportTimer) {
@@ -177,7 +240,7 @@ class SdkStatsManager {
     }
 }
 exports.SdkStatsManager = SdkStatsManager;
-function resolveExportInterval() {
+function resolveLongExportInterval() {
     const raw = process.env[SDKSTATS_LONG_EXPORT_INTERVAL_ENV];
     if (!raw)
         return DEFAULT_LONG_EXPORT_INTERVAL_MS;
@@ -187,4 +250,14 @@ function resolveExportInterval() {
     }
     return Math.floor(seconds * 1000);
 }
+function resolveShortExportInterval() {
+    const raw = process.env[SDKSTATS_SHORT_EXPORT_INTERVAL_ENV];
+    if (!raw)
+        return DEFAULT_SHORT_EXPORT_INTERVAL_MS;
+    const seconds = Number(raw);
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        return DEFAULT_SHORT_EXPORT_INTERVAL_MS;
+    }
+    return Math.floor(seconds * 1000);
+}
 //# sourceMappingURL=manager.js.map

package/dist/commonjs/sdkstats/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/sdkstats/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/sdkstats/manager.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC;;;;;;;;;;;;;;;GAeG;AAEH,4DAA0F;AAC1F,wDAAkE;AAClE,6CAA4C;AAC5C,uCAAyC;AACzC,yCAA0C;AAE1C,yDAAoD;AACpD,mDAAyD;AACzD,yCAAoE;AACpE,6CAA+C;AAE/C;;;;;GAKG;AACH,MAAM,+BAA+B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE5D;;;;GAIG;AACH,MAAM,iCAAiC,GAAG,gDAAgD,CAAC;AAE3F;;;;;;;GAOG;AACH,MAAM,gCAAgC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExD;;;;;GAKG;AACH,MAAM,kCAAkC,GAAG,iDAAiD,CAAC;AAE7F;;;;;;;;GAQG;AACH,MAAM,8BAA8B,GAAG,6CAA6C,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1C;;;;;GAKG;AACH,MAAa,eAAe;IAClB,MAAM,CAAC,SAAS,CAA8B;IAE9C,kBAAkB,CAA4B;IAC9C,mBAAmB,CAA4B;IAC/C,QAAQ,CAA8B;IACtC,YAAY,GAAG,KAAK,CAAC;IACrB,mBAAmB,CAA6B;IAExD,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;YAC/B,eAAe,CAAC,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;QACpD,CAAC;QACD,OAAO,eAAe,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,UAAqD,EAAE;QACtE,IAAI,CAAC,IAAA,4BAAiB,GAAE,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,kEAAkE;YAClE,gEAAgE;YAChE,gEAAgE;YAChE,qEAAqE;YACrE,mEAAmE;YACnE,0DAA0D;YAC1D,8BAA8B;YAC9B,MAAM,OAAO,GAAG,IAAA,8BAAkB,GAAE,IAAI,IAAA,wBAAa,EAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;YAChF,MAAM,eAAe,GAAG,IAAA,2BAAa,EAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,uBAAuB,GAAG,eAAe,CAAC,OAAO,CACrD,oDAAoD,CACrD,CAAC;YACF,MAAM,kBAAkB,GAAG,IAAA,mBAAO,EAAC,uBAAuB,CAAC,CAAC;YAC5D,8DAA8D;YAC9D,MAAM,sBAAsB,GAAQ,eAAe,CACjD,IAAA,gBAAI,EAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,CAAC,CACvF,CAAC;YACF,8DAA8D;YAC9D,MAAM,mBAAmB,GAAQ,eAAe,CAC9C,IAAA,gBAAI,EAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAC3E,CAAC;YACF,MAAM,6BAA6B,GAAG,sBAAsB,CAAC,6BAA6B,CAAC;YAC3F,MAAM,wBAAwB,GAAG,mBAAmB,CAAC,wBAAwB,CAAC;YAE9E,8DAA8D;YAC9D,4EAA4E;YAC5E,+DAA+D;YAC/D,+DAA+D;YAC/D,uCAAuC;YACvC,MAAM,gBAAgB,GACpB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,IAAI,wBAAwB,CAAC;YAE1E,MAAM,aAAa,GAAG,IAAA,kCAAsB,EAAC,EAAE,CAAC,CAAC;YAEjD,qEAAqE;YACrE,kEAAkE;YAClE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,IAAI,6BAA6B,CAAC;oBACrD,gBAAgB;oBAChB,qBAAqB,EAAE,IAAI;iBAC5B,CAAC,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,2CAA6B,CAAC;oBACnD,QAAQ,EAAE,YAAY;oBACtB,oBAAoB,EAAE,yBAAyB,EAAE;iBAClD,CAAC,CAAC;gBACH,IAAI,CAAC,kBAAkB,GAAG,IAAI,2BAAa,CAAC;oBAC1C,OAAO,EAAE,CAAC,UAAU,CAAC;oBACrB,QAAQ,EAAE,aAAa;iBACxB,CAAC,CAAC;YACL,CAAC;YAED,8DAA8D;YAC9D,MAAM,aAAa,GAAG,IAAI,6BAA6B,CAAC;gBACtD,gBAAgB;gBAChB,qBAAqB,EAAE,IAAI;aAC5B,CAAC,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,2CAA6B,CAAC;gBACpD,QAAQ,EAAE,aAAa;gBACvB,oBAAoB,EAAE,0BAA0B,EAAE;aACnD,CAAC,CAAC;YACH,IAAI,CAAC,mBAAmB,GAAG,IAAI,2BAAa,CAAC;gBAC3C,OAAO,EAAE,CAAC,WAAW,CAAC;gBACtB,QAAQ,EAAE,aAAa;aACxB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAAe,CAAC;gBAClC,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;gBAC1C,kBAAkB,EAAE,IAAI,CAAC,mBAAmB;gBAC5C,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAA,8BAAmB,EAAC,KAAK,CAAC,CAAC;YAE3B,gEAAgE;YAChE,oEAAoE;YACpE,8DAA8D;YAC9D,8DAA8D;YAC9D,oBAAoB;YACpB,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,GAAG,EAAE;gBACzC,OAAO,CAAC,GAAG,CAAC;oBACV,IAAI,CAAC,kBAAkB,EAAE,UAAU,EAAE;oBACrC,IAAI,CAAC,mBAAmB,EAAE,UAAU,EAAE;iBACvC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACf,iBAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;gBAC3E,CAAC,CAAC,CAAC;YACL,CAAC,EAAE,uBAAuB,CAAC,CAAC;YAC5B,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,EAAE,CAAC;YAEnC,iBAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iBAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CACxB,8FAA8F,EAC9F,KAAK,CACN,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACvC,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC;QACvC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,kBAAkB,EAAE,QAAQ,EAAE;gBACnC,IAAI,CAAC,mBAAmB,EAAE,QAAQ,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iBAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAA,8BAAmB,EAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACvC,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa;QAClB,eAAe,CAAC,SAAS,GAAG,SAAS,CAAC;IACxC,CAAC;CACF;AAjLD,0CAiLC;AAED,SAAS,yBAAyB;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,+BAA+B,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,+BAA+B,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,0BAA0B;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAC5D,IAAI,CAAC,GAAG;QAAE,OAAO,gCAAgC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/commonjs/sdkstats/metrics.d.ts

@@ -7,14 +7,58 @@ import type { MeterProvider } from "@opentelemetry/sdk-metrics";
  */
 export declare const FEATURE_TYPE_FEATURE = 0;
 export declare const FEATURE_TYPE_INSTRUMENTATION = 1;
+/**
+ * Options for {@link SdkStatsMetrics}.
+ */
+export interface SdkStatsMetricsOptions {
+    /** Override the distro version reported on every observation. */
+    distroVersion?: string;
+    /**
+     * Customer instrumentation key emitted as the `cikey` customDimension
+     * on every SDKStats observation, per the Application Insights SDKStats
+     * spec. Reported as `"N/A"` when undefined or empty (e.g. for OTLP-only
+     * customers without an Application Insights connection string).
+     */
+    cikey?: string;
+    /**
+     * When `true`, skip the Feature / Feature.instrumentations gauges. Used
+     * on the Azure-Monitor-enabled path because the AzMon exporter's own
+     * long-interval SDKStats already emits those gauges (with our distro
+     * bits bridged in via `AZURE_MONITOR_STATSBEAT_FEATURES`); registering
+     * them here would double-count.
+     *
+     * The network SDKStats gauge (`Request_Success_Count`) is always
+     * registered regardless of this flag — coexistence with AzMon's own
+     * network SDKStats is safe because the (endpoint, host) attributes
+     * partition the time series.
+     */
+    networkOnly?: boolean;
+    /**
+     * MeterProvider for long-interval gauges (Feature /
+     * Feature.instrumentations). May be undefined when `networkOnly` is
+     * true. When provided, gauges are registered on a meter from this
+     * provider so they export at the long (24h) cadence.
+     */
+    longMeterProvider?: MeterProvider;
+    /**
+     * MeterProvider for short-interval gauges (network SDKStats like
+     * `Request_Success_Count`). Gauges are registered on a meter from
+     * this provider so they export at the short (15 min) cadence.
+     */
+    shortMeterProvider: MeterProvider;
+}
 /**
  * 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 declare class SdkStatsMetrics {
     private readonly commonAttributes;
-    constructor(meterProvider: MeterProvider, distroVersion?: string);
+    constructor(options: SdkStatsMetricsOptions);
+    /** @deprecated Use the options-object overload instead. */
+    constructor(meterProvider: MeterProvider, options?: Omit<SdkStatsMetricsOptions, "shortMeterProvider" | "longMeterProvider">);
     private observeFeatures;
     private observeInstrumentations;
+    private makeNetworkCallback;
 }
 //# sourceMappingURL=metrics.d.ts.map

package/dist/commonjs/sdkstats/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/sdkstats/metrics.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAMhE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAM9C;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;gBAE9C,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC,EAAE,MAAM;IAqBhE,OAAO,CAAC,eAAe,CAcrB;IAEF,OAAO,CAAC,uBAAuB,CAU7B;CACH"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/sdkstats/metrics.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAgBhE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,4BAA4B,IAAI,CAAC;AA+D9C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC;;;;OAIG;IACH,kBAAkB,EAAE,aAAa,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;gBAE9C,OAAO,EAAE,sBAAsB;IAC3C,2DAA2D;gBAEzD,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IA4EpF,OAAO,CAAC,eAAe,CAcrB;IAEF,OAAO,CAAC,uBAAuB,CAU7B;IAEF,OAAO,CAAC,mBAAmB;CAe5B"}

package/dist/commonjs/sdkstats/metrics.js

@@ -14,11 +14,12 @@ exports.SdkStatsMetrics = exports.FEATURE_TYPE_INSTRUMENTATION = exports.FEATURE
  * caller-supplied `MeterProvider`.
  *
  * Mirrors `src/microsoft/opentelemetry/_sdkstats/_metrics.py` from the
- * Python distro.
+ * Python implementation.
  */
 const node_os_1 = __importDefault(require("node:os"));
 const types_js_1 = require("../types.js");
 const state_js_1 = require("./state.js");
+const networkStats_js_1 = require("./networkStats.js");
 /**
  * Feature SDKStats `type` dimension values, per the Application Insights
  * SDKStats specification.
@@ -29,29 +30,116 @@ exports.FEATURE_TYPE_FEATURE = 0;
 exports.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: networkStats_js_1.REQUEST_SUCCESS_NAME,
+        unit: "count",
+        description: "Number of successful HTTP exports per endpoint",
+        keyAttributes: ["endpoint", "host"],
+    },
+    {
+        metric: networkStats_js_1.REQUEST_FAILURE_NAME,
+        unit: "count",
+        description: "Number of failed HTTP exports per endpoint, broken down by status code",
+        keyAttributes: ["endpoint", "host", "statusCode"],
+    },
+    {
+        metric: networkStats_js_1.REQUEST_DURATION_NAME,
+        unit: "ms",
+        description: "Average HTTP export request duration per endpoint",
+        keyAttributes: ["endpoint", "host"],
+    },
+    {
+        metric: networkStats_js_1.RETRY_COUNT_NAME,
+        unit: "count",
+        description: "Number of HTTP exports that returned a retryable status code",
+        keyAttributes: ["endpoint", "host", "statusCode"],
+    },
+    {
+        metric: networkStats_js_1.THROTTLE_COUNT_NAME,
+        unit: "count",
+        description: "Number of HTTP exports that returned a throttling status code (402/439)",
+        keyAttributes: ["endpoint", "host", "statusCode"],
+    },
+    {
+        metric: networkStats_js_1.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}.
  */
 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: node_os_1.default.type(),
-            language: STATSBEAT_LANGUAGE,
+            language: SDKSTATS_LANGUAGE,
             version: distroVersion || types_js_1.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 = (0, state_js_1.getSdkStatsFeatureFlags)();
@@ -79,6 +167,21 @@ class SdkStatsMetrics {
             type: exports.FEATURE_TYPE_INSTRUMENTATION,
         });
     };
+    makeNetworkCallback(spec) {
+        return (result) => {
+            for (const [key, value] of (0, networkStats_js_1.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);
+            }
+        };
+    }
 }
 exports.SdkStatsMetrics = SdkStatsMetrics;
 //# sourceMappingURL=metrics.js.map

package/dist/commonjs/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,sDAAyB;AAIzB,0CAA8D;AAC9D,yCAAsF;AAEtF;;;;;GAKG;AACU,QAAA,oBAAoB,GAAG,CAAC,CAAC;AACzB,QAAA,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,MAAa,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,iBAAE,CAAC,IAAI,EAAE;YACb,QAAQ,EAAE,kBAAkB;YAC5B,OAAO,EAAE,aAAa,IAAI,0CAA+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,IAAA,kCAAuB,GAAE,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,4BAAoB;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC;IAEM,uBAAuB,GAAG,CAAC,MAAwB,EAAQ,EAAE;QACnE,MAAM,SAAS,GAAG,IAAA,0CAA+B,GAAE,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,oCAA4B;SACnC,CAAC,CAAC;IACL,CAAC,CAAC;CACH;AAnDD,0CAmDC"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/sdkstats/metrics.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/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/commonjs/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"}